Record Action Item

SAIL Design System guidance available for Record Actions Make taking action on your data quick, easy, and painless with record actions. Learn how to launch actions directly from any interface to save time and get your work done faster.

Function

a!recordActionItem( action, identifier )

Displays a record action defined within a record action field or a read-only grid that uses a record type as the data source. A record action is an end-user action configured within a record type object, such as a related action or a record list action.

See also: Record action field, Record action design guidance

Parameters

Usage considerations

Icons and tooltips

• Record action items use the icon configured in the record type.
• Both the label and description for an action will appear as a tooltip.

Displaying record actions

When you configure a record action, follow the guidance below to ensure the record action displays in the component where it is referenced.

• Record action items are displayed based upon record type security, process model security, and the action visibility expression configured in the record type.
• When configuring the recordActions parameter of a read-only grid, use fv!identifier as the identifier to call the selected row ID for a related action. Make sure the grid has values for the Selection parameters properly set up, including the selectable, selectionValue, and selectionSaveInto parameters.
• Record action items that reference a related action will not appear when the identifier parameter is null or invalid.

Examples

To experiment with examples, copy and paste the expression into an interface object.

Record type object references are specific to each environment. If you copy and paste these examples into your interface, they will not evaluate. Use them as a references only.

Record action item in the Employee record

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
a!recordActionField(
  actions: {
    a!recordActionItem(
    /* For the "action" parameter below, replace the record-action reference 
     * (recordType!Department.actions.create) with a valid record-action reference in your environment.
     */
     action: recordType!Department.actions.create
    ),
    a!recordActionItem(
   /* For the "action" parameter below, replace the record-action reference 
    * (recordType!Department.actions.update) with a valid record-action reference in your environment.
    */
     action: recordType!Department.actions.update,
     identifier: rv!identifier
    )
  }
)

Displays the following:

Feature compatibility

Related Patterns

The following patterns include usage of the Record Action Item.

• Show Calculated Columns in a Grid (Formatting, Grids, Records): Display calculated values in columns in a grid.

Feedback