8.5.6 Using Actions to Link from a Cards Page

Create actions to link from a cards page.

A cards page functions as a colorful way to display a subset of information and then enable the user to link to more detail. To create a link from a cards page, you create an action and then select an action type. You can create an action to link from a full card, a title, a subtitle, media, or a button.

To create an action:

1. View the Cards page in Page Designer:
   1. On the Workspace home page, click the App Builder icon.
   2. Select an application.
   3. Select the Cards page.
   Page Designer appears.
2. Add an action:
   1. In the Rendering tab under Content Body, locate the cards region.
   2. Under the cards region, right-click Actions and select Create Action.
      
      Description of the illustration card_create_action.png

      A new Action appears and the Action tab displays in Property Editor.

      
      Description of the illustration card_new_action.png

      Edit the action in the Property Editor (right pane).

3. Identification, Type - Select the type of action to add to the card:
   • Button - Adds button to the card.
   • Full Card - Adds link to the full card.
   • Title - Adds link to the card title.
   • Subtitle - Adds link to the card subtitle.
   • Media - Adds link to the card media.
   You can define multiple actions of the same type. However, only button actions are rendered multiple times. For all other action types, the first TRUE display condition gets rendered, and the rest are ignored. If defining multiple action, add a display condition based on the column value and set it to check for each row.
4. Identification, Label - (Button only) Enter the text to display on the button. If button display type is icon, this text becomes the ALT text for the icon image.
5. Define the Link:
   1. Link, Type - Select the action to be performed when the specified action type is clicked. Options include:
      • Redirect to Page in this Application - Redirect to a page in the current application, with optional additional attributes for resetting pagination, setting the request value, clearing cache and setting item values, on the target page.
      • Redirect to Page in a different Application - Redirect to a page in a different application, with optional additional attributes for resetting pagination, setting the request value, clearing cache and setting item values, on the target page.

        Tip:

        Redirecting to a page in different application relies on deep linking being enabled in the target application. To enable deep linking, go to the application's Security attributes and enable Deep Linking. See Configuring Security Attributes.

      • Redirect to URL - Redirect to the target URL you specify.
   2. Link, Target - Click No Link Defined.
      The Link Builder Target dialog appears. The attributes that display differs depending upon the Link Type. When redirecting to a page, the following attributes appear:

      • Target, Page - Enter a page number or page alias, or select the page number from the select list.
      • Set Items, Name - Enter or select page items (for example, P3_ID), application items (for example, LAST_PAGE) or interactive report filters (for example, IR_EMPNO) to be set into session state.
      • Set Items, Value - Enter or select a report column (for example,&ID.), enter an application or page item (for example, &P2_EMPNO.), or enter a static value (for example, 2).
      • Clears/Reset, Clear Cache - Enter a comma-delimited list of page numbers (for example, 2,3), items (for example, P3_EMPNO,LAST_PAGE), and report settings to be cleared. To reset pagination for a report enter RP. To clear or reset interactive report settings enter CR or RR.

      • Action - Select None, Clear Regions, Reset Regions, or Reset Pagination.

        Reset Pagination resets the pagination back to the first set of records, for reports on the target page. This has the same affect as passing RP in Clear Cache.

      • Advanced: Request - Enter the request to be used.
      • Click OK to save your changes and exit the dialog.
6. Server Side Condition, Type - Select a condition type that must be met in order for this component to be rendered or processed.

   If you refer to Columns in your condition, you must specify For Each Row in order for the condition to be evaluated for each card. Otherwise, set to Once to evaluate the validations one time for the region.

7. Click Save or Save and Run Page.
   The Cards page loads.
8. Click a project to view the Maintain Project form.