Configuring app actions

Article Number:040487

By using app actions, you can copy record data to specified apps or fields.
The following sections explain how to configure and use an app action.

Setting up an app action

This section describes how to set up an app action.
In this example, we will configure an action to copy customer information from a customer list app to an order management app.

  1. Open the "Customer List" app.

  2. Click the App settings icon (the gear-shaped icon) at the upper right of the View screen.
    Screenshot: The "App settings" icon is highlighted

  3. On the App settings screen, select the App settings tab, then click Actions under Advanced settings.

  4. On the Actions screen, click Create action.

  5. In the Name section of the Create action screen, enter the name that you want to be displayed for the action button on the Record details screen.
    In this example, we'll set the name to "Add to Order Management App".
    Screenshot: The "Name" section is highlighted

  6. In the Target section, select the app you want to copy data to.
    In this example, we'll select the "Order Management" app. Screenshot: The "Target" section is highlighted

  7. For Field mappings, specify the source field and the destination field for copying data.
    Fields placed in a table are displayed in the following format: "Table name > Field name".
    Screenshot: The "Field mappings" section is highlighted You can also click Clear all to delete all of the mappings you have already configured.

  8. Under Available to, specify which users can see the action button you create.

    • To make the action button visible to all users, leave Everyone selected.
    • If you want the action button to be displayed for only certain users, delete the predefined setting (Everyone) and add the users, departments, or groups that you want to see the action button. Screenshot: The "Available to" section is highlighted
  9. Under Available when, specify the conditions for when to display the action button.
    You can specify field values, process management statuses, or assignees as conditions.
    If you want the action button to be displayed on all records, leave All records selected. Screenshot: The "Available when" setting is highlighted To add a condition, first click the Add a condition icon (the plus sign-shaped icon). Then, specify an additional condition and select either All conditions are met or Any conditions are met.

  10. Click Save at the bottom right of the screen.

  11. Click App settings in the message displayed at the top of the screen, or click Back to app settings at the bottom left of the screen.

  12. Click Update app at the upper right of the screen.

  13. On the Update app dialog, click Update app.

The "Add to Order Management App" action button will now be displayed on the Record details screen.
If process management settings are configured, the action button will be displayed next to the process management action button.

Adding a record using an app action

Clicking an action button on the Record details screen creates a new record with the necessary information copied to it.
As an example, we'll use the "Add to Order Management App" action button that was created in the section above to copy data from the "Customer List" app to the "Order Management" app.

  1. Open the "Customer List" app.

  2. Open the Record details screen of the record that has the data you want to copy.

  3. Click the "Add to Order Management App" action button.
    Screenshot: An action button is displayed on the "Record details" screen

A new record in the "Order Management" app will open, and the destination fields will be filled in with data copied from the "Customer List" app record. Screenshot: Example of using an app action to add a record