Skip Headers
Oracle® Fusion Middleware User's Guide for Oracle WebCenter Spaces
11g Release 1 (11.1.1.4.0)

Part Number E10149-06
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

B Expression Language Expressions

When configuring page components, you can express values as variables that take advantage of the current application context by grabbing information that happens to be true at the moment. All of this is possible in light of the Expression Builder provided with each Parameter and Display Option property.

This appendix provides information about the editor and useful EL expressions. It includes the following subsections:

See Also:

For additional information about EL APIs, see Oracle Fusion Middleware Java API Reference for Oracle WebCenter.

B.1 Introducing the Expression Builder

All properties on the Parameters and Display Options tabs provide an Expression Builder icon that opens a simple Expression Language (EL) editor, called the Expression Builder. Use the Expression Builder when you want to formulate a dynamic computation for an otherwise unknown property value, for example, to specify the current user, the current page mode, and the like.

Click the Expression Builder icon next to a property to open the editor. (Figure B-1).

Figure B-1 Expression Builder Icon Next to a Parameter Value Field and the Resulting Editor

Edit icon next to a parameter value field
Description of "Figure B-1 Expression Builder Icon Next to a Parameter Value Field and the Resulting Editor"

See Also:

For information about accessing component properties, see Section 17.5.2, "Setting Properties on Page Components."

The Expression Builder is particularly useful when you want a value that is retrievable but otherwise unknown, for example, when you want a value to be the name of the current user or the current application skin.

The Expression Builder provides two options for entering expressions:

The options under Choose a value are categorized according to the type of information an expression returns. Select a category from the first menu, and then select the type of value you want returned from the second menu (Figure B-2).

Figure B-2 Options Under Choose a value in the Expression Builder

Options under Choose a value in the Expression Builder
Description of "Figure B-2 Options Under Choose a value in the Expression Builder"

See Also:

For information about seeded EL expressions, see Section B.3.1, "Seeded Expressions in the Expression Builder."

The option Type a value or expression is followed by a text box, which you can use to manually enter the expression you intend (Figure B-3).

Figure B-3 Text Box Under Type a value or expression in the Expression Builder

Text box under Type a value or expression
Description of "Figure B-3 Text Box Under Type a value or expression in the Expression Builder"

Many expressions in the tables in this appendix are building blocks for narrowing down the object or objects you want returned. That is, they are not necessarily meant to be used by themselves, but rather in an assembly of ELs to form the desired query.

For example, the following expression uses three resource-related ELs to form a single query that returns a particular Space template. It retrieves the template storesMasterTemplate from the parent Space stores:

#{srmContext.resourceScope['stores'].resourceType['siteTemplate'].displayName['storesMasterTemplate'].singleResult}

In the Expression Builder, select predefined values, under Choose a value, or enter a value or an Expression Language expression, under Type a value or expression.

Use the following formats to enter values:

The editor provides a Test button for validating your EL entry. The Test button is available for expressions entered in the text box under Type a value or expression.

Validation checks the EL syntax and evaluates the expression. Because expression values vary according to the context in which they are executed, the resulting value that appears in the editor may differ from the value returned during actual use.

Note, however, that only EL is validated when you click Test; other types of values are not validated.

Test results are shown in a popup (Figure B-4).

Figure B-4 Test Result in EL Editor

Test result in EL Editor
Description of "Figure B-4 Test Result in EL Editor"

B.2 Expression Language Example Use Case

This section provides an example of using EL expressions to display something based on a user's role, permissions, and the like.

In this example, we will use Expression Language to reveal or hide an item in the navigation model based on the user's role. Because there is Expression Language for almost every piece of metadata maintained by WebCenter Spaces, using ELs to personalize the user's experience is an extremely powerful tool.

You can use the following EL to determine a user's role:

#{WCSecurityContext.userInScopedRole['Role 1'] or   WCSecurityContext.userInScopedRole['Role 2']}

This EL compares the current user's credentials (in this case, the role), against what is specified in the EL. If the result is true, that is, if the user is assigned one of the specified roles then the navigation item is visible to the user. If the result is false, the navigation item is hidden from the user.

The roles referred to in the EL can be a system role, such as Administrator, Moderator, Participant, or a custom role.

Notice that this EL joins two conditions with the use of an OR clause; that is, the user must have either Role 1 OR Role 2 to be able to see the navigational item.

These steps demonstrate how to add a navigational item (a page query for another Space) that is visible only to user assigned the role Moderator.

Note:

This exercise assumes you have applied a custom navigation model to your Space. You cannot edit a seeded navigation model.

To personalize navigation:

  1. Go to Space Settings, and access the Navigations panel under Resources.

    You can use the following URL to navigate to the Resources subpage, from there, click Navigations:

    http://host:port/webcenter/spaces/spaceName/admin/resources
    
  2. Select the navigation model that the Space is using.

    Tip:

    To find out which navigation model the current Space is using, go to the General subpage under Space Settings, and look for the value in the Navigation field.
  3. From the Edit menu, select Edit.

  4. In the Edit - navigation model dialog, expand the Add menu, and select Pages Query.

  5. Bring the Target tab forward:

    • In the Name field, enter a name for your query, for example, moderatorQuery.

    • Next to Find Page in, select Space, and ensure that the current Space name appears in the field.

    • Click the icon to the right of the Visible checkbox, and select Expression Builder.

  6. Select Choose a value, and then select Space Info from the first dropdown and CurrentSpace Role - Moderator from the second.

    The expression #{WCSecurityContext.userInScopedRole['Moderator']} appears in the text field.

    Tip:

    If you are working with a custom role, you choose CurrentSpace Role - Custom from the dropdown. In the text area, highlight CustomRole, then type in the name of your custom role.
  7. Click OK until you return to the Resources tab.

To test this, add a member to the Space, and assign this user any role other than Moderator. Log off and log back in as that user. You should not see the Pages Query navigational item.

B.3 Expression Language Expressions

This section provides a series of tables that list and describe useful EL expressions. Tables are grouped according to the context in which the expressions they contain apply.

This section includes the following subsections:

B.3.1 Seeded Expressions in the Expression Builder

In the Expression Builder editor, when you select the option Choose a value you can populate the text box in the dialog with a seeded EL expression. First, select an expression category, and then select the type of information you want the expression to return. Your selection's associated EL appears in the text box at the bottom of the dialog (Figure B-5).

Figure B-5 Options Under Choose a value in the Expression Builder

Options under Choose a value in the Expression Builder
Description of "Figure B-5 Options Under Choose a value in the Expression Builder"

This section is broken into subsections for each category. Each subsection lists and describes the ELs associated with that category.

This section includes the following subsections:

B.3.1.1 Application Info Seeded ELs

Application Info seeded EL expressions return values related to the WebCenter Spaces application. For example, the expression #{WCAppContext.application.applicationConfig.title}, returns the application title that is specified on the Configuration page in the WebCenter Administration pages.

See Also:

For additional EL expressions related to the application, see Section B.3.2, "EL Expressions Relevant to the WebCenter Spaces Application."

Table B-1 lists the seeded EL expressions available under the category Application Info and provides an example of the types of values each returns.

Table B-1 Seeded EL Expressions Under Application Info

Option Expression Example of Returned Value

Current Scope

#{serviceCtx.scope}

Scope[name=standards, guid=sa78185d3_9d65_49ab_ac1d_4809380d0b30]

Current Page Template Scope

#{WCAppContext.currentScope}

Scope[name=standards, guid=sa78185d3_9d65_49ab_ac1d_4809380d0b30]

Previously Set Page Template

#{WCAppContext.previouslySetPageTemplate}

Fusion Side Navigation

Application

#{WCAppContext.application}

oracle.webcenter.webcenterapp.internal.view.shell.WCApplication

Application URL

#{WCAppContext.applicationURL}

http://host:port/webcenter

Current WebCenter URL

#{WCAppContext.currentWebCenterURI}

/oracle/webcenter/page/scopedMD/GUID/businessRolePages/Page3.jspx?wc.contextURL=%2Fspaces

Application Config

#{WCAppContext.application.applicationConfig}

oracle.webcenter.webcenterapp.beans.WebCenterMetadataImpl@123db9d

Application Config Title

#{WCAppContext.application.applicationConfig.title}

WebCenter

Application Config Logo

#{WCAppContext.application.applicationConfig.logo}

/oracle/webcenter/webcenterapp/metadata/images/logo.gif

Application Config HelpPage

#{WCAppContext.application.applicationConfig.helpPage}

/webcenterhelp/spaces?topic=welcome_main

Application Config CopyrightMessage CustomValue

#{WCAppContext.application.applicationConfig.copyrightMessage.customValue}

http://www.oracle.com/html/copyright.html

Application Config Privacy Policy URL

#{WCAppContext.application.applicationConfig.privacyPolicyUrl}

http://www.oracle.com/html/privacy.html

Application Config Skin

#{WCAppContext.application.applicationConfig.skin}

webcenterfx


B.3.1.2 Page Info Seeded ELs

Page Info seeded EL expressions return values related to WebCenter Spaces pages. For example, the expression #{pageDocBean.createdBy}, returns the user name of the person who created the current page.

Table B-2 lists the seeded EL expressions available under the category Page Info and provides an example of the types of values each returns.

Table B-2 Seeded EL Expressions Under Page Info

Option Expression Example of Returned Value

Title

#{pageDocBean.title}

Welcome Page (BRP)

Created By

#{pageDocBean.createdBy}

j.doe

Create Date String

#{pageDocBean.createDateString}

2010-11-17T13:27:52

Last Updated By

#{pageDocBean.lastUpdatedBy}

j.smith

Last Update Date String

#{pageDocBean.lastUpdateDateString}

2010-11-17T13:27:52

Page Path

#{pageDocBean.pagePath}

/oracle/webcenter/page/scopedMD/GUID/businessRolePages/Page3.jspx

Name

#{pageDocBean.name}

Page3.jspx

UI CSS Style

#{pageDocBean.UICSSStyle}

WCSchemeCustom

UI Scheme BG Image

#{pageDocBean.UISchemeBGImage}

#{facesContext.externalContext.requestContextPath}/adf/oracle/webcenter/page/images/clouds.png

UI BG String Color Scheme

#{pageDocBean.UISchemeBGColorString}

null

Page Permission

#{pageDocBean.pagePermission}

oracle.webcenter.page.model.security.CustomPagePermission

Page Security Target

#{pageDocBean.pageSecurityTarget}

oracle_webcenter_page_scopedMD_sa78185d3_9d65_49ab_ac1d_4809380d0b30_COIHomePageDef


B.3.1.3 Page Parameter Seeded ELs

Page Parameter seeded EL expressions return values related to WebCenter Spaces page parameters. The editor lists all parameters that are defined for the current page. If no parameters are defined, the Page Parameter category is not available.

For example, the seeded page style Three Column provides five seeded page parameters (see Table B-3). The width parameters describe the percentage of total width allotted to each column. The show parameters specify whether a page header and footer are rendered. Of the seeded page styles, Blank, Home Page, Left Narrow, and Right Narrow all provide the same seeded page parameters (see Table B-3). Additionally, any page may have its own custom page parameters.

Whether seeded or custom, available page parameters are exposed in the Expression Builder editor under the Page Parameter category.

See Also:

For more information about creating and using page parameters, see Section 19.3, "Wiring Components and Page Parameters."

Table B-3 lists the EL expressions available under the Page Parameter category for pages based on the styles Three Column, Blank, Home Page, Left Narrow, and Right Narrow. It provides an example of the types of values each returns.

Table B-3 Seeded EL Expressions Under Page Parameter

Option Expression Example of Returned Value

leftWidth

#{bindings.leftWidth}

25%

centerWidth

#{bindings.centerWidth}

50%

rightWidth

#{bindings.rightWidth}

25%

showHeader

#{bindings.showHeader}

false

showFooter

#{bindings.showFooter}

false


B.3.1.4 Resource Info Seeded ELs

Resource Info seeded EL expressions return values related to WebCenter Spaces resources, such as templates, styles, resource catalogs, and the like. For example, the expression #{srmContext.id['ResourceID'].singleResult}, returns the resource with the specified GUID.

See Also:

For additional resource-related EL expressions, see Section B.3.5, "EL Expressions Relevant to Resources."

Table B-4 lists the seeded EL expressions available under the category Resource Info and provides an example of the types of values each returns.

Table B-4 Seeded EL Expressions Under Resource Info

Option Expression Example of Returned Value

Resource ID

#{srmContext.id['ResourceID'].singleResult}

id:gsr3396194a_3a72_44d6_90b4_57fd6efe4ff7 resourceScope:Scope[name=defaultScope, guid=s8bba98ff_4cbb_40b8_beee_296c916a23ed] resourceType:siteTemplate serviceId:oracle.webcenter.siteresources.sitetemplate category: displayName:Fusion Side Navigation displayNameKey:SITE_TEMPLATE_FUS_SIDE_STRETCH_NAV_DN description:Stretching Page Layout with Side Navigation. Use Fusion FX Skin. descriptionKey:SITE_TEMPLATE_FUS_SIDE_STRETCH_NAV_DESC contentDirectory:/oracle/webcenter/siteresources/shared metadataFile: jspx:/oracle/webcenter/webcenterapp/view/templates/WCSiteTemplateSideNavStretch.jspx pageDef:/oracle/webcenter/webcenterapp/bindings/pageDefs/oracle_webcenter_webcenterapp_view_templates_WCSiteTemplateSideNavStretchPageDef.xml iconURI: excludeFrom: usesCustomSecurity:false visible:TRUE seeded:true createdBy:system createdDate:Fri Jul 02 05:44:19 PDT 2010 modifiedBy:system resourceBundle:oracle.webcenter.sitetemplate.view.resource.SiteTemplateBundle modifiedDate:Fri Jul 02 05:44:19 PDT 2010 logoUrl:/adf/webcenter/srm_dflt_logo_qualifier.png attributes:[]

Resource Display Name

#{srmContext.displayName['DisplayName'].singleResult}

See Resource ID for an example of a returned value.

Description

#{srmContext.description['Description'].singleResult}

See Resource ID for an example of a returned value.

Creation Date

#{srmContext.createdDate['creationDate'].singleResult}

See Resource ID for an example of a returned value.

Modified By

#{srmContext.modifiedBy['UserName'].singleResult}

See Resource ID for an example of a returned value.

Modified Date

#{srmContext.modifiedDate['ModifiedDate'].singleResult}

See Resource ID for an example of a returned value.

Resource Scope

#{srmContext.resourceScope['ResourceScope'].singleResult}

See Resource ID for an example of a returned value.


B.3.1.5 Space Info Seeded ELs

Space Info seeded EL expressions return values related to Spaces (other than the Home Space). For example, the expression #{spaceContext.space['spaceName'].children}, returns a list of the Subspaces under the named parent Space.

See Also:

For additional Space-related EL expressions, see Section B.3.6, "EL Expressions Relevant to Specific Spaces."

Table B-5 lists the seeded EL expressions available under the category Space Info and provides an example of the types of values each returns.

Note:

Use the EL expressions listed in Table B-5 only in the context of Spaces other than the Home Space.

Table B-5 Seeded EL Expressions Under Space Info

Option Expression Example of Returned Value

NamedSpace

#{spaceContext.space['spaceName']}

oracle.webcenter.spaces.internal.model.SpaceImpl@15fc839

CurrentSpace

#{spaceContext.currentSpace}

oracle.webcenter.spaces.internal.model.SpaceImpl@d5e197

CurrentSpace Name

#{spaceContext.currentSpaceName}

standards

NamedSpace Metadata Path

#{spaceContext.space['spaceName'].metadataPath}

/oracle/webcenter/space/metadata/spaces/spaceName/space.xml

CurrentSpace Metadata Path

#{spaceContext.currentSpace.metadataPath}

/oracle/webcenter/space/metadata/spaces/standards/space.xml

NamedSpace Metadata

#{spaceContext.space['spaceName'].metadata}

oracle.webcenter.spaces.beans.SpaceMetadataImpl@1d7320a

CurrentSpace Metadata

#{spaceContext.currentSpace.metadata}

oracle.webcenter.spaces.beans.SpaceMetadataImpl@1096c64

NamedSpace Metadata DisplayName

#{spaceContext.space['spaceName'].metadata.displayName}

Standards

CurrentSpace Metadata DisplayName

#{spaceContext.currentSpace.GSMetadata.displayName}

Sales

NamedSpace Metadata Icon

#{spaceContext.space['spaceName'].metadata.icon}

/oracle/webcenter/space/metadata/spaces/standards/images/wc_coi_icon.png

CurrentSpace Metadata Icon

#{spaceContext.currentSpace.metadata.icon}

/oracle/webcenter/space/metadata/spaces/Test_Space/images/wc_prj_icon.png

NamedSpace Metadata Description

#{spaceContext.space['spaceName'].metadata.description}

Central point for all standards, templates, and stylesheets for company collateral

CurrentSpace Metadata Description

#{spaceContext.currentSpace.GSMetadata.description}

Sales Force Team Site

NamedSpace Metadata CreationDate

#{spaceContext.space['spaceName'].metadata.creationDate}

java.util.GregorianCalendar[time=1290103432242,areFieldsSet=true,areAllFieldsSet=false,lenient=false,zone=java.util.SimpleTimeZone[id=,offset=-28800000,dstSavings=3600000,useDaylight=false,startYear=0,startMode=0,startMonth=0,startDay=0,startDayOfWeek=0,startTime=0,startTimeMode=0,endMode=0,endMonth=0,endDay=0,endDayOfWeek=0,endTime=0,endTimeMode=0],firstDayOfWeek=1,minimalDaysInFirstWeek=1,ERA=1,YEAR=2010,MONTH=10,WEEK_OF_YEAR=?,WEEK_OF_MONTH=?,DAY_OF_MONTH=18,DAY_OF_YEAR=?,DAY_OF_WEEK=?,DAY_OF_WEEK_IN_MONTH=?,AM_PM=0,HOUR=10,HOUR_OF_DAY=10,MINUTE=3,SECOND=52,MILLISECOND=242,ZONE_OFFSET=?,DST_OFFSET=?]

CurrentSpace Metadata CreationDate

#{spaceContext.currentSpace.metadata.creationDate}

java.util.GregorianCalendar[time=1290103432242,areFieldsSet=true,areAllFieldsSet=false,lenient=false,zone=java.util.SimpleTimeZone[id=,offset=-28800000,dstSavings=3600000,useDaylight=false,startYear=0,startMode=0,startMonth=0,startDay=0,startDayOfWeek=0,startTime=0,startTimeMode=0,endMode=0,endMonth=0,endDay=0,endDayOfWeek=0,endTime=0,endTimeMode=0],firstDayOfWeek=1,minimalDaysInFirstWeek=1,ERA=1,YEAR=2010,MONTH=10,WEEK_OF_YEAR=?,WEEK_OF_MONTH=?,DAY_OF_MONTH=18,DAY_OF_YEAR=?,DAY_OF_WEEK=?,DAY_OF_WEEK_IN_MONTH=?,AM_PM=0,HOUR=10,HOUR_OF_DAY=10,MINUTE=3,SECOND=52,MILLISECOND=242,ZONE_OFFSET=?,DST_OFFSET=?]

NamedSpace Metadata CreatedBy

#{spaceContext.space['spaceName'].metadata.createdBy}

j.doe

NamedSpace Metadata Keywords

#{spaceContext.space['spaceName'].metadata.keywords}

standards templates style sheets collateral

CurrentSpace Metadata Keywords

#{spaceContext.currentSpace.metadata.keywords}

sales salesReports salesNews salesTeam

NamedSpace Metadata Offline

#{spaceContext.space['spaceName'].metadata.offline}

false or true, depending on whether the named Space is offline

CurrentSpace Metadata Offline

#{spaceContext.currentSpace.metadata.offline}

false or true, depending on whether the current Space is offline

NamedSpace Metadata Closed

#{spaceContext.space['spaceName'].metadata.offline}

false or true, depending on whether the named Space is closed

CurrentSpace Metadata Closed

#{spaceContext.currentSpace.metadata.closed}

false or true, depending on whether the current Space is closed

NamedSpace Metadata SelfRegistration

#{spaceContext.space['spaceName'].metadata.selfRegistration}

false or true, depending on whether self registration is enabled for the named Space

CurrentSpace Metadata SelfRegistration

#{spaceContext.currentSpace.metadata.selfRegistration}

false or true, depending on whether self registration is enabled for the current Space

NamedSpace Metadata Discoverable

#{spaceContext.space['spaceName'].metadata.discoverable}

false or true, depending on whether the named Space is discoverable

CurrentSpace Metadata Discoverable

#{spaceContext.currentSpace.metadata.discoverable}

false or true, depending on whether the current Space is discoverable

NamedSpace Metadata PublishRSS

#{spaceContext.space['spaceName'].metadata.publishRSS}

false or true, depending on whether the named Space can be published in an RSS reader

CurrentSpace Metadata PublishRSS

#{spaceContext.currentSpace.metadata.publishRSS}

false or true, depending on whether the current Space can be published in an RSS reader

NamedSpace Distribution List

#{spaceContext.space['spaceName'].distributionList}

standardsGroup@myCompany.com

CurrentSpace Distribution List

#{spaceContext.currentSpace.distributionList}

salesTeam@myCompany.com

NamedSpace Metadata CustomAttributes

#{spaceContext.space['spaceName'].metadata.customAttributes['attributeName']}

Returns the value provided for the named custom attribute

CurrentSpace Metadata CustomAttributes

#{spaceContext.currentSpace.metadata.customAttributes['attributeName']}

Returns the value provided for the named custom attribute

CurrentSpace Metadata Logo

#{WCAppContext.spacesResourcesPath}#{spaceContext.currentSpace.metadata.logo}

/webcenter-spaces-resources/oracle/webcenter/space/metadata/spaces/standards/images/wc_coi_logo.png

CurrentSpace Role - Moderator

#{WCSecurityContext.userInScopedRole['Moderator']}

false or true, depending whether any users in the current scope are assigned the role Moderator

CurrentSpace Role - Participant

#{WCSecurityContext.userInScopedRole['Participant']}

false or true, depending whether any users in the current scope are assigned the role Participant

CurrentSpace Role - Viewer

#{WCSecurityContext.userInScopedRole['Viewer']}

false or true, depending whether any users in the current scope are assigned the role Viewer

CurrentSpace Role - Custom

#{WCSecurityContext.userInScopedRole['CustomRole']}

false or true, depending on if any users in the current scope are assigned the named custom role

NamedSpace Children

#{spaceContext.space['spaceName'].children}

[oracle.webcenter.spaces.internal.model.SpaceImpl@5705f4, oracle.webcenter.spaces.internal.model.SpaceImpl@147d658]

Note: The braces ([]) denote a set.

CurrentSpace Children

#{spaceContext.currentSpace.children}

[oracle.webcenter.spaces.internal.model.SpaceImpl@5705f4, oracle.webcenter.spaces.internal.model.SpaceImpl@147d658]

Note: The braces ([]) denote a set.

NamedSpace Parent

#{spaceContext.space['spaceName'].parent}

oracle.webcenter.spaces.internal.model.SpaceImpl@15fc839

CurrentSpace Parent

#{spaceContext.currentSpace.parent}

oracle.webcenter.spaces.internal.model.SpaceImpl@15fc839

NamedSpace Security Parent

#{spaceContext.space['spaceName'].securityParent}

oracle.webcenter.spaces.internal.model.SpaceImpl@1392793

CurrentSpace Security Parent

#{spaceContext.currentSpace.securityParent}

oracle.webcenter.spaces.internal.model.SpaceImpl@1392793

All visible root level spaces

#{spaceContext.spacesQuery.unionOf['ALL_QUERIABLE,DISCOVERABLE,PUBLIC_ACCESSIBLE,ALLUSER_ACCESSIBLE,USER_JOINED,USER_MODERATED'].shape['ROOT_LEVEL']}

oracle.webcenter.spaces.query.SpacesQueryParameters@ae34c8

All children and descendent spaces for specified Parent Space GUID

#{spaceContext.spacesQuery.parentSpaceGuid['spaceGuid'].shape['RECURSIVE_FLATTENED']}

oracle.webcenter.spaces.query.SpacesQueryParameters@4da22f

Immediate Sub Spaces for specified Parent Space name

#{spaceContext.spacesQuery.parentSpaceName['spaceGuid'].shape['ROOT_LEVEL']}

oracle.webcenter.spaces.query.SpacesQueryParameters@1089971

List of Spaces matching given Space Names

#{spaceContext.spacesQuery.containingNames['space1, space2,space3']}

oracle.webcenter.spaces.query.SpacesQueryParameters@68e467

List of Spaces matching given Space GUID

#{spaceContext.spacesQuery.containingGuids['spaceGuid1, spaceGuid2']}

oracle.webcenter.spaces.query.SpacesQueryParameters@1c56009

List of Spaces sorted based on criteria

#{spaceContext.spacesQuery.unionOf.ALL_QUERIABLE.sortCriteria['sp.lastUpdateDate desc']}

oracle.webcenter.spaces.query.SpacesQueryParameters@6c3def

List of Spaces based on search pattern

#{spaceContext.spacesQuery.unionOf.ALL_QUERIABLE.search['searchKeyword']}

oracle.webcenter.spaces.query.SpacesQueryParameters@19b2cf3

List of Spaces with limited page size

#{spaceContext.spacesQuery.unionOf.USER_JOINED.itemsPerPage[2].pageNumber[1]}

oracle.webcenter.spaces.query.SpacesQueryParameters@4f8818

List of Spaces matching the where clause

#{spaceContext.spacesQuery.unionOf.USER_JOINED.whereClause['sp.createdBy = \'userName\'']}

oracle.webcenter.spaces.query.SpacesQueryParameters@1ba816d


B.3.1.6 Space Page Info Seeded Paths

Rather than EL expressions, the selections under Space Page Info are directory paths to different application pages. Use them, for example, to provide navigation information to a specified page.

Table B-6 lists the seeded directory paths available under the category Space Page Info and provides an example of the types of values each returns.

Table B-6 Seeded Paths Under Space Page Info

Option Path Destination

COIHome.jspx

/faces/oracle/webcenter/page/scopedMD/se2dff4fb_202a_4f4c_b56d_c7cf59ad1c04/COIHome.jspx

Path to the Home page of the current Space

GroupSpaceDocLibMainView.jspx

/faces/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/businessRolePages/GroupSpaceDocLibMainView.jspx

Path to the Documents page in the current Space

ForumMainView.jspx

/faces/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/businessRolePages/ForumMainView.jspx

Path to Discussions page in the current Space

AnnouncementsMainView.jspx

/faces/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/businessRolePages/AnnouncementsMainView.jspx

Path to Announcements page in current Space

EventsMainView.jspx

/faces/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/businessRolePages/EventsMainView.jspx

Path to Events page in current Space

ListsMainView.jspx

/faces/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/businessRolePages/ListsMainView.jspx

Path to Lists page in current Space

GroupSpaceActivityMainView.jspx

/faces/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/businessRolePages/GroupSpaceActivityStreamMainView.jspx

Path to Activity Stream page in current Space


B.3.1.7 System Seeded ELs

System seeded EL expressions return values related to system settings, such as the user name of the current user or the current user's specified locale. For example, the expression #{securityContext.userName}, returns the name of the currently logged in user. For example, if user j.doe is viewing a page where this expression is used, the returned value in j.doe's view is j.doe. If user j.smith is looking at the same page, the value returned in j.smith's view is j.smith.

See Also:

For additional utilitarian EL expressions, see Section B.3.15, "Utilitarian EL Expressions."

Table B-7 lists the seeded EL expressions available under the category System and provides an example of the types of values each returns.

Table B-7 Seeded EL Expressions Under System

Option Expression Example of Returned Value

User

#{securityContext.userName}

The current user's user name

Locale

#{facesContext.externalContext.requestLocale}

The current user's specified locale

This may be taken from application or Space-level settings or user Preferences, whichever is taking precedence.

For example:

en_US

B.3.1.8 User Info Seeded ELs

User Info seeded EL expressions return values related to a given user's Profile. For example, the expression #{webCenterProfile[securityContext.userName].description}, returns the content of the About Me attribute of the current user's Profile.

See Also:

For additional user-related expressions, see Section B.3.13, "EL Expressions Relevant to the People Connections Service."

Table B-8 lists the seeded EL expressions available under the category User Info and provides an example of the types of values each returns.

Table B-8 Seeded EL Expressions Under User Info

Option Expression Example of Returned Value

About Me

#{webCenterProfile[securityContext.userName].description}

Returns the content of the About Me attribute of the current user's Profile

Username

#{webCenterProfile[securityContext.userName].userName}

The user name specified in the current user's Profile

Compare this with the current user's display name.

First Name

#{webCenterProfile[securityContext.userName].firstName}

The current user's first name

Middle Name

#{webCenterProfile[securityContext.userName].middleName}

The current user's middle name

Last Name

#{webCenterProfile[securityContext.userName].lastName}

The current user's last name

Initials used

#{webCenterProfile[securityContext.userName].initials}

The current user's initials

Display Name

#{webCenterProfile[securityContext.userName].displayName}

The current user's display name

Compare this with the current user's user name.

Email

#{webCenterProfile[securityContext.userName].businessEmail}

The current user's business email address

Department

#{webCenterProfile[securityContext.userName].department}

The current user's department

Job Title/Designation

#{webCenterProfile[securityContext.userName].title}

The current user's job title or designation

Manager

#{webCenterProfile[securityContext.userName].managerDisplayName}

The current user's manager's display name

Time zone

#{webCenterProfile[securityContext.userName].timeZone}

The time zone associated with the current user

Employee type

#{webCenterProfile[securityContext.userName].employeeType}

The current user's employee type

Employee Number

#{webCenterProfile[securityContext.userName].employeeNumber}

The current user's employee number

Preferred Language Code

#{webCenterProfile[securityContext.userName].preferredLanguage}

The current user's preferred language

Organization

#{webCenterProfile[securityContext.userName].organization}

The company organization to which the current user belongs

Organizational Unit

#{webCenterProfile[securityContext.userName].organizationalUnit}

The unit of the company organization to which the current user belongs

Expertise

#{webCenterProfile[securityContext.userName].expertise}

The current user's expertise, for example, Application, system, and database administration

Business Fax

#{webCenterProfile[securityContext.userName].businessFax}

The current user's business fax number

Business Mobile

#{webCenterProfile[securityContext.userName].businessMobile}

The current user's business mobile or cell phone number

Business Phone

#{webCenterProfile[securityContext.userName].businessPhone}

The current user's business phone number

Business Pager

#{webCenterProfile[securityContext.userName].businessPager}

The curren user's business pager number

Business Street

#{webCenterProfile[securityContext.userName].businessStreet}

The street address of the current user's business office

Business City

#{webCenterProfile[securityContext.userName].businessCity}

The city where the current user's business office is located

Business State

#{webCenterProfile[securityContext.userName].businessState}

The state where the current user's business office is located

Business PO Box

#{webCenterProfile[securityContext.userName].businessPOBox}

The current user's business Post Office Box number

Business Postal Code

#{webCenterProfile[securityContext.userName].businessPostalCode}

The postal or Zip Code of the current user's business office

Business Country

#{webCenterProfile[securityContext.userName].businessCountry}

The country where the current user's business office is located

Home Address

#{webCenterProfile[securityContext.userName].homeAddress}

The current user's home address

Home phone

#{webCenterProfile[securityContext.userName].homePhone}

The current user's home phone number

Date of Birth

#{webCenterProfile[securityContext.userName].dateofBirth}

The current user's date of birth

Maiden Name

#{webCenterProfile[securityContext.userName].maidenName}

The current user's maiden name

Date of hire

#{webCenterProfile[securityContext.userName].dateofHire}

The date the current user was hired by the company

Name Suffix

#{webCenterProfile[securityContext.userName].nameSuffix}

Titles or credentials appended to the current user's name, for example, MD, Esq, and the like

Wireless Account Number

#{webCenterProfile[securityContext.userName].wirelessAcctNumber}

The account number for the current user's wireless internet account


B.3.1.9 WebCenter Events Seeded ELs

WebCenter Events seeded EL expressions return values related to document-related events, such a selected document, the document's creator, the date the document was last modified, and so on. For example, the expression #{wcEventContext.events.WebCenterResourceSelected.name}, returns the name of the currently selected document.

Table B-9 lists the seeded EL expressions available under the category WebCenter Events and provides an example of the types of values each returns.

Table B-9 Seeded EL Expressions Under WebCenter Events

Option Expression Example of Returned Value

Selected User Name

#{wcEventContext.events.WebCenterUserSelected.UserName}

The user name of the currently selected user

Selected Document Name

#{wcEventContext.events.WebCenterResourceSelected.name}

The name of the currently selected document

Selected Document Creator

#{wcEventContext.events.WebCenterResourceSelected.createdBy}

The name of the user who created the currently selected document

Selected Document Last Modified

#{wcEventContext.events.WebCenterResourceSelected.lastModifiedBy}

The date the selected document was last modified


B.3.2 EL Expressions Relevant to the WebCenter Spaces Application

Table B-10 lists EL expressions relevant to WebCenter Spaces application information and describes the types of functionality it provides. The Context column indicates whether the expression can be used in a WebCenter Spaces context (WCS) or in both WebCenter Spaces and custom portal applications built with Oracle JDeveloper (Both).

Table B-10 EL Expressions Relevant to WebCenter Spaces Application Information

Expression Function Context

#{WCAppContext}

An oracle.webcenter.webcenterapp.context.WCApplicationContext object that provides an access point in the current web request for all WebCenter application-related information.

WCS

#{WCAppContext.currentWebCenterURI}

Returns a URL representing the current web request with bookmarkable WebCenter Spaces URL parameters of the request appended to the end (parameters are not necessarily in a fixed order).

Example:

http://name.us.oracle.com/webcenter/faces/oracle/webcenter/page/scopedMD/someguid/SomePage.jspx?
wc.contextURL=/spaces/somename&wc.pageScope=1234

WCS

#{WCAppContext.application.applicationConfig}

An oracle.webcenter.webcenterapp.beans.WebCenterType bean with a payload of metadata from the current WebCenter Spaces application.

WCS

#{WCAppContext.application.applicationConfig.title}

Returns the display name of the current WebCenter Spaces application (as configured through WebCenter Administration settings).

Out of the box, this returns WebCenter.

WCS

#{WCAppContext.application.applicationConfig.logo}

If an application logo was uploaded through WebCenter Administration settings, this expression returns the URL to the application logo image.

Out of the box, this returns null.

WCS

#{WCAppContext.application.applicationConfig.helpPage}

Returns the URL to the Help application used for the current WebCenter Spaces application (as configured through WebCenter Administration settings).

Out of the box, this returns /webcenterhelp/spaces.

WCS

#{WCAppContext.application.applicationConfig.copyrightMessage.customValue}

If a copyright message was configured through WebCenter Administration settings, this expression returns the application copyright message.

Out of the box, this returns null.

WCS

#{WCAppContext.application.applicationConfig.privacyPolicyUrl}

Returns the URL to the document that contains the application's privacy policy (as configured through WebCenter Administration settings).

Out of the box, this returns http://www.oracle.com/html/privacy.html

WCS

#{WCAppContext.application.applicationConfig.skin}

Returns the name of the default ADF Faces skin family to use for rendering pages in the application (as configured through WebCenter Administration settings).

This expression represents only the application-level setting that may not necessarily be used in all web requests. For example, you cannot use it successfully if a user has chosen to override the skin through application Preferences (for more information, see Chapter 35, "Setting Your Personal Preferences").

WCS

#{requestContext.skinFamily}

Returns the name of the ADF Faces skin family being used for the current web request, depending on factors such as what has been configured at the application level, the current user's preference setting, and so on.

Returns the same value as #{adfFacesContext.skinFamily}.

Both


B.3.3 EL Expressions Relevant to Application Security

Table B-11 lists EL expressions relevant to application security and describes the types of functionality it provides. The Context column indicates whether the expression can be used in a WebCenter Spaces context (WCS) or in both WebCenter Spaces and custom portal applications built with Oracle JDeveloper (Both).

See Also:

For example implementations of expressions related to component-level security, see Section 23.2, "Setting Access on a Page Component."

Table B-11 EL Expressions Relevant to Security

Expression Function Context

#{securityContext.userName}

Returns the user name of the currently logged in user. If the current user is not logged in, this expression returns no value.

Both

#{security.pageContextCommunityModerator}

Returns the value true if the current user is a moderator of the current Space.

WCS

#{WCSecurityContext.userInScopedRole['role']}

Returns the value true if the current user is assigned the specified role in the current scope. Role can be Moderator, Participant, Viewer, or a custom role defined in that scope.

The scope is implicitly resolved to be the current scope. If you use this EL in the Home Space, it resolves to Home Space GUID and roles defined at the application level. If you use this EL in a Space scope, it resolves to roles defined for the Space.

WCS

#{WCSecurityContext.userInGroup['group']}

Returns the value true if the current user is assigned the specified group, for example, Administrators.

Both

#{WCSecurityContext.currentUser['userName']}

Returns the value true if the current user is the specified user.

Both


B.3.4 EL Expressions Relevant to Application Navigation

Table B-12 lists EL expressions relevant to WebCenter Spaces navigation and describes the types of functionality it provides. All navigation ELs can be used in both WebCenter Spaces and custom portal applications built with Oracle JDeveloper.

Table B-12 EL Expressions Relevant to Navigation

Expression Function

Navigation Context Expressions

 

#{navigationContext.defaultNavigationModel}

Returns default navigation model. It gets the value from the preference bean. The preference bean gets the value based on the preference setting in adf-config.xml, static value.

The following example returns the specified default tree model:

#{navigationContext.defaultNavigationModel.defaultTreeModel}

You can also use defaultMenuModel and defaultListModel (see next listing).

#{navigationContext.currentNavigationModel}

Returns the navigation model used to navigate to the current view (that is, the current page)

There may be a number of navigation models on the page. Only the one used to navigate to the page is the current navigation model.

The current navigation model is set only when the processAction is called.

The following example returns the default tree model for the current navigation model:

#{navigationContext.currentNavigationModel.defaultTreeModel}

You can also use defaultMenuModel and defaultListModel.

See Also: #{navigationContext.processAction}.

#{navigationContext.navigationModel['model_path']}

Returns the navigation model specified by path.

Example:

#{navigationContext.navigationModel['/oracle/webcenter/portalapp/navigations/default-navigation-model']}

User can simply enter the path in the square bracket without having to remember the parameter name. For backward compatibility, comma-separated parameters are also supported. Available parameters (with examples) are:

  • modelPath=/oracle/webcenter/portalapp/navigations/default-navigation-model

  • modelScope=/oracle/webcenter/portalapp/navigation

  • modelId=default-navigation-model

Note: modelScope and modelId are used together, for example:

#{navigationContext.navigationModel['modelScope=/oracle/webcenter/portalapp/navigations,modelId=default-navigation-model']}

#{navigationContext.processAction}

Returns the default navigation method for binding to UI component's actionListener attribute. This assumes that the target resource to navigate to is passed in through the action UI component's node or path attribute.

The node attribute is typically used for the iterative case; while the path attribute is typically used to create a static link. If both are specified, the node attribute is used. Note that when using the path attribute, you must also specify the model attribute to pass in the navigation model object. If the model attribute is not specified, the current navigation model is used.

Example using the node attribute:

<af:forEach var="node" varStatus="vs"
 items="#{navigationContext.defaultNavigationModel.rootNode.children}">
  <af:subform id="pt_sfm1">
   <af:commandLink id="pt_cl1"
    text="#{node.title}"
    inlineStyle="font-size:small;color:White;"
    actionListener="#{navigationContext.processAction}"
    action="pprnav">
   <f:attribute name="node" value="#{node}"/>
    <af:showPopupBehavior popupId="menuPopup"
     align="afterStart"
     triggerType="mouseOver"/>
  </af:commandLink>

Example using the path attribute:

<af:commandLink id="pt_cl1" text="Prescriptions"
  inlineStyle="font-size:small; color:White;"
  actionListener="#{navigationContext.processAction}"
  action="pprnav">
<f:attribute name="path" value="/prescriptions"/>
<f:attribute name="model"   value="#{navigationContext.defaultNavigationModel}"/>
</af:commandLink>

Navigation Model Expressions

 

#{navigationContext.defaultNavigationModel.defaultTreeModel}

#{navigationContext.defaultNavigationModel.defaultMenuModel}

#{navigationContext.defaultNavigationModel.defaultListModel}

#{navigationContext.defaultNavigationModel.defaultSiteMap}

Returns a tree/menu/list model based on the default settings

The default values for the settings are specified in the next row. For example, the default value for depth is 0.

For defaultSiteMap, it returns the XML for the sitemap of the navigation based on the default settings.

This expression returns a model of type:

  • ChildPropertyTreeModel—used in <af:tree> component

  • ChildPropertyMenuModel—used in <af:breadcrumbs> or <af:menu> component

  • List<NavigationResource>—used in <af:foreach>

#{navigationContext.defaultNavigationModel.treeModel['parameters']}

#{navigationContext.defaultNavigationModel.menuModel['parameters']}

#{navigationContext.defaultNavigationModel.listModel['parameters']}

#{navigationContext.defaultNavigationModel.siteMap['parameters']}

Returns tree/menu/list model based on the specified comma-separated parameters. Available parameters (with default values as examples) are:

  • startNode=/—specify the starting node of the model (do not need "/" prefix unless requesting the root node, for example, home).

  • includeStartNode=true—specify true if you want to include the starting node (for example, the root node above) or false to start from its children.

  • depth=0—defines the initial depth of fetching. "0" means fetch the entire tree, which may take a long time. In which case, use "1" to fetch on demand (when users click the Expand icon).

  • prefetchOnly=false—by default (true), it returns nodes up to the depth level requested initially; deeper level nodes are returned on demand. Use false if you want only the initial sets of nodes. In which case, it does not return deeper nodes later on when requested, even when there are deeper nodes.

For siteMap, the available parameters are startNode and includeStartNode.

Example:

#{navigationContext.defaultNavigationModel.treeModel['startNode=home,includeStartNode=false,depth=2']}

#{navigationContext.defaultNavigationModel.rootNode}

Returns a root node (of type NavigationResource) of the navigation model.

Example:

<af:commandLink id="pt_cl1" text="Prescriptions"
  inlineStyle="font-size:small; color:White;"
  actionListener="#{navigationContext.processAction}"
  action="pprnav">
 <f:attribute name="node"
    value="#{navigationContext.
    defaultNavigationModel.
    rootNode.children[2]"/>
</af:commandLink>

#{navigationContext.defaultNavigationModel.node['path']}

Returns a node (of type NavigationResource) based on the path specified (you do not need "/" prefix unless you are requesting the root node, for example, '/')

Example:

#{navigationContext.defaultNavigationModel.node['home/page1']}

#{navigationContext.defaultNavigationModel.currentSelection}

Returns currently selected navigation resource.

#{navigationContext.defaultNavigationModel.newCurrentSelection['path']}

Sets the current selection to a node specified by the given path (you do not need "/" prefix unless you are requesting the root node, for example, '/'). If successful, returns the newly selected node of type NavigationResource.

The user must have the ability to explicitly set the current selection without having to actually navigate to a node.

This can be used where the user enters a page directly, and no selection is set. It provides a mechanism for the user to control what is the default when there is no current selection.

Example:

<c:set  value="${navigationContext.defaultNavigationModel.newCurrentSelection['home/page1']}"
 var="currSel" scope="session"/>
<c:if test="${currSel!=null}">
 <af:forEach items="#{currSel.children}"
  var="cnode" varStatus="cnodestatus">
...</c:if>

#{navigationContext.defaultNavigationModel.attributes.Description}

#{navigationContext.defaultNavigationModel.attributes['Description']}

Returns the value of the specified attribute of the navigation model.

Navigation Resource Expressions

 

#{node.attributes.Description}

#{node.attributes['Description']}

Returns the value of the specified attribute of the navigation resource.

#{node.parameters.StockSymbol}

#{node.parameters['StockSymbol']}

Returns the value of the specified parameter of the navigation resource.

#{node.parametersRaw.StockSymbol}

#{node.parametersRaw['StockSymbol']}

Returns the raw value of the specified parameter of the navigation resource (before it is evaluated).

#{node.title}

Returns the title of the navigation resource.

#{node.path}

Returns the path to the navigation resource.

#{node.externalURL}

Returns the URL for the navigation resource of type External Link.

#{node.prettyUrl}

Returns the identifying path for this navigation resource.

#{node.prettyUrlPath}

#{node.prettyUrlPath[N]}

Returns a collection of identifying paths by depth to enable its use as a starting path to drive another navigation view.

For example, assuming the currentSelection is home/company/products/applications, the following EL returns home/company/products:

#{node.prettyUrlPath[3]}

#{node.goLinkPretty Url}

Returns the identifying path for this navigation resource suitable for goLink destination

<af:goLink id="pt_gl2" text="#{node.title}"
   destination="#{node.goLinkPrettyUrl}"
   targetFrame="#{node.attributes['Target']}"
   inlineStyle="font-size:small;#{node.selected ?
   'font-weight:bold;' : ''}"/>

#{node.separator ? ... : ...}

Returns whether this resource is a separator item.

#{node.navigable ? ... : ...}

Returns whether it is possible to navigate to this resource.

#{node.selected ? ... : ...}

Returns whether this resource is currently selected.

#{node.currentlySelected ? ... : ...}

Returns whether the resource is the currently selected resource and the model is the currently selected model.

#{node.onSelectedPath ? ... : ...}

Returns whether this node lies on the selected path. This is useful for highlighting the selected tab, for example.

For example, assuming the currently selected node is home/company/products/applications, the following EL highlights the home tab.

<c:set  value="${navigationContext.defaultNavigationModel.node['home']}"
 var="home" scope="session"/>
  <af:commandImageLink id="cil1"
    icon="#{(home.onSelectedPath) ?
    '/images/caremark/nav/HomeSelected.png' :
    '/images/caremark/nav/HomeIcon.png'}"
    actionListener="#{navigationContext.processAction}"
    action="pprnav">
  <f:attribute name="node" value="#{home}"/></af:commandImageLink>

#{node.leaf ? ... : ...}

Returns whether this resource is a leaf node.

#{node.parent}

Returns the parent node (of type NavigationResource) of this node. For the root node, null is returned.

#{node.ancestors}

Returns the hierarchy list of ancestors of this node (of type NavigationResource) starting with the root node.

For example, assuming the current node is home/company/products/applications, the following ELs return the following values:

  • #{node.ancestors[1]} returns the node for home

  • #{node.ancestors[3]} returns the node for home/company/products

#{node.depth}

Returns the depth of this node from the root node. Root node has a depth of zero.

#{node.siblings}

Returns the list of siblings (of type NavigationResource) of this node (inclusive).

#{node.nextSibling}

Returns the next sibling in the list (of type NavigationResource) of this node.

For example, the following code ensures that you do not output two separators in a row:

<c:if test="${(node.separator) && (!node.nextSibling.separator}">
  <af:separator id="s166"/>
</c:if>

#{node.previousSibling}

Returns the previous sibling in the list (of type NavigationResource) of this node.

#{node.index}

Returns the zero-relative index of this node relative to its siblings.

#{node.children}

#{node.children[N].title}

#{node.children[N].children[N].title}

Returns a collection of child resources.

#{node.childCount}

Returns the number of children of this node.

#{node.childByIndex['index']}

Returns the child node (of type NavigationResource) specified by the zero-relative index

If not found, this returns null.

#{node.childByPath['admin']}

Returns the child node (of type NavigationResource) specified by the path relative to this node

The path can be deeper than one level and does not need the '/' prefix. If not found, this returns null.


B.3.5 EL Expressions Relevant to Resources

Use the expressions in this section to query for resources. Querying for a resource through an EL expression is similar to querying for it through an API call. That is, you must set query parameters in the format .property['value'], where property is the name of the property, for example, id, resourceScope, and the like, and value is the search value for the attribute.

A query can result in single or multiple results. The query designer must decide what is wanted. The query designer determines whether to return one or multiple results by encountering one of the following values in the expression:

  • singleResult—Returns a single resource. When no matching resource is found, null is returned.

  • resultList—Returns a list of resources. When no matching resources are found, an empty list is returned.

Note:

Occurrences of singleResult or resultList in the expression are used internally as the query end point, and, after this, the query is executed immediately. Anything set after the end point can result in unexpected behavior.

The following example returns the first template resource found with a display name that contains myPage:

#{srmContext.resourceType['siteTemplate'].displayName['myPage'].singleResult}

The following example returns a list of template resources residing in the directory resourceDir, with a description that contains sampleDesc:

#{srmContext.resourceType['siteTemplate'].description['sampleDesc'].contentDirectory['resourceDir'].resultList}

A property of this class includes any attribute of this class. Example properties include: Id, DisplayName, iconURI, contentDirectory, and the like.

The property value can be an explicit value or an EL expression that returns that type of value. For example, the following two queries return the same result:

#{srmContext.id['resourceId'].singleResult}

#{srmContext.id['spacesContext.currentSpace.uiMetadata.siteTemplateId'].singleResult}

You can use any property of this class in an EL-based query in the format property['value'] and in any order. For example, the following two queries return the same result:

#{srmContext.resourceScope['scopeName'].id['resourceId'].singleResult}

#{srmContext.id['resourceId'].resourceScope['scopeName'].singleResult} 

Table B-13 lists EL expressions relevant to WebCenter resources and describes the types of functionality each provides. You can use all resource EL expressions in both WebCenter Spaces and custom portal applications built with Oracle JDeveloper.

Table B-13 ELs Relevant to WebCenter Site Resources

EL Function

#{srmContext.id['resourceGUID']}

Returns the resource with the specified ID

#{srmContext.displayName['resourceDisplayName']}

Returns any resources with the specified display name

#{srmContext.displayNameKey['displayNameKey']}

Returns any resources with the specified display name key

#{srmContext.description['resourceDescription'].singleResult}

Returns one result of a resource that contains the specified value in its description

To get multiple results, use resultList in lieu of singleResult.

#{srmContext.descriptionKey[descriptionKey].singleResult}

Returns one result of a resource with the specified description key

The description key is the key in the xsrt file for the resource description.

To get multiple results, use resultList in lieu of singleResult.

#{srmContext.createdDate['resourceCreationDate']}

Returns any resource with the specified creation date

#{srmContext.modifiedBy['resourceLastModifiedBy']}

Returns any resource that was last modified bythe user with the specified user name

#{srmContext.modifiedDate['resourceLastModifiedDate']}

Returns any resource that was last modified by the specified date

#{srmContext.resourceScope['resourceScope']}

Returns any resource that falls within the specified scope

#{srmContext.category['categoryName']}

Returns any resource that falls within the specified category

For example:

#{srmContext.category['siteTemplates']}

#{srmContext.contentDirectory['contentDirectory']}

Returns any resource that is stored within the specified directory

#{srmContext.metadataFile['metadataFileLocation']}

Returns resource metadata from the specified metadata file

For example, the following expression returns resource metadata from the following file /home/metadata/data.xml:

#{srmContext.metadataFile['/home/metadat/data.xml']}

#{srmContext.jspx['jspxFileLocation']}

Returns any jspx file in the specified location

For example, the following expression returns the page.jspx file:

#{srmContext.jspx['/home/web/page.jspx']}

#{srmContext.pageDef['pageDefinition']}

Returns any jspx file with the specified page definition

#{srmContext.iconURI['iconURI']}

Returns the icon at the specified icon URI

#{srmContext.excludeFrom['excludeFromScopes']}

In a larger expression, returns all specified resources except those available in the excluded scopes

#{srmContext.usesCustomSecurity['usesCustomSecurity']}

In a larger expression, returns any resource the either does or does not use custom security

Set usesCustomSecurity to TRUE or FALSE. For example:

#{srmContext.usesCustomSecurity['TRUE']}

#{srmContext.seeded['seeded']}

In a larger expression, returns any resource that is or is not seeded, depending on the provided value

Set seeded to TRUE or FALSE. For example:

#{srmContext.seeded['TRUE']}

#{srmContext.visibleType['visibleType']}

In a larger expression, returns any resource that is of the specified type of visibility

Set visibleType to TRUE, FALSE, or NEVER to indicate that the resource is never shown. For example, the following expression returns resources that are visible, that is, resources that are set to Show:

#{srmContext.visibleType['TRUE']}

#{srmContext.visible['visible']}

In a larger expression, returns one or multiple resources with visibility set to either TRUE or FALSE

#{srmContext.createdBy['resourceCreator']}

In a larger expression, returns any resource created by the specified user

#{srmContext.resourceType['resourceType']}

In a larger expression, returns one or multiple resources of the specified type

For example, the following expression searches for a resource of the type SITE_TEMPLATE:

#{srmContext.resourceType['SITE_TEMPLATE']}

Note that all resource types are listed in Oracle Fusion Middleware Java API Reference for Oracle WebCenter, in the GenericSiteResourceTypes class.

#{srmContext.version['version']}

In a larger expression, returns one or multiple resources available in the application of the specified version

#{srmContext.resourceScope['scopeName']}

In a larger expression, returns one or multiple resources available in the specified scope

For example, the following expression searches for resources in the scope (in this instance, the Space) MySpace:

#{srmContext.resourceScope['MySpace']}

To search in the default scope, that is, the application scope, use defaultScope.

#{srmContext.searchType['searchType']}

In a larger expression, returns one or multiple resources that contain or equal the values set by other included expressions

Set searchType to CONTAINS or EQUALS.


B.3.6 EL Expressions Relevant to Specific Spaces

Table B-14 lists EL expressions relevant to Spaces and describes the types of functionality each provides. All of the listed ELs are for use in WebCenter Spaces.

Note:

The Space internal name is the name specified by the Space URL on the General page of a Space's administration settings. The Space display name is specified by Display Name. Many of the EL expressions in Table B-14 call for the Space internal name.

Table B-14 EL Expressions Relevant to WebCenter Spaces Spaces

Expression Function

#{spaceContext}

An oracle.webcenter.spaces.context.SpacesContext object that provides an access point in the current web request for all Space-related information.

The value of this expression is whatever is returned on invoking the java API: SpacesContext.getCurrentInstance()

#{spaceContext.currentSpace}

An oracle.webcenter.spaces.Space object that represents the Space associated with the current web request. If the current web request is in the Home Space context, it returns a value of null.

The value of this expression is whatever is returned on invoking the Java API: SpacesContext.getCurrentInstance().getCurrentSpace()

#{spaceContext.currentSpaceName}

The name of the Space associated with the current web request. If the current web request is in a Home Space context, it returns a value of null.

The value of this expression is whatever is returned on invoking the java API: SpacesContext.getCurrentInstance().getCurrentSpace()

#{spaceContext.space['spaceName']}

#{spaceContext.currentSpace}

An oracle.webcenter.spaces.Space object that represents the Space that is named spaceName or the current Space (currentSpace). For example, #{spaceContext.space['FinanceProject']} returns the Space object for the Space called FinanceProject.

The value of this expression is whatever is returned in Java on invoking .getSpace(...) on the current SpacesManager passing in the MDSSession of the current ADFContext.

#{spaceContext.space['spaceName'].metadataPath}

#{spaceContext.currentSpace.metadataPath}

The MDS path of the space metadata document for the Space with specified name spaceName or the current Space (currentSpace). For example, #{spaceContext.space['FinanceProject'].metadataPath} evaluates to /oracle/webcenter/space/metadata/spaces/FinanceProject/space.xml

The value of this expression is whatever is returned in java on invoking .getMetadataPath() on the space object for the Space.

#{spaceContext.space['spaceName'].metadata}

#{spaceContext.currentSpace.metadata}

An oracle.webcenter.spaces.beans.SpaceType bean that carries metadata about the Space that is named spaceName or the current Space (currentSpace).

The value of this expression is whatever is returned in java on invoking .getMetadata() on the space object for the Space passing in the MDSSession of the current ADFContext.

#{spaceContext.space['spaceName'].metadata.displayName}

#{spaceContext.currentSpace.metadata.displayName}

The display name of the Space that is named spaceName or the current Space (currentSpace). For example, if a Space called Web20Space has the display name web 2.0 Space, then #{spaceContext.space['Web20Space'].metadata.displayName} evaluates to web 2.0 Space.

#{WCAppContext.spacesResourcesPath}#{spaceContext.space['spaceName'].metadata.icon}

#{WCAppContext.spacesResourcesPath}#{spaceContext.currentSpace.metadata.icon}

A URL to the icon associated with the Space that is named spaceName or the current Space (currentSpace).

#{spaceContext.space['spaceName'].metadata.description}

#{spaceContext.currentSpace.metadata.description}

The description of the Space that is named spaceName or the current Space (currentSpace). For example, #{spaceContext.space['FinanceProject'].metadata.description} evaluates to Conglomeration of all teams involved in financial activities.

#{spaceContext.space['spaceName'].metadata.creationDate}

#{spaceContext.currentSpace.metadata.creationDate}

A java.util.Calendar object representing the date-time on which the Space with specified name spaceName or the current Space (currentSpace) was created.

#{spaceContext.space['spaceName'].metadata.createdBy}

#{spaceContext.currentSpace.metadata.createdBy}

The user-name of the person who created the Space that is named spaceName or the current Space (currentSpace).

#{spaceContext.space['spaceName'].metadata.keywords}

#{spaceContext.currentSpace.metadata.keywords}

A comma-delimited list of searchable keywords associated with the Space with the name spaceName or the current Space (currentSpace). For example, if the Space FinanceProject has the keywords finance, project, money, then #{spaceContext.space['FinanceProject'].metadata.keywords} evaluates to finance, project, money.

#{spaceContext.space['spaceName'].metadata.offline}

#{spaceContext.currentSpace.metadata.offline}

Boolean value that indicates whether the Space that is named spaceName or the current Space (currentSpace) is offline.

#{spaceContext.space['spaceName'].metadata.closed}

#{spaceContext.currentSpace.metadata.closed}

Boolean value that indicates whether the Space that is named spaceName or the current Space (currentSpace) is closed.

#{spaceContext.space['spaceName'].metadata.selfRegistration}

#{spaceContext.currentSpace.metadata.selfRegistration}

Boolean value that indicates whether users are allowed to register themselves with the Space that is named spaceName or the current Space (currentSpace).

#{spaceContext.space['spaceName'].metadata.discoverable}

#{spaceContext.currentSpace.metadata.discoverable}

Boolean value that indicates whether users can discover the existence of the Space that is named spaceName or the current Space (currentSpace) by searching for it or seeing it listed on the My Spaces page.

#{spaceContext.space['spaceName'].metadata.publishRSS}

#{spaceContext.currentSpace.metadata.publishRSS}

Boolean value indicating whether the Space that is named spaceName or the current Space (currentSpace) publishes RSS feeds.

#{spaceContext.space['spaceName'].distributionList}

#{spaceContext.currentSpace.distributionList}

The email address of the mailing list associated with the Space that is named spaceName or the current Space (currentSpace).

#{spaceContext.space['spaceName'].metadata.customAttributes['attributeName']}

#{spaceContext.currentSpace.metadata.customAttributes['attributeName']}

The value of a specific custom attribute of the name attributeName for the Space that is named spaceName or the current Space (currentSpace). For example, if the FinanceProject Space has a custom attribute called stockPrice with a value of 13.9, then #{spaceContext.space['FinanceProject'].metadata.customAttributes['stockPrice']} evaluates to 13.9.

#{WCAppContext.spacesResourcesPath}#{spaceContext.space['spaceName'].metadata.logo}

#{WCAppContext.spacesResourcesPath}#{spaceContext.currentSpace.metadata.logo}

Returns the logo URL for the Space named spaceName or the current Space (currentSpace).

#{spaceContext.spacesQuery.property['value']}

#{spaceContext.spacesQuery.property['value'].listSpaces}

A means of querying a Space using a query parameter in the form of property['value'], where property means the name of the property, for example, unionOf, shape, and the like; and value means the criteria to use in fetching the list of all Spaces, discoverable Spaces, and the like.

If listSpaces is appended to the expression, the query returns the list of Spaces of type GSMetadata. (For more information, see Interface GSMetadata in Oracle Fusion Middleware Java API Reference for Oracle WebCenter.)

For example, the following EL expression returns a list of all discoverable Spaces.

#{spaceContext.spacesQuery.unionOf['DISCOVERABLE'].listSpaces}

If listSpaces is not appended to the EL, then the EL evaluates to an object of type SpacesQueryParameter. This object type must be evaluated using SpacesManager.getSpaces(SpacesQueryParameters), which in turn returns a list of spaces of type GSMetadata.

For example, the following EL expression returns an instance of type SpacesQueryParameters with all the query conditions populated.

#{spaceContext.spacesQuery.unionOf['DISCOVERABLE']}

#{spaceContext.spacesQuery.unionOf['USER_JOINED'].shape['ROOT_LEVEL'].listSpaces}

Returns a list of all top-level Spaces of which the current user is a member

This EL returns only those Spaces that do not have a parent, that is, it does not return Subspaces.

#{spaceContext.spacesQuery.unionOf['USER_JOINED'].shape['RECURSIVE_FLATTENED'].listSpaces}

Returns a list of all Spaces of which the current user is a member

This EL also returns all the Subspaces under each of the parent Spaces to which the current user has access.

#{spaceContext.spacesQuery.unionOf['ALL_QUERIABLE'].sortCriteria[sortBy fields picked from WcSpaceHeader]}

Returns Spaces sorted into the order specified by the sort criteria

For example, the following query returns a list of Spaces to which the user has access sorted by discoverable and lastUpdateDate fields.

Note that in the following example, the idenitifier sp represents the JPA entity for a space, WcSpaceHeader.

#{spaceContext.spacesQuery.unionOf['ALL_QUERIABLE'].sortCriteria['sp.discoverable, sp.lastUpdateDate desc'].listSpaces}

#{spaceContext.spacesQuery.unionOf['ALL_QUERIABLE'].pageNumber[page_num].listSpaces}

Allows specifying the page number (0-based) to select from the results matching the query criteria

For example, the following expression returns a list of all Spaces to whichc a user has access and returns the third page of the result set:

#{spaceContext.spacesQuery.unionOf['ALL_QUERIABLE'].pageNumber[2].listSpaces]}

#{spaceContext.spacesQuery.unionOf['ALL_QUERIABLE'].itemsPerPage[page_num].listSpaces}

Allows specifying the number of results to be included in each page when breaking down the result space into pages

For example, the following expression returns a list of all Spaces to which a user has access, listing 10 records per page.

#{spaceContext.spacesQuery.unionOf['ALL_QUERIABLE'].pageNumber[10].listSpaces]}

B.3.7 EL Expressions Relevant to Specific Pages

Table B-15 lists EL expressions relevant to application pages and describes the types of functionality it provides. The Context column indicates whether the expression can be used in a WebCenter Spaces context (WCS) or in both WebCenter Spaces and custom portal applications built with Oracle JDeveloper (Both). These expressions are useful in WebCenter Spaces and in custom WebCenter applications that include the Page service.

Table B-15 EL Expressions Relevant to Application Pages

Expression Function

#{pageDocBean.title}

Returns the page display name, for example:

FinanceProject

#{pageDocBean.createdBy}

Returns the user name of the person who created the page, for example:

monty

#{pageDocBean.createDateString}

Returns the date and time the page was created, for example:

2008-11-19T10:18:36

#{pageDocBean.lastUpdatedBy}

Returns the user name of the person who last updated the page, for example:

monty

#{pageDocBean.lastUpdateDateString}

Returns the date and time the page was last updated, for example:

2008-11-19T10:18:36

#{pageDocBean.pagePath}

Returns the file directory path to the page relative to the application root directory, for example:

/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/user/Umonty/Page4.jspx

#{pageDocBean.name}

Returns the file name of the page, for example:

Page4.jspx

#{pageDocBean.UICSSStyle}

Returns the name of the style scheme used on the page, for example:

WCSchemeEggShell

#{pageDocBean.UISchemeBGImage}

Returns the directory path and file name of the page scheme background image.

#{pageDocBean.UISchemeBGColorString}

Returns the hexadecimal value of the page scheme background color, for example:

#ffa500

#{pageDocBean.pagePermission}

Returns the permission the current user has on the page, for example:

oracle.webcenter.page.model.security.CustomPagePermission

#{pageDocBean.pageSecurityTarget}

A string of 60 or so characters that uniquely identifies the current page to the security system, for example:

oracle_webcenter_page_scopedMD_s8bba98ff_4cbb_40b8_beee_296c916a23ed_user_Umonty_Page4PageDef


B.3.8 EL Expressions Relevant to Oracle Composer

Table B-16 lists EL expressions relevant to Oracle Composer. The Context column indicates whether the expression can be used in a WebCenter Spaces context (WCS) or in both WebCenter Spaces and custom portal applications built with Oracle JDeveloper (Both). These expressions are useful in WebCenter Spaces and in custom WebCenter applications that include Oracle Composer.

Table B-16 EL Expressions Relevant to Oracle Composer

Expression Function Context

#{composerContext.inEditMode}

Determines whether the current page is in View mode or Edit mode, for example:

<af:outputText id="ot1"
  value="#{composerContext.inEditMode ne
  true ? 'View mode' : 'Edit mode'} />

This example shows an ADF Faces outputText component that returns View mode when the page is in View mode and Edit mode when the page is in Edit mode.

Both


B.3.9 EL Expressions Relevant to Event Contexts

Table B-17 lists EL expressions relevant to the types of events that can trigger the passing of payloads (rather than events relevant to the Events service).

You can access all or part of the event payloads provided in Table B-17 once they have been raised.

For example, for the whole payload, use the following EL:

#{wcEventContext.events.<eventName>}

For example:

#{wcEventContext.events.WebCenterUserSelected}

All of the payloads for the ELs in Table B-17 are Maps. To dereference a map entry, use the standard EL for Maps:

#{wcEventContext.events.WebCenterUserSelected.UserName}

See Also:

For more information about event wiring, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Table B-17 EL Expressions Relevant to Event Contexts

Expression Function

Event Context

#{wcEventContext.events.WebCenterResourceSelected}

Document Name

#{wcEventContext.events.WebCenterResourceSelected.name}

Document Creator

#{wcEventContext.events.WebCenterResourceSelected.createdBy}

Document Last Modified By

#{wcEventContext.events.WebCenterResourceSelected.lastModifiedBy}

Use in context wiring between producer and consumer task flows. Returns a map that relates some piece of metadata from the producer to some piece of metadata from the consumer, for example, from a document creator to the creator's Profile.

Producer task flows include:

  • Document Manager

  • Recent Documents

  • Document List Viewer

Consumer task flows include:

  • Activity Graph - Similar Items (show other documents that may be of interest to the user)

  • Links (showthe items that are linked to the selected document)

  • Profile (view the Profile of the document's author)

  • Activity Stream (view activities related to this document)

  • Tags (tags on this document and a means of accessing the Tag Center)

Event Context

#{wcEventContext.events.WebCenterUserSelected}

User Name

#{wcEventContext.events.WebCenterUserSelected.userName}

User GUID

#{wcEventContext.events.WebCenterUserSelected.userGUID}

Space Name

#{wcEventContext.events.WebCenterUserSelected.spaceName}

Space GUID

#{wcEventContext.events.WebCenterUserSelected.spaceGUID}

Use in context wiring between producer and consumer task flows. Returns a map that relates some piece of metadata from the producer to some piece of metadata from the consumer, for example, from a user to the user's connections.

Producer task flows include:

  • Connections

  • Space Members

Consumer task flows include:

  • Connections (show connections of the selected user)

  • Documents task flows (show documents created by the selected user)

  • Activity Stream (view this user's activities)

  • Tags (tags created by this user)

  • Profile (show this user's Profile)

Event Context

#{wcEventContext.events.WebCenterConnectionSelected}

Profile User Name

#{wcEventContext.events.WebCenterConnectionSelected.profileUserName}

Profile User GUID

#{wcEventContext.events.WebCenterConnectionSelected.profileUserGUID}

Connected User Name

#{wcEventContext.events.WebCenterConnectionSelected.userName}

Connected User GUID

#{wcEventContext.events.WebCenterConnectionSelected.userGUID}

--

#{wcEventContext.events.WebCenterSpaceSelected.SpaceName}

Returns the name of the selected Space

#{wcEventContext.events.WebCenterSpaceSelected.SpaceGUID}

Returns the GUID of the selected Space


B.3.10 EL Expressions Relevant to Services

Table B-18 lists EL expressions relevant to services and describes the types of functionality it provides. All listed ELs can be used in both WebCenter Spaces and WebCenter Framework.

Table B-18 EL Expressions Relevant to Services

Expression Function

#{webcenterService['serviceId']}

An oracle.webcenter.framework.service.Service object representing the WebCenter service with the service ID serviceId. For example, the following EL returns Documents Service.

#{webcenterService['oracle.webcenter.doclib']}

For service IDs, see Table B-19.

#{webcenterService['serviceId'].configured}

Returns a Boolean value that indicates whether the WebCenter service with the service ID serviceId is configured for use in the current WebCenter Spaces application. For example, the following EL returns true if Discussions service can be used in the application, false otherwise:

#{webcenterService['oracle.webcenter.collab.forum'].configured}

For service IDs, see Table B-19.

#{sessionContext['oracle.webcenter.collab.forum'].groupInfo['spaceName'].forumId}

Returns the forum ID of the specified Space discussion forum. Enter the Space name in lieu of spaceName.

#{sessionContext['oracle.webcenter.collab.forum'].groupInfo['spaceName'].categoryId}

Returns the category ID of the specified Space discussion forums. Enter the Space name in lieu of spaceName.


Table B-19 lists service IDs associated with services at runtime.

Table B-19 Service IDs

Service ID

Announcements

oracle.webcenter.collab.announcement

Discussions

oracle.webcenter.collab.forum

Documents and Wikis

oracle.webcenter.doclib

Events

oracle.webcenter.collab.calendar.community

Space Management

oracle.webcenter.community

Instant Messaging and Presence (IMP)

oracle.webcenter.collab.rtc

Links

oracle.webcenter.relationship

Lists

oracle.webcenter.list

Mail

oracle.webcenter.collab.mail

Notes

oracle.webcenter.note

Notifications

oracle.webcenter.notification

Page

oracle.webcenter.page

People Connections: Activity Stream

oracle.webcenter.activitystreaming

People Connections: Connections

oracle.webcenter.peopleconnections.connections

People Connections: Feedback

oracle.webcenter.peopleconnections.kudos

People Connections: Message Board

oracle.webcenter.peopleconnections.wall

People Connections: Profile

oracle.webcenter.peopleconnections.profile

Polls

oracle.webcenter.collab.survey

Recent Activities

oracle.webcenter.recentactivity

Activity Graph

oracle.webcenter.activitygraph

RSS

oracle.webcenter.rss

Search

oracle.webcenter.search

Tags

oracle.webcenter.tagging

Blogs

oracle.webcenter.blog

Worklist

oracle.webcenter.worklist


B.3.11 EL Expressions Relevant to the Personalization Conductor

Table B-20 lists EL expressions relevant to the Personalization Conductor and describes the types of functionality it provides. All listed ELs can be used in both WebCenter Spaces and custom portal applications built with Oracle JDeveloper.

Table B-20 EL Expressions Relevant to the Personalization Conductor

Expression Function

#{p13nContext.reset}

Clears the state of the context object in which it is invoked.

Other examples:

#{p13nContext.conductor['ConductorConnection'].reset} 
#{p13nContext.conductor['ConductorConnection'].namespaces['MyNamespace'].reset}
#{p13nContext.properties['PropertiesConnection'].namespaces['MyNamespace'].setDefinitions['MyPropertySetDefinition'].set['MyPropertySet'].reset}

#{p13nContext.properties['PropertiesConnection'].namespaces['MyNamespace'].setDefinitions['MyPropertySetDefinition'].set['MyPropertySet'].update}

Updates the property set with new values if bound to a form.

The update method applies only to the context PropertySetContext, and can be called onlyas part of a form-based action.

#{p13nContext.properties['PropertiesConnection'].namespaces['MyNamespace'].setDefinitions['MyPropertySetDefinition'].set['MyPropertySet'].results}

Retrieves the results of the context object. In the case of PropertySetContext, it retrieves the property set by name and property set definition, if they exist.

In the case of ScenarioExecutionContext and ParameterizedScenarioExecutionContext, the scenario results are retrieved.

Other examples:

#{p13nContext.conductor['ConductorConnection'].namespaces['MyNamespace'].scenario['MyScenario'].results}
#{p13nContext.conductor['ConductorConnection'].namespaces['MyNamespace'].scenario['MyScenario'].withInput['input1=val1;input2=value2;input3=value3'].results} 

#{p13nContext.conductor['PropertiesConnection'].namespaces['MyNamespace'].scenario['MyScenario'].results}

Executes a scenario by name.

#{p13nContext.conductor['ConductorConnection'].namespaces['MyNamespace'].scenario['MyScenario'].withInput['input1=val1;input2=value2;input3=value3'].results}

Executes a scenario by name with input parameters. Input parameters must be in the following format:

<paramOne>=<valueOne>;<paramTwo>=<valueTwo>;<paramThree>=<valueThree> 

Where each parameter name and value is separated by semicolon.

The withInput method applies only to the context ScenarioExecutionContext.

#{p13nContext.conductor['ConductorConnection'].namespaces[myManagedBean.namespace].scenario[myManagedBean.scenario].isError}

Determines if an error has occurred in the current context object.

The isError method applies only to PropertySetContext and ~ScenarioExecutionContext.

Other examples:

#{p13nContext.properties['PropertiesConnection'].namespaces['MyNamespace'].setDefinitions['MyPropertySetDefinition'].set['MyPropertySet'].isError}

#{p13nContext.conductor['ConductorConnection'].namespaces['myManagedBean.namespace'].scenario['myManagedBean.scenario'].errorMessage}

Returns the error message if an error has occurred in the current context object.

The errorMessage method applies only to PropertySetContext and ~ScenarioExecutionContext.

Other examples:

#{p13nContext.properties['PropertiesConnection'].namespaces['MyNamespace'].setDefinitions['MyPropertySetDefinition'].set['MyPropertySet'].errorMessage}

B.3.12 EL Expressions Relevant to the Documents Service

Table B-21 lists EL expressions relevant to the Documents service and describes the types of functionality it provides. The Context column indicates whether the expression can be used in a WebCenter Spaces context (WCS) or in both WebCenter Spaces and custom portal applications built with Oracle JDeveloper (Both).

Table B-21 EL Expressions Relevant to the Documents Service

Expression Function Context

#{documentsService.currentGroupSpace}

Provides information on the Space's documents. Returns a bean that provides access to documents-related information for the Space.

WCS

#{documentsService.currentUser}

Provides information about the current user's documents.

WCS

#{documentsService.defaultConnectionName}

Gets the default content repository connection name. Returns null if no connection name is defined.

Both

#{documentsService.groupSpaceByGUID['GUID']}

Provides a way to look up a given Space's documents information by the Space's GUID. Returns a bean that provides documents-related information for the Space.

WCS

#{documentsService.groupSpaceByName['spaceName']}

Provides a way to look up a given Space's documents information by the Space's name. Returns a bean that provides access to documents-related information for the Space.

Enter the Space internal name. The Space internal name is the name specified by the Space URL on the General page of a Space's administration settings. The Space display name is specified by Display Name, and is the name that appears in the banner at the top of a Space. Many of the EL expressions in Table B-14 call for the Space internal name.

WCS

#{documentsService.userByName['userName']}

Provides a way to look up user documents information by user name. Returns a bean that provides access to documents-related information for the user.

WCS

#{documentsService.configured}

Checks whether the Documents service is configured. Returns true if the Documents service is configured, otherwise false.

Both


B.3.13 EL Expressions Relevant to the People Connections Service

Table B-22 lists EL expressions relevant to the Profile feature of the People Connections service and describes the types of functionality it provides. All listed ELs can be used in both WebCenter Spaces and custom portal applications built with Oracle JDeveloper.

Note:

The entry securityContext.userName, included in every Profile expression, returns the name of the current user. Note also that information is returned only if it is present in the user's profile. If the information is not included in the profile, a null value is returned.

Table B-22 EL Expressions Relevant to the People Connections Service (Profile)

Expression Function

#{WebCenterProfile[userName].ManagerDisplayName}

#{WebCenterProfile[securityContext.userName].ManagerDisplayName}

The display name of the specified user's manager if the current user is allowed to know it.

#{WebCenterProfile[userName].employeeNumber}

#{WebCenterProfile[securityContext.userName].employeeNumber}

The specified user's employee number if the current user is allowed to know it.

#{WebCenterProfile[userName].businessPOBox}

#{WebCenterProfile[securityContext.userName].businessPOBox}

The post office box number associated with the specified user if the current user is allowed to know it.

#{WebCenterProfile[userName].timeZone}

#{WebCenterProfile[securityContext.userName].timeZone}

The time zone in which the specified user's home office is located if the current user is allowed to know it.

#{WebCenterProfile[userName].description}

#{WebCenterProfile[securityContext.userName].description}

A description of the specified user (from Profile "About Me") if the current user is allowed to know it.

#{WebCenterProfile[userName].department}

#{WebCenterProfile[securityContext.userName].department}

The department to which the specified user belongs if the current user is allowed to know it.

#{WebCenterProfile[userName].businessPager}

#{WebCenterProfile[securityContext.userName].businessPager}

The specified user's business pager number if the current user is allowed to know it.

#{WebCenterProfile[userName].businessCity}

#{WebCenterProfile[securityContext.userName].businessCity}

The city in which the specified user is located if the current user is allowed to know it.

#{WebCenterProfile[userName].maidenName}

#{WebCenterProfile[securityContext.userName].maidenName}

The specified user's surname or last name before marriage if the current user is allowed to know it.

#{WebCenterProfile[userName].businessFax}

#{WebCenterProfile[securityContext.userName].businessFax}

The specified user's business fax number if the current user is allowed to know it.

#{WebCenterProfile[userName].dateofHire}

#{WebCenterProfile[securityContext.userName].dateofHire}

The specified user's date of hire if the current user is allowed to know it.

#{WebCenterProfile[userName].nameSuffix}

#{WebCenterProfile[securityContext.userName].nameSuffix}

Additional information appended to the user's name, such as Esq., Jr., and so on if the current user is allowed to know it.

#{WebCenterProfile[userName].middleName}

#{WebCenterProfile[securityContext.userName].middleName}

The specified user's middle name if the current user is allowed to know it.

#{WebCenterProfile[userName].homePhone}

#{WebCenterProfile[securityContext.userName].homePhone}

The specified user's home phone number if the current user is allowed to know it.

#{WebCenterProfile[userName].employeeType}

#{WebCenterProfile[securityContext.userName].employeeType}

The specified user's employee type classification, for example, IC4 if the current user is allowed to know it.

#{WebCenterProfile[userName].lastName}

#{WebCenterProfile[securityContext.userName].lastName}

The specified user's surname or last name if the current user is allowed to know it.

#{WebCenterProfile[userName].dateofBirth}

#{WebCenterProfile[securityContext.userName].dateofBirth}

The specified user's birthday if the current user is allowed to know it.

#{WebCenterProfile[userName].businessState}

#{WebCenterProfile[securityContext.userName].businessState}

The state in which the specified user's home office is located if the current user is allowed to know it.

#{WebCenterProfile[userName].homeAddress}

#{WebCenterProfile[securityContext.userName].homeAddress}

The specified user's home street address if the current user is allowed to know it.

#{WebCenterProfile[userName].businessStreet}

#{WebCenterProfile[securityContext.userName].businessStreet}

The street on which the specified user's home office is located if the current user is allowed to know it.

#{WebCenterProfile[userName].businessPostalCode}

#{WebCenterProfile[securityContext.userName].businessPostalCode}

The specified user's postal or ZIP code if the current user is allowed to know it.

#{WebCenterProfile[userName].initials}

#{WebCenterProfile[securityContext.userName].initials}

The specified user's initials if the current user is allowed to know it.

#{WebCenterProfile[userName].firstName}

#{WebCenterProfile[securityContext.userName].firstName}

The specified user's first name if the current user is allowed to know it.

#{WebCenterProfile[userName].organizationalUnit}

#{WebCenterProfile[securityContext.userName].organizationalUnit}

The organizational unit to which the specified user belongs, for example, D10, if the current user is allowed to know it.

#{WebCenterProfile[userName].wirelessAcctNumber}

#{WebCenterProfile[securityContext.userName].wirelessAcctNumber}

The specified user's wireless account number if the current user is allowed to know it.

#{WebCenterProfile[userName].businessPhone}

#{WebCenterProfile[securityContext.userName].businessPhone}

The specified user's business telephone number if the current user is allowed to know it.

#{WebCenterProfile[userName].businessCountry}

#{WebCenterProfile[securityContext.userName].businessCountry}

The country in to which the specified user is assigned if the current user is allowed to know it.

#{WebCenterProfile[userName].preferredLanguage}

#{WebCenterProfile[securityContext.userName].preferredLanguage}

The specified user's preferred language if the current user is allowed to know it.

#{WebCenterProfile[userName].displayName}

#{WebCenterProfile[securityContext.userName].displayName}

The specified user's display name if the current user is allowed to know it.

#{WebCenterProfile[userName].userName}

#{WebCenterProfile[securityContext.userName].userName}

The specified user's actual name if the current user is allowed to know it.

#{WebCenterProfile[userName].title}

#{WebCenterProfile[securityContext.userName].title}

The specified user's job title if the current user is allowed to know it.

#{WebCenterProfile[userName].businessEmail}

#{WebCenterProfile[securityContext.userName].businessEmail}

The specified user's business email address if the current user is allowed to know it.

#{WebCenterProfile[userName].organization}

#{WebCenterProfile[securityContext.userName].organization}

The organzation to which the specified user belongs, for example, Sales, if the current user is allowed to know it.

#{WebCenterProfile[userName].businessMobile}

#{WebCenterProfile[securityContext.userName].businessMobile}

The specified user's cell or mobile phone number if the current user is allowed to know it.

#{WebCenterProfile[userName].expertise}

#{WebCenterProfile[securityContext.userName].expertise}

The specified user's business expertise if the current user is allowed to know it.


B.3.14 EL Expressions Relevant to User Preferences

Table B-23 lists EL expressions relevant to user preferences and describes the types of functionality they provide. All listed ELs can be used in both WebCenter Spaces and custom portal applications built with Oracle JDeveloper.

Table B-23 EL Expressions Relevant to User Preferences

Expression Function

#{generalSettings.userTimeZone}

Returns the time zone the current user has selected in application Preferences. For more information, see Section 35.3, "Setting Date and Time Preferences."

#{generalSettings.preferredDateStyle}

Returns the date format the current user has selected in application Preferences. For more information, see Section 35.3, "Setting Date and Time Preferences."

#{generalSettings.preferredDatePattern}

Returns the current user's preferred date format pattern if it has been set, else, returns null.

Note that date + pattern is applicable only to custom WebCenter applications, where they take precedence over date + style if they are set.

#{generalSettings.preferredTimeStyle}

Returns the time format the current user has selected in application Preferences. For more information, see Section 35.3, "Setting Date and Time Preferences."

#{generalSettings.preferredTimePattern}

Returns the current user's preferred time format pattern if it has been set, else, returns null.

#{generalSettings.preferredDateTimePattern}

Returns the current user's preferred date and time format pattern if it has been set, else, returns null.

#{generalSettings.preferredAccessibilityMode}

Returns the current user's preferred accessibility mode (either default, inaccessible, or screenReader)

#{generalSettings.preferredSkinName}

The current user's preferred skin name if one is specified, otherwise the default value.

#{generalSettings.formattedCurrentDate}

Returns the current date in the current user's selected locale.

#{generalSettings.formattedCurrentTime}

Returns the current time in the current user's selected locale.

#{generalSettings.formattedCurrentDateTime}

Returns the current date and time in the current user's selected locale.

#{requestContext.skinFamily}

Returns the name of the ADF Faces skin family being used for the current web request, depending on factors such as what has been configured at the application level, the current user's preference setting, and so on.


B.3.15 Utilitarian EL Expressions

Table B-24 lists utilitarian EL expressions and describes the types of functionality it provides.

Table B-24 Utilitarian EL Expressions

Expression Function

#{userPreferences.currentDate}

Returns the current date in the format specified in the current user's preferences.

#{WCTruncator['text']['numberOfChars']}

Returns a truncation of the string specified as text to the number of characters specified as numberOfChars, followed by a trailing ellipsis, for example: #{WCTruncator['abracadabra']['5']} evaluates to abrac...

#{facesContext.viewRoot.locale}

#{facesContext.externalContext.requestLocale}

Both of these expressions return the request locale (that is, the browser locale setting).

#{changeModeBean.inEditMode}

Returns true if current application page is in Oracle Composer mode. Returns false if current application page is not in Oracle Composer mode

#{adfFacesContext.skinFamily}

Returns the current application skin family. Returns the same value as #{requestContext.skinFamily}.