Trigger a UI interaction from a declarative action

Trigger a UI interaction from a declarative action to extend a page without taking ownership.

Avant de commencer

Complete the following actions:

1. Create a UI interaction in UI Builder. For instructions, see Create a UI interaction.
2. Create a declarative action and add the button to a workspace. For instructions, see Creating declarative action buttons.

Role required:

ui_interaction_admin

Provides full CRUD permissions and is inherited by admin and ui_builder_admin.

ui_interaction_developer

Provides permissions to create, read, and update but not to delete UI interactions or their inputs.

Pourquoi et quand exécuter cette tâche

UI interactions are reusable flows that combine UI elements and logic into a single unit. They help you avoid repeating the same wiring across multiple pages and make your designs easier to maintain.

A UI interaction defines what you want to happen, and how you apply a UI interaction defines how and when it happens. You can trigger UI interactions from page events in UI Builder or from declarative actions.

• Trigger a UI interaction from a declarative action if you need a button on a form or list without page customization.
• Trigger a UI interaction from a UI Builder page event to customize buttons and components on a page you own.

A UI interaction can be used instead of a UXF client action to simplify configuration since there's no need to configure add-on event mapping on a corresponding UI Builder page.

For a detailed overview of UI interactions, see UI interactions.

Procédure

1. Navigate to All > Now Experience Framework > Declarative Actions and select Form Actions, List Actions, or Related List Actions.
   Remarque :

   UI interactions are only available for form, list, and related list actions.
2. From the Action Assignment list, select an action.
   An Action Assignment record opens.
3. In the Implemented as field, select UI interaction.
   A new field named UI interaction appears.

   

4. In the UI interaction field, select a UI interaction.
   The Configure inputs dialog box opens with the UI interaction's default values.

   Inputs define the data parameters the UI interaction needs to execute.

   The fields displayed in the Configure inputs dialog box depend on the inputs configured for the selected UI interaction in UI Builder. If no inputs were defined, the Configure inputs dialog box doesn't open.

   For example, a UI interaction to create a new record may require you to define an input for the table of the new record.

   

5. Facultatif : To define a static value for an input, enter a specified value.

   For example, if the selected UI interaction to create a new record defines an input for the table of the new record and you want to pass data from the Incident [incident] table, enter incident.

6. Facultatif : Define a dynamic value for an input.
   1. Select the data icon ().
   2. Enter a value encapsulated by double opening and closing braces.

      Use values from the Action Model Definition [sys_declarative_action_model_definition] table for the action type you're configuring, such as Form, List, or Related List.

   For example, if the selected UI interaction to create a new record defines an input for the table of the new record and you want to pass data dynamically from the current table, enter {{table}}.

7. Select Save to save changes and close the Configure inputs dialog box.
8. Select Update.

Résultats

When the form or list button is selected, the specified inputs pass data to the UI interaction, and the UI interaction performs the action it was configured to do.