Skip to main content

Table of Contents

Creating navigation rules


Only available versions of this content are shown in the dropdown
Applicable to Theme Cosmos applications

Build intuitive menus that match the business requirements of your application bycreating custom navigation rules. Navigation rules help you define the structure and content of a context menu or a navigation panel.

For example, your loan management application might require the following menu:
  • Transfer
    • Transfer to user
    • Transfer to manager
  • Attach note
  • Send email

For the Send email row, you want the menu to display the customer email address as a badge next to the menu row. To prepare, you create a CustomerEmail field that stores this information.

  1. In the header of Dev Studio, click Create User Interface Navigation .

  2. On the Create Navigation tab, specify the label, context, and ruleset for the section, and then click Create and open.

    In the context field, use the same class as the section rule to which you want to add the menu.
  3. On the Editor tab, define the structure of the navigation rule by adding rows from the editor menu.

    Sample navigation rule structure and the editor menu
    The menu allows you to add and remove new menu rows.
    You can also drag menu rows into place.
  4. Double-click a navigation rule row to open the properties pane on the right side of the screen, and then, in the Type list, define the response to launch when users select the row:

    • To launch an action, select Item.
    • To launch a node that you source from a list or page group, select Item list.
    • To launch another navigation rule, select Reference.
    • To launch a custom activity, select Custom.
    • To insert a horizontal separator in place of the node, select Separator.
    • To launch a right-click menu, select Selected item.
    In the case of the sample menu, attach a single action to each row in the menu. Consequently, select Item for all rows.
  5. On the General tab, define the basic settings for the menu row.

    For the Send email row, perform the following actions:
    • In the Label field, enter Send email.
    • In Tooltip field, enter Send an email to the customer.
    • In the Badge list, select Field value, and then, in the next field, enter CustomerEmail.
  6. For the Item and Item list menu row types, on the Presentation tab, in the Selection field, define how the user selects the menu item:

    • To hide selection marks, select None.
    • To display a check box or a radio button, select Checkmark, and then add the when rule associated with the selection.
    • To allow users to select a group of items, select Group, and then provide the ID of the group.
  7. For the Item, Item list, and Selected item menu row types, on the Actions tab, click Add an action, and then select what happens when users click a menu row.

    For the Send email row, perform the following actions:
    1. Click Add an action, and then expand the action list by clicking All actions.
    2. Click Open local action.
    3. In the Flow action field, enter SendEmailCorr.

    For more information, see Adding action sets to a control.

  8. In the After action field, select the refresh strategy for the menu row.

  9. For the Item list rows, on the rule form, in the Pages & Classes tab, declare the page.

  10. On the Edit Navigation tab, click Save.

Integrate the rule into your UI:
Did you find this content helpful?

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us