Skip to main content

Celonis Product Documentation

Update Augmented Attribute using Action Flows

This module allows you to update legacy record-based Augmented Attributes and enhanced Augmented Attributes which are defined in Data Model Tables.

Updating single Augmented Attribute

  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. Add a connection to the module using one of the following methods:

    Note

    For creating and testing an Action Flow, the "Celonis User Connection" might be the fastest and easiest choice to get started.

    For unattended full automation use cases we recommend to switch to the "Celonis App Key Connection". This ensures that the automation runs stable even if a specific user is removed from the team.

    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.co

    • Celonis Application Key

      The Celonis App Key connection 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 user

      The Celonis User connection will reflect your existing data permissions and allow you to query data to which you already have access.

  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. 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. Add a connection to the module using one of the following methods:

    Note

    For creating and testing an Action Flow, the "Celonis User Connection" might be the fastest and easiest choice to get started.

    For unattended full automation use cases we recommend to switch to the "Celonis App Key Connection". This ensures that the automation runs stable even if a specific user is removed from the team.

    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

      The Celonis App Key connection 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 user

      The Celonis User connection will reflect your existing data permissions and allow you to query data to which you already have access.

  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:

    Screenshot_2025-02-17_at_10_11_23.png

  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 bundleArray aggregator

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

  11. Save the Action Flow and run it.