Skip to main content

Version: 24.04

Actions

The actions attribute is used to whitelist user actions on the List and Details screens. Actions appear in a group at the top-right of the Details screen in desktop mode, or at the bottom right for mobile.

Single actions property

As of Journey Applicants 23.10, there is only one set of actions, which is defined as a single actions property in the config files. This replaces the separate txnActions and jobActions properties that existed in earlier releases.

The following actions are supported:

  • Receipt
  • Add Notes
  • View Form (Resume)
  • Recover
  • Withdraw

Actions appear on the Details screen in the order specified above, from left to right.

Receipt

The Receipt action opens a modal displaying the current Txn formReceipt. If there is more than one receipt attached to the Txn, the modal includes a dropdown list allowing the user to select a receipt to view.

Display rules

txn.job || txn.receiptUrl;

Add Notes

The Add Notes action displays a modal in which notes for the current task can be viewed and added.

tip

You can reply to an existing note from the Notes card on the Details screen. To reply to a note, click View Thread for the note.

Display rules

This action has no display restrictions.

Recover

The Recover action re-opens an abandoned Txn.

Display rules

txn.taskType !== 'Review' &&
txn.availableActions.includes('reopen') &&
txn.userLoginName === currentUser &&
txn.formStatus === 'Abandoned';

View Form (Resume)

The View Form action opens a modal displaying the form with the current Txn formUrl, and &pageId='' appended to it.

info

We send a message using a postMessage API with the following schema:

{
pageId: '';
}

Display rules

txn.taskType !== 'Review' &&
!['Completed', 'Abandoned', 'Expired', 'Submitted'].includes(txn.formStatus);

Withdraw

The Withdraw action is used to abandon a saved Txn.

Display rules

txn.taskType === 'Review' &&
txn.userLoginName === currentUser &&
!['Completed', 'Abandoned', 'Expired', 'Submitted'].includes(txn.formStatus);

Invoke Fluent Function on Single Actions

Some actions have the ability to invoke a fluent function once the action has successfully completed. Those actions are:

  • Recover
  • Withdraw

The invoke functionality can be accessed by adding the onSuccess property to the action and the appropriate invoke properties. See Invoke for more information.

space config
{
...
actions: {
Claim: {
label: 'Claim',
onSuccess: {
serviceName: 'DAO - Rerun Integrations',
versionNumber: '0.1.0',
},
},
Release: {
label: 'Release',
},
}
...
}

Actions config

{
...
actions: {
ViewForm: {
label: 'Resume',
},
Withdraw: {
label: 'Withdraw',
},
Recover: {
label: 'Recover',
},
Receipt: {
label: 'Receipt',
permissions: {
type: 'group',
value: ['Manual Review'],
}
},
},
...
}

Attributes

To review the list of supported attributes, see CurrentSpaceActions and CurrentSpaceJobActions.