Record Action Item

Record Action Item

Function: a!recordActionItem()

Displays a record action defined within a record action field. 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

Parameters

Name Keyword Types Description

Action

action

Record Action Reference

A specific record action reference associated with an Appian record type, configured using recordType!{RecordName}.actions.{ActionKey}. For example, recordType!Case.actions.editCase. This action will use the display name, process model, icon, context, and visibility set in the record type object.

Identifier

identifier

Any Type

Individual record ID within the record type. Only required for related actions.

  • For entity-backed records, record ID is the primary key in the data store entity.
  • For process-backed records, record ID is the ID for the process.
  • For expression-backed records, record ID is the value returned to the ID field of the DataSubset produced by the record's source expression.

Notes

  • Record Action Items are displayed based upon record type security, process model security, and the configured action visibility expression in the record type
  • Record Action Items referencing related actions will not appear when the identifier parameter is null or invalid
  • Record Action Items use the icon configured in the record type
  • Both the label and description for an action will appear as a tooltip

Updated Record Type

Record Types created before Appian 20.1 will need to be updated to use this component. A record type can be updated via the record type designer.

Non-updated record types will not autosuggest record actions in the expression editor.

Examples

Record actions are specific to record types within your environment. If you copy and paste this example into the Expression editor, it will not evaluate in your Test Rules interface. Use it only as a reference.

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: ri!departmentId
    )
  }
)

Displays the following:

Open in Github

On This Page

FEEDBACK