Skip to main content

Update Augmented Attribute using Action Flows

The Update Augmented Attribute Action Flow module allows you to update legacy record-based augmented attributes and enhanced augmented attributes which are defined in Data Model Tables.

Before you begin

If you want to use the OAuth connection method for your Action Flow, your OAuth app must have the following scopes assigned to it:

  • knowledge-models.augmented-attributes:update

  • knowledge-models:read

Updating single augmented attribute

You can update a single augmented attribute within your Studio package:

  1. Click New Asset - Action Flow

    Add_action_flow_1.png

  2. Click Add module and from the list select Celonis > Update Augmented Attribute.

  3. Select the connection type you want to use for your module. Choose from the following:

    • Celonis user - this connection type will reflect your existing data permissions and allow you to query data to which you already have access.

      Note

      You must have Data integration service permission to use this connection method. See Data Integration permissions.

      1. Give your connection a name.

      2. Click Save.

    • Celonis Application Key -This connection type will reflect the data permissions granted to the selected Application Key and allow you to query data to which you may not otherwise have access.

      1. Give your connection a name.

      2. In a separate window, create an application key and copy it. See Application keys.

      3. Paste the application key and click Save.

    • Celonis OAuth Client Credentials this connection type will reflect the data permissions granted to the selected OAuth app and allow you to query data to which you may not otherwise have access.

      1. Give your connection a name.

      2. In a separate window, create the OAuth application application Client ID and Secret and copy it. See Adding OAuth client to Celonis Platform.

      3. Paste the Client ID and Secret here and Save.

  4. Select the Knowledge Model that contains augmented attributes you want to update.

  5. Select the augmented attribute you want to update.

    The list shows legacy augmented attributes, which are record-based, and enhanced augmented attributes which are defined in Data Model tables.

  6. Select the new value for the augmented attribute.

    If you have defined possible values in the Knowledge Model definition, you can choose a value from the dropdown. If that is not the case use the "map toggle" to put another input either directly or using a placeholder.

  7. Choose single update as the execution type.

  8. In the Identifier section, define the values of the primary key columns of the selected Data Model table.

  9. Click OK.

You can now add another module of your choice to which your configured Update Augmented Attribute module will pass on updated data.

Updating multiple augmented attributes

  1. In Studio, go to your package and click New asset  > Action Flow.

  2. Click Add module and from the list select Celonis > Update Augmented Attribute.

  3. Select the connection type you want to use for your module. Choose from the following:

    • Celonis user - this connection type will reflect your existing data permissions and allow you to query data to which you already have access.

      Note

      You must have Data integration service permission to use this connection method. See Data Integration permissions.

      1. Give your connection a name.

      2. Click Save.

    • Celonis Application Key -This connection type will reflect the data permissions granted to the selected Application Key and allow you to query data to which you may not otherwise have access.

      1. Give your connection a name.

      2. In a separate window, create an application key and copy it. See Application keys.

      3. Paste the application key and click Save.

    • Celonis OAuth Client Credentials this connection type will reflect the data permissions granted to the selected OAuth app and allow you to query data to which you may not otherwise have access.

      1. Give your connection a name.

      2. In a separate window, create the OAuth application application Client ID and Secret and copy it. See Adding OAuth client to Celonis Platform.

      3. Paste the Client ID and Secret here and Save.

  4. Select the Knowledge Model which contains augmented attributes you want to update.

  5. Select the augmented attribute you want to update.

    The list shows legacy augmented attributes, which are record-based, and enhanced augmented attributes which are defined in Data Model tables.

  6. Select the new value for the augmented attribute.

    If you have defined possible values in the Knowledge Model definition, you can choose a value from the dropdown. If that is not the case use the "map toggle" to put another input either directly or via a placeholder.

  7. Chose batch update as the execution type:

  8. Define the values of the primary key columns of the selected Data Model table.

  9. Click OK.

  10. For the batch update to work, add additional modules to your Action Flow setup:

    • Array aggregator which allows you to merge several bundles into one single bundle

    • Celonis module, like Get Rows, which will allow you to batch update your augmented attribute.

  11. Save the Action Flow and run it.

Related topics