Add a Navigation Action

The Actions palette contains a Navigation section that provides actions for navigating to the previous page, a specific page in the application or an external URL.

When you add a Navigate action to an action chain to navigate to a specific page in your app, after you select the target page you can specify an input parameter to specify the id of a record.

To add a navigation action to an action chain:

  1. Open the Actions editor for Page.
  2. Click the action chain in the list to open it in the Action Chain editor.
  3. Drag an action from the Navigation section of the palette into the action chain.

    The Navigation section contains Navigate, Navigate Back and Navigate to URL actions

    Description of action-chain-navigation-actions.png follows
    Description of the illustration action-chain-navigation-actions.png

    You can drag the action onto the Add icon ( Add icon ) in the action chain, and typically this action will be the final action in the chain. The property editor opens when you add the Navigate to Page action to the action chain.

  4. Specify the details of the page or URL in the property editor, if required. If you add the Navigate Back action you do not need to specify any details.. If you add theNavigate to URL action you need to provide the URL in the property editor. If you add the Navigate action you need to perform the following steps.
    1. Click Select Target in the property editor.
    2. Select the context of the target in the Select Target window.

      The targets you can select will depend upon the context of your action chain. The target for a Navigate action can be one of the root (shell) pages of the application, another page in the current flow, or a different flow that is defined in the current page. One or more of these options might not be valid targets for your action chain. After you choose the context of your target you can choose from the available targets in that context.

      Description of action-chain-editor-selecttarget-db.png follows
      Description of the illustration action-chain-editor-selecttarget-db.png
    3. Select a page in the list. Click Select.

      If the page you select requires an input variable you will need to map a page variable to the action’s Input Parameter.

    4. Type a name for the action in the Id field in the property editor.

      When the action is selected on the canvas, you edit the action’s properties in the property editor.

      Description of action-chain-editor-navtopage.png follows
      Description of the illustration action-chain-editor-navtopage.png
    5. Optional: If the page requires input parameters, click Assign in the Input Parameters section to open a window to map the variable for the input value to the action’s parameter. Click Save.

      In the window, you map Sources to Targets by dragging the variable in the Sources pane onto the parameter in the Target pane. You can click the parameter name to view the expression for the mapped variable.

      Description of action-chain-map-pageinputparameters.png follows
      Description of the illustration action-chain-map-pageinputparameters.png

      If a suitable variable does not exist, you can create the variable in the Variables editor and edit the action later.