Working with Other PeopleTools Features in Conditional Navigation

This topic describes how search results and related content are handled in the conditional navigation feature.

The conditional navigation feature takes into consideration the links that are displayed when a user uses global search. If conditional navigation is configured, the content references displayed on clicking the links on the Search Results page would be as per the conditional navigation guidelines on the search feature.

Consider the following scenario to understand how conditional navigation is implemented for classic display mode and fluid display mode.

  • In Classic A content reference, Fluid A is configured as an alternate content reference.

    Classic A is indexed, but not Fluid A.

  • Classic B content reference is not configured for any alternate content reference.

    Classic B is indexed.

  • Fluid C content reference is not configured for any alternate content reference.

    Fluid C is indexed.

For example, a user searches on the word “Employee” and assume that the search hits are on Classic A, Classic B, and Fluid C.

User Searches in Fluid Display Mode on Any Device

User sees three search results: Fluid A, Classic B, and Fluid C.

Fluid A content reference is displayed rather than Classic A because the user is using fluid display mode.

User Searches in Classic Display Mode on Any Device

Users sees two search results: Classic A and Classic B.

Classic A content reference is displayed rather than Fluid A because the user is using classic display mode.

The conditional navigation feature supports the related content features.

Authorization Service

In a system that is not configured for conditional navigation, the related content framework checks for authorization at the level of the input content reference, but in a system that is configured for conditional navigation, the authorization is checked at the level of resolved content reference.

Note: In a system configured for conditional navigation, you must invoke the authorization service for alternate content references.

See Understanding Developing and Invoking the Security Authorization Service for invoking authorization service.

Suppressing Duplicate Related Actions

Conditional navigation supports the mapping of multiple content references to a single content reference. In such a scenario, related actions configured for these content references will appear multiple times because of the mapping to a single content reference. In conditional navigation, duplicate related actions are suppressed within the context of a folder for fluid.

For example, if related actions are configured on a fluid page for three classic content references — ClassicCREF1, ClassicCREF2, and ClassicCREF3 — and if these three content references are mapped to a single fluid content reference (NUICREF1), in fluid mode, the duplicate related actions are suppressed and the related actions menu will display NUICREF1 only once in the context of a folder. In classic mode, the duplicate related actions are not suppressed and are shown as ClassicCREF1, ClassicCREF2, and ClassicCREF3.

Passing Service URL Parameters to Alternate Content References

Note: The following information is applicable to fluid mode only.

When you map multiple classic content references with related actions configured to a single fluid content reference, the Service URL Parameters of the first content reference are passed to the mapped fluid content reference. For example, three classic content references — ClassicCREF1, ClassicCREF2, and ClassicCREF3 — with configured related actions are mapped to a single fluid content reference (NUICREF1), by default, the Service URL Parameters of ClassicCREF1 are passed to NUICREF1.

If you want to pass the Service URL Parameters of ClassicCREF2 or ClassicCREF3 to NUICREF1, you can use the PTCS_SUPPRESS service parameter. However, multiple related actions with the same label will be displayed. To avoid this and display the service label instead of the content reference label, you can configure an additional service parameter, PTCS_LABELTYPE.

To define and configure the related content service:

  1. Open the service definition that you want to modify, for example, EF_HR_EE_MAR_STATUS (PeopleTools > Portal > Related Content Service > Define Related Content Service).

  2. In the Service URL Parameters group box:

    1. Enter PTCS_SUPPRESS in the Parameter Name field.

    2. Enter a description.

  3. In the Service URL Parameters group box:

    1. Enter PTCS_LABELTYPE in the Parameter Name field.

    2. Enter a description.

    Image: Define Related Content Service page with service parameters

    This example illustrates adding two service parameters to the service definition.

    Define Related Content Service page with service parameters
  4. Save the service definition.

  5. Edit the service configuration of the modified service definition (PeopleTools > Portal > Related Content Service > Manage Related Content Service).

  6. On the Configure Service page, for the PTCS_SUPPRESS parameter:

    1. Select Fixed Value in the Mapping Type column.

    2. Enter N in the Mapping Data column.

  7. For the PTCS_LABELTYPE parameter:

    1. Select Fixed Value in the Mapping Type column.

    2. Enter S in the Mapping Data column.

    Image: Configure Service page

    This example illustrates configuring the PTCS_SUPPRESS service.

    Configure Service page with service parameters
  8. Save the configuration.