7Home Page and Navigation

This chapter contains the following:

You can configure the Navigator and page entries 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 page entries 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 page entries.

    Note: Page entries are the work area icons, which you use to open work areas or pages.
  • Create duplicate versions of predefined page entries and edit the duplicate page entries to do specific tasks.

  • Reorder the page entries 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 Page Entries

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

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

Configuration of the Navigator and Page Entries

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

  • Create

  • Edit

  • Show or hide

  • Duplicate predefined page entries

  • 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 page entries on the home page.

You can do either of these tasks:

  • Create a group and then create a page entry in that group.

  • Create a page entry 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 Page Entries

  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 page entry.

  5. Search and select an icon for the page entry.

  6. Select the group in which you want to place the new page entry.

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

    • Yes: The page entry appears on the Navigator.

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

    • EL expression: The evaluation of the EL expression decides whether the page entry 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 page entry will actually appear on the home page.

    • Yes: The page entry 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 page entry 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 page entry doesn't appear on the home page.

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

  10. From the Mobile Enabled list, select Yes or No to specify whether the page entry 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 Page Entries

While creating a page entry or editing an existing one, you can determine what the page entry links to. Use the Create Page Entry or Edit Page Entry page to link a page entry 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 page entry 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 page entry, 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 page entry 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 page entry on the Create Page Entry or Edit Page Entry page.

Link to Dynamic URLs

You can link a page entry 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 page entries 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 page entries 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 page entries.

To link a page entry 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 page entry to a dynamic URL, when you click the page entry, the target page opens in a new browser window or tab.

Link to Static URLs

You can link a page entry to an external website or application that has a constant host, port, or context root.

To link a page entry 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 page entry 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 page entries for navigation.

You can make limited changes in certain page entries and groups.

  • Structure page entry: 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 Page Entries

  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 page entry.

    Tip: You can use the search panel on the Navigation Configuration page to find the group or page entry 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 page entry:

  • Rename a group or page entry.

  • Change the icon for a group or page entry.

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 page entry, change the group in which the page entry is placed.

  • Change the Show on Navigator property for the group or page entry.

  • Change the Show on Springboard property for the page entry.

  • Change the Mobile Enabled property for the page entry.

  • For an administrator-defined page entry, change the settings for link configuration.

  • Delete page entries that were created using the Navigation Configuration page.

  • For a predefined page entry, use Create Duplicate on the Edit Page Entry page to create a duplicate page entry. You can then edit the duplicate page entry as you want, for example, you can place the duplicate page entry 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 Page Entries 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 Page Entries 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 Page Entries

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

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 page entry 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.

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 group or page entry 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 page entries on the Navigator or the home page for specific users.

Who can see the group or page entries 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.

FAQs for Navigation

Why can't I edit some page entries and groups?

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

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

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

How can I display the missing page entries and Navigator menu items for the users?

Try these solutions:

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

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

  • Check whether the group or page entry 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 page entry, 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.

Use the Announcements page in the Announcements work area to create, edit, or delete company announcements. After you create announcements, you can enable them to display on the home page, and also specify which user roles can see specific announcements on the home page. You can also use the Announcements REST resource to create, edit, view, or delete announcements.

Create Announcements

  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. Then 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 Announcements

  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 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 don't I see infolets in the Analytics section of the home page?

That's probably because the infolet page is hidden. Change the visibility setting of the infolet page using the Home Configuration page of the Structure work area. To open this page, click Navigator > Configuration > Structure, and then click the Home Configuration tab.

How can I rename an icon for an infolet page in the page control on the home page?

You can rename an icon for an infolet page using the Home Configuration page of the Structure work area. To open this page, select Configuration > Structure from the Navigator menu, and then click the Home Configuration tab.

Why can't my users see social networking content on 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.

  • Themes setting in the Appearance work area: You're using the default theme, which has the home page with news feed layout. In this layout, the home page doesn't show social networking content.

Deep Links

You can use deep links to open pages without using menus or navigating through pages. Deep links come in handy if you want users to go directly from various locations to Oracle Applications Cloud. You can add deep links to a business intelligence report, an email notification, or a company website hosted on Oracle Cloud. For example, you can enable direct navigation to the My Team page. If users 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. 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 copy a URL from the Deep Links page and use it to create a link, for example on your company website. You can use deep links as is, to take users to a high level page, for example an overview or search page. Or, you can edit the URL so that it opens a page where the user can take action, for example to create something. For more information, refer to your product-specific documents.

URL Pattern of Deep Links

Here's a typical URL pattern of a deep link.

https://<pod-name>/fndSetup/faces/deeplink?objType=<objID>&objKey=<name1=value1;name2=value2>&action=<action>&returnApp=<returnappURL>&returnAppParams=<returnAppParameter>

To direct users to a product-specific action page, you need to add specific parameters to the deep link URL. This table describes the parameters and gives you some examples of parameter values.

Parameter Description Example of Parameter Values

pod-name

Identifies the host name.

pod.oraclecloud.com

objType

Identifies the object type, such as work areas.

Supplier

objKey

Identifies the specific object identifier.

Supplier Number

action

Specifies the action that you want the users to do on specific pages.

Here are a few things to know:

  • If you don't add any value for the action parameter, this value is considered as NONE by default. So users will be taken to a high-level page, such as an overview page or a search page.

  • If the value you added for the action parameter doesn't match with any action on the UI, or the user doesn't have the privileges to access that action, they will be taken to a high-level page.

NONE

VIEW

CREATE

EDIT

returnAppURL

Specifies the application URL where users will be automatically redirected to when they try to return to the previous page, or after they complete their task.

If you're using a third party URL, make sure the application name is registered using the Manage Integration of Additional Applications page in the Setup and Maintenance work area.

MyOracle

returnAppParams

Identifies specific parameters added to the returnAppURL.

type=photo