7Home Page and Navigation

This chapter contains the following:

You can configure the Navigator and work area icons on the home page for navigation, as well as define settings for the home page using the Structure work area (Navigator > Configuration > Structure). This work area has two tabs: Navigation Configuration and Home Configuration. Use the Navigation Configuration page to configure the Navigator and work area icons on the home page for navigation. Use the Home Configuration page to configure the display settings of infolet pages in the Analytics section of the home page.

Here are some key configuration tasks that you can do in the Structure work area:

  • Create, edit, and rename the work area icons.

    Note: A work area icon on the Navigator and the home page is a page entry that opens a page or work area, where you can do your tasks.
  • Create a duplicate version of a predefined work area icon and edit the duplicate work area icon to do specific tasks.

  • Reorder the work area icons and change their visibility settings on the Navigator and the home page.

  • Change the display settings of infolet pages on the home page. For example, show or hide, rename, or reorder them.

Groups and Work Area Icons

To address needs specific to your organization, you can create or edit groups and work area icons, which you can open from the Navigator and the Apps section of the home page. For example, you may want to link work area icons to web pages or external applications.

While creating or editing a work area icon or group, you can specify whether to display the group or the work area icon on the home page. So, not all work area icons and groups may appear on the home page. The Navigator may have more work area icons and groups than the home page. If a work area icon appears on both the Navigator and the home page, then you can use either of them to open the page. For work area icons that don't appear on the home page, use the Navigator to open them.

Configuration of the Navigator and Work Area Icons

Use the Navigation Configuration page to configure the Navigator and work area icons on the home page. You can do these tasks on groups and work area icons:

  • Create

  • Edit

  • Show or hide

  • Duplicate predefined work area icons

  • Reorder

Configuration of Infolet Page Display

Use the Home Configuration page to configure the display settings of infolet pages on the home page.

Navigation

Use the Navigation Configuration page to configure the Navigator and work area icons on the home page.

You can do either of these tasks:

  • Create a group and then create a work area icon in that group.

  • Create a work area icon in an existing group.

Create Groups

  1. Activate a sandbox that has the Structure tool in it.

  2. Click Navigator > Configuration > Structure.

  3. On the Navigation Configuration page, click Create, and select Create Group.

  4. Enter a name for the group.

  5. Search and select an icon for the group.

  6. From the Show on Navigator list, select Yes, No, or EL Expression.

    • Yes: The group appears on the Navigator.

    • No: The group doesn't appear on the Navigator and the home page.

    • EL expression: The evaluation of the EL expression decides whether the group will appear on the Navigator and the home page for specific user roles.

  7. If you have selected EL Expression from the Show on Navigator list, click the Edit icon next to the Show on Navigator list. Then enter a value or expression, and click Validate to make sure that the validation result is True. Don't include spaces or double quotes in the EL expression.

  8. Click Save and Close.

Create Work Area Icons

  1. Activate a sandbox that has the Structure tool in it.

  2. Click Navigator > Configuration > Structure.

  3. On the Navigation Configuration page, click Create, and select Create Page Entry.

  4. Enter a name for the work area icon.

  5. Search and select an icon for the work area icon.

  6. Select the group in which you want to place the new work area icon.

  7. From the Show on Navigator list, select Yes, No, or EL Expression.

    • Yes: The work area icon appears on the Navigator.

    • No: The work area icon doesn't appear on the Navigator and the home page.

    • EL expression: The evaluation of the EL expression decides whether the work area icon will appear on the Navigator and the home page for specific user roles.

  8. If you have selected EL Expression from the Show on Navigator list, click the Edit icon next to the Show on Navigator list. Then enter a value or expression, and click Validate to make sure that the validation result is True. Don't include spaces or double quotes in the EL expression.

  9. If you have selected Yes or EL Expression from the Show on Navigator list, select a value from the Show on Springboard list. The value from this list is evaluated to determine if the work area icon will actually appear on the home page.

    • Yes: The work area icon appears on the home page.

      Suppose you have selected EL Expression from the Show on Navigator list. Then, even on selecting Yes from the Show on Springboard list, the work area icon may not appear on the home page. The evaluation of the EL expression decides whether these items will actually appear on the home page.

    • No: The work area icon doesn't appear on the home page.

    • EL expression: The evaluation of the EL expression decides whether the work area icon will appear on the home page.

  10. From the Mobile Enabled list, select Yes or No to specify whether the work area icon will be available for mobile devices. This setting isn't applicable for the panel or banner layout.

  11. Select any of these link types:

    • An application page.

    • A dynamic URL of an external page (outside your application) where the host, port, or context root might change.

    • A Static URL of an external page (outside your application) where the host, port, or context root doesn't change.

  12. Based on the link type, specify the required details to configure the link.

  13. Click Save and Close.

Configure Links for Work Area Icons

While creating a work area icon or editing an existing one, you can determine what the work area icon links to. Use the Create Page Entry or Edit Page Entry page to link a work area icon to any of these link types:

  • Your application page.

  • A dynamic URL of an external page (outside your application) where the host, port, or context root might change.

    You can determine the host and port details, which a dynamic URL starts with, from a lookup based on the application name.

  • A static URL of an external page (outside your application) where the host, port, or context root doesn't change. Static URLs don't require lookups.

  • A secure token URL of a partner application, to which secure tokens are added. Tokens contain identity and security information about users, and can be used to authenticate them without additional authentication requirements, for example, user name and password.

Link to Application Pages

To link a work area icon to one of your application pages, do these tasks:

  1. Select the Application Page link type.

  2. Enter the focus view ID of the target page.

  3. From the Web Application list, select the name of the web application.

    You entered this application name while creating this application using the Setup and Maintenance work area.

  4. For secure access to the target application page from the work area icon, provide the secured resource name and the name of the policy store's application stripe. An example of a secured resource name is oracle.apps.view.pageDefs.CaseList_Form_Attach_UIShellPagePageDef. When a user clicks the link, the application checks the secured resource and the Lightweight Directory Access Protocol (LDAP) policy store. Then, the application determines whether the user has the privilege to view the page.

    You can get the application stripe from the jps.policystore.applicationid parameter in the application's weblogic-application.xml file. Examples of application stripes are crm, fscm, and hcm.

  5. If the page takes parameters, then you can enter a semicolon-delimited string of name=value pairs (for example, org=m1;context=s1) in the Page Parameters List field.

    You can use expression language (EL) to specify the parameters. If the EL evaluates to an object, the toString value of that object is passed as the value of the parameter. An application page may display or act differently based on the parameters that are passed in. For example, if you're opening a page from one group on the home page or Navigator, the parameter might be set to status=Open. Whereas, if you're opening the page from another group, the parameter might be set to status=Closed.

Tip: If there is another work area icon that links to the same application page, then you can enter the same details for all fields, except parameters. On the Navigation Configuration page, open the existing page to view the details, such as Focus View ID, Web Application, and Secured Resource Name. Then, fill in the fields for the new work area icon on the Create Page Entry or Edit Page Entry page.

Link to Dynamic URLs

You can link a work area icon to an external website or application that has a frequently changing host, port, or context root. Instead of updating the link to each application, you can update the details of the web application registration. This change affects all work area icons that contain dynamic links pointing to that web application.

For example, suppose you want to link to a test version of an application. So, you use the dynamic URL link type. When you move the application from test to production environment, just change the host and port details of the web application registration. This change affects all work area icons that contain dynamic links pointing to the web application.

Before you start, make sure you add the application details on the Manage Integration of Additional Applications page to register the web application. These application details are used for configuring dynamic URL links for work area icons.

To link a work area icon to a dynamic URL:

  1. Select the Dynamic URL link type.

  2. From the Web Application list, select the web application name and enter the destination for the web application.

    Let's look at an example:

    Suppose you want to link to a complete URL, http://example:9011/myApp/faces/Page1. Here's what you can do.

    1. From the Web Application list, select myApp. This list displays the application names that were added using the Manage Integration of Additional Applications page. Once you select the application name, the full URL that was added for this application (for example, http://example:9011/myApp/) is automatically used as the start of the dynamic URL.

    2. Enter the destination for the web application, for example, /faces/Page1. This value is appended to the full URL.

After linking a work area icon to a dynamic URL, when you click the work area icon, the target page opens in a new browser window or tab.

Link to Static URLs

You can link a work area icon to an external website or application that has a constant host, port, or context root.

To link a work area icon to a static URL:

  1. Select the Static URL link type.

  2. Enter the URL destination. The URL must start with http:// or https://.

    For example, you can use a static URL to link to http://www.oracle.com.

Link to Static URLs with Secure Destinations

To link a work area icon to a secure token URL of a partner application (that is, outside your application):

  1. Select the Static URL link type.

  2. Select Secure Destination.

  3. From the Web Application list, select the name of the web application.

  4. Enter the destination for the web application. An HTTPS protocol is required to access the application.

  5. Enter the name of the secure token. All secure tokens have a predefined lifetime, and they expire after that duration. So, users must refresh the page to regenerate the tokens.

The application validates the secure token and uses it to authenticate web services within the end user context. Using this mode of modified access, a partner can directly do a task or display information to the specific user without any additional authentication.

Use the Navigation Configuration page to edit and reorder the existing groups and work area icons for navigation.

You can make limited changes in certain work area icons and groups.

  • Structure work area icon: You can only rename it and determine whether to show it on the home page.

  • Configuration and Tools groups: You can only rename these groups.

Edit Groups and Work Area Icons

  1. Activate a sandbox that has the Structure tool in it.

  2. Click Navigator > Configuration > Structure.

  3. On the Navigation Configuration page, click the name link for the group or work area icon.

    Tip: You can use the search panel on the Navigation Configuration page to find the group or work area icon you want to edit.
  4. On the Edit Page Entry page or the Edit Group page, make the required changes.

  5. Click Save and Close.

You can make these changes to a group or a work area icon:

  • Rename a group or work area icon.

  • Change the icon for a group or work area icon.

Note: If a group or page was created using a different tool, you can't change its name and icon using the Navigation Configuration page.
  • For a work area icon, change the group in which the work area icon is placed.

  • Change the Show on Navigator property for the group or work area icon.

  • Change the Show on Springboard property for the work area icon.

  • Change the Mobile Enabled property for the work area icon.

  • For an administrator-defined work area icon, change the settings for link configuration.

  • Delete work area icons that were created using the Navigation Configuration page.

  • For a predefined work area icon, use Create Duplicate on the Edit Page Entry page to create a duplicate work area icon. You can then edit the duplicate work area icon as you want, for example, you can place the duplicate work area icon in a different group or at the top level.

  • For groups with associated quick actions, use the Quick Actions tab to create more quick actions or make changes to the existing ones, such as rename, show or hide, and reorder them.

Edit Pages with Tabs

Some pages (for example, Security Console) have tabs. Each tab is a task flow. To edit tabs, click the Tabs tab on the Edit Page Entry page. You can make these changes:

  • Click the tab name to rename it.

  • Click the tab icon to search and select another icon for the tab.

  • Click the Visible field for the tab, and change the option to show or hide the tab.

  • Use the Move Up and Move Down icons to adjust the relative position of the tabs within the page.

Edit Pages with Panel Tabs

Some pages have panel tabs. To edit panel tabs, click the Panel Tabs tab on the Edit Page Entry page. You can make these changes:

  • Click the panel tab name to rename it.

  • Click the panel tab icon to search and select another icon for the panel tab.

  • Click the Visible field for the panel tab, and change the option to show or hide the tab.

  • Use the Move Up and Move Down icons to adjust the relative position of the panel tabs within the page.

Reorder Groups and Work Area Icons

Use the Move Up and Move Down icons on the Navigation Configuration page to reorder groups and work area icons. For work area icons, you can use the Move To icon to move work area icons to different groups or to the top level.

Use EL expressions to specify whether a group or work area icon should appear on the Navigator and the home page. The evaluation of the EL expression decides whether the group or work area icon is displayed for a user with specific role.

EL Expressions for Configuring the Navigator Menu Items

Use EL expressions to specify whether a group or page entry should appear on the Navigator and the home page. The evaluation of the EL expression decides whether the menu items are displayed for a user.

This table shows examples of how you can use EL Expressions to show or hide groups and work area icons on the Navigator or the home page for specific users.

Who can see the group or work area icons EL Expression and Example

Only users having any of the specific roles

#{securityContext.userInRole['<Role_Name>']}

#{securityContext.userInRole['ORA_FND_APPLICATION_ADMINISTRATOR_JOB,ORA_PER_EMPLOYEE_ABSTRACT']}

Only users not having any of the specific roles

#{!(securityContext.userInRole['<Role_Name>']}

#{!(securityContext.userInRole['ORA_FND_APPLICATION_ADMINISTRATOR_JOB,ORA_PER_EMPLOYEE_ABSTRACT'])}

Only users having all of the specific roles

#{securityContext.userInAllRoles['<Role_Name>']}

#{securityContext.userInAllRoles['ORA_FND_APPLICATION_ADMINISTRATOR_JOB,ORA_PER_EMPLOYEE_ABSTRACT']}

Only users not having all of the specific roles

#{!(securityContext.userInAllRoles['<Role_Name>']}

#{!(securityContext.userInAllRoles['ORA_FND_APPLICATION_ADMINISTRATOR_JOB,ORA_PER_EMPLOYEE_ABSTRACT'])}

Only users having access to specific resources, for example, the Social work area

#{securityContext.userGrantedResource['resourceType=FNDResourceType;resourceName=FND_Launch_Social_Menu;action=launch']}

Here are a few things to keep in mind when you use EL expressions.

  • Use an EL expression that can be evaluated from any page because the Navigator is used on all pages. So, don't use product-specific EL expressions.

  • Don't include spaces or double quotes in EL expressions.

  • Don't copy EL expressions from a word document and paste directly in the expression editor. Doing so might introduce hidden characters in your EL expression, causing formatting issues and unexpected action. Instead, use a text editor or manually type the EL expression in the editor.

Set the Availability Duration of Your Third-Party Application

Let's say you integrate a registered third-party application in your Oracle Cloud Application. You want to secure this third-party application and make it available for users only for a specific duration. For that, you can set the validity duration using the Token Relay Validity Duration profile option and secure your application using JSON Web Token (JWT). Based on the value of this profile option, your third-party application will be available to users for a specific duration. After this duration, users must refresh the page to view it again. Remember that the minimum availability duration is six minutes. So for example, even if you set the availability duration as two minutes (120 seconds), your third-party application will be actually available to users for six minutes.

Before you start, make sure that you have activated a sandbox.

Set the Validity Duration

  1. In the Setup and Maintenance work area, go to the Manage Administrator Profile Values task in the Application Extensions functional area.

  2. Search for the Token Relay Validity Duration (FND_TOKEN_VALIDITY_DURATION) profile option.

  3. In the FND_TOKEN_VALIDITY_DURATION: Profile Values section, click the New icon.

  4. From the Profile Level list, select Site.

  5. In the Profile Value field, enter the time in seconds.

  6. Click Save and Close.

Secure Your Third-Party Application

  1. Click Navigator > Configuration > Structure.

  2. Select the work area icon that links to the third-party application you want to secure.

  3. From the Link Type list, select Static URL.

  4. Select the Secure Destination check box.

  5. Select the name of your application.

  6. Enter the destination for the application. An HTTPS protocol is required to access the application.

  7. In the Secure Token Name field, enter the name of the parameter (for example, jwt) that supports using the secure token.

  8. Click Save and Close.

FAQs for Navigation

Why can't I edit some work area icons and groups?

While configuring the Navigator and work area icons on the home page, you can't do these tasks:

  • Override the Navigator setting for the Structure work area icon and the Tools group. The default setting is Yes, so the Structure work area icon and the Tools group always appear on the Navigator and the home page.

  • Move the Structure work area icon to a different group or to the top level. The default group is Configuration, so the Structure work area icon always appears in the Configuration group.

How can I display the missing work area icons and Navigator menu items for the users?

Try these solutions:

  • If the user can see a group or work area icon in the Navigator, but not on the home page, then enable the offering associated with the group or work area icon.

  • If the user can't see a group or work area icon in both the home page and the Navigator, then assign the required security privileges to the user.

  • Check whether the group or work area icon is hidden from the Navigator or home page using the Structure work area. Use this work area to view the visibility settings of the group or work area icon, and if it's hidden, change the visibility settings to display it.

Home Page

Configure Infolet Display

Use the Home Configuration page in the Structure work area (Navigator > Configuration > Structure) to configure the display settings of infolet pages in the Analytics section of the home page. If you're using a panel or banner layout, the home page displays the page control containing icons that you use to go to infolet pages.

Define Settings

You can rename infolet pages, change their visibility settings, and reorder them. But before you start, activate a sandbox that has the Structure tool in it.

On the Home Configuration page, you can do these tasks:

  • Click the infolet page name to rename it.

  • Click the Visible field for an infolet page to change its visibility setting. You can show or hide specific infolet pages on the home page. To do so, select any of these options:

    • Yes: The infolet page appears on the home page.

    • No: The infolet page doesn't appear on the home page.

    • EL expression: The evaluation of the EL expression decides the visibility of the infolet page on the home page for specific user roles.

  • Use the Move Up and Move Down icons to adjust the relative positions of the infolet pages on the home page.

If you're using a panel or banner layout, you can use profile options to define settings for the filmstrip, which appears between the global header and the page title:

  • To enable users to use the filmstrip, set the Springboard Strip Enabled profile option (FND_USE_FILMSTRIP) to Yes.

  • If the FND_USE_FILMSTRIP profile option is set to Yes, then you can display the filmstrip as expanded by default. To do so, set the Springboard Strip Expanded profile option (FND_EXPAND_FILMSTRIP) to Yes. A user can still collapse or expand the strip on any page, and when done, this profile option is set by default for subsequent sessions of that user.

Use the Themes tab in the Appearance work area to first select your home page layout and then define its display settings. And then use the Home Page Display tab to define the display settings of your home page. Based on the home page layout you're using, the options available on the Home Page Display page may vary.

Let's see how to define the home page appearance.

  1. Activate a sandbox that has the Appearance tool in it.

  2. Click Navigator > Configuration > Appearance.

  3. Click the Home Page Display tab.

  4. In the Name column of the table, click any section name to rename it.

  5. Click the Visible field for a section to change its visibility setting. You can show or hide the section on the home page.

    • Yes: The section appears on the home page.

    • No: The section doesn't appear on the home page.

    • EL expression: The evaluation of the EL expression decides whether the section appears on the home page for specific user roles.

  6. In the Order column, use the Move Up and Move Down icons to adjust the relative positions of the sections on the home page.

  7. Click Apply.

If you're using a panel or banner layout, do these tasks:

  1. Activate a sandbox that has the Appearance tool in it.

  2. Click Navigator > Configuration > Appearance.

  3. Click the Home Page Display tab.

  4. Select one of these options to display on the home page:

    • Social: Displays social networking content, such as the number of followers.

    • Announcements: Displays employee announcements.

    • Cover image: Displays the image for the main panel or banner, which you specify on the Themes page.

    • None

  5. Specify whether to display the photo in the main panel or banner of the home page from the social network profile or from HCM.

  6. Click Apply.

You can create, edit, or delete company announcements. After you create an announcement, you can enable it to display on the home page. You can also specify which user roles can see specific announcements on the home page.

Create an Announcement

  1. Click Navigator > Tools > Announcements.

  2. Click Create.

  3. Specify the details, such as subject, start date, and end date.

  4. Select a category. If you select User-Defined, a text box appears, where you can provide additional details.

  5. Select any of these options:

    • Predefined: Select an image from the list.

    • File: Browse and select a file from your local computer.

    • URL: Enter a full URL for the image.

    Note: Make sure your image size is 776x437 px or larger to avoid image distortion.
  6. From the Visible list, select any of these options:

    • Yes: The announcement appears on the home page.

    • No: The announcement doesn't appear on the home page.

    • EL Expression: The evaluation of the EL expression decides whether the announcement will appear on the home page for a specific user role.

  7. If you have selected EL Expression from the Visibility list, click the Edit icon next to the Visibility list, enter a value or expression, and click Validate to make sure that the validation result is True. For example, you can enter the EL expression in the #{securityContext.userInRole['<role-name>']} format.

  8. Add the content in the text box. You can format your text using the formatting options.

  9. Click Save and Close.

Your changes on the Announcements page apply immediately to all users, even if you saved your changes while a sandbox is active and not yet published.

Edit or Delete an Announcement

  1. Click Navigator > Tools > Announcements.

  2. Select the announcement that you want to edit or delete.

  3. Edit the announcement details or click Delete.

Enable News and Announcements Section on the Home Page

You can use the Appearance work area to determine whether to display the News and Announcements section on the home page. The News and Announcements section on the home page displays the entire announcement along with the subject and image. But if you're using a panel or banner layout, you will see only the announcement content, not the subject or image in the panel or banner.

  1. Click Navigator > Configuration > Appearance.

  2. Click the Home Page Display tab.

  3. Select Yes for News and Announcements, and then click Apply.

    Note: If you're using a panel or banner layout, select Announcements from the home panel options, and then click Apply.

FAQs for Home Page

Why can't my users see social networking content on the panel of the home page?

That could be because of these settings in the Appearance and Structure work areas.

  • Home page display setting in the Appearance work area: Make sure you selected Social as the home page display option.

  • Visibility setting in the Structure work area: Make sure you set the Show on Navigator field for the Social page entry to Yes or add a valid EL expression. The evaluation of the EL expression determines whether social content is displayed for a user. To check that, validate the EL expression. If your validation result is True, the social content will display for your user.

Deep Links

You can use deep links to open pages without navigating through the menu structure. Deep links come in handy if you have a company website and you want users to go directly from there to Oracle Applications Cloud. For example, you can enable direct navigation to the My Team page. To see a complete list of the available deep links, use the Deep Links work area (Navigator > Tools > Deep Links). For access to this work area, you need to have the View Administration Link (FND_VIEW_ADMIN_LINK_PRIV) privilege.

How It Works

You can simply copy a URL from the Deep Links page and use it as is on your company website. You don't even need to know the URL format. If users then click your deep link URL from the company website, but aren't yet signed in to Oracle Applications Cloud, they're automatically redirected to the Sign In page.