Configuring App Actions

Article Number:040487

By configuring app actions, you can copy record data to apps that you specify.
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, and then click Actions under Advanced Settings.

  4. Click Create Action at the upper left of the "Actions" screen.

  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 will set the name to "Add to Order Management App".
    Screenshot: The "Name" section outlined

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

  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 outlined You can also click Clear All to delete all of the mappings you have already configured.

  8. Configuring the Available To setting lets you limit the users for whom the created action button will be displayed.
    If necessary, delete the predefined setting (Everyone) and add the users, departments, or groups for whom you want the action to be available. Screenshot: The "Available To" section is outlined

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

  10. Click App Settings in the message displayed at the top of the screen, or click Back to App Settings displayed at the bottom left of the screen. Screenshot: "App Settings" is outlined in a message displayed at the top of the screen

  11. Click Update App at the upper right of the screen.

  12. On the "Update App" dialog, click Update App.

The Add to Order Management App action button is now displayed on the "Record Details" screen.
If Process Management settings are configured, the action button is 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 will 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 whose 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

The "New Record" screen of 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