Data group action

With a data group action, data records can be inserted or existing data records can be edited or deleted. Data group actions can only be configured if they are connected to a fully configured data group event handler.

Create data group action

The data group action can be found in processes in the "Elements" area. It belongs to the "Actions" category. It can be dragged and dropped to the desired location in the process chain and then configured. General information about creating process items can be found here.

Once you have created the data group action on the workspace, open the properties dialog by double-clicking on the element.

General

The title and description of the data group action can be edited here.

Multilingual

In each case, a dialog opens where the text can be entered in multiple languages. Click here for more information.

Action

Add data record

A data record is added to the target data group with this option.

Change data record

A data record in the target data group is modified with this option.

Delete data record

A data record in the target data group is deleted with this option.

Activate subsequent events

With this option you can decide whether a data group event should be triggered in the target data group.

Example:

Data group A possesses a data group event, which writes a data record to data group B when a data record is created. If data group B also contains a data group event, which writes a data record to data group C when a data record is created, the data group event in data group B will only be triggered if the "Activate subsequent events" option is active in data group A. Please note that unintended infinite loops can also be created with the "Activate subsequent events" setting.

Click "Next".

Target data group

You can search for the name or the GUID of an application here.

Once you have selected a target application, the data groups it contains are displayed on the right-hand side of the dialog. Select the desired data group there and click "Next".

Field assignment

The fields from the source data group can be assigned to the fields of the target data group here. If the data group action is triggered, it transfers the data according to the assignment created here.

Goal

"Field" column

The names of the target data fields are listed here.

"Type" column

Displays the data type.

"Assignment" column

Displays whether a source data field has been assigned and if so, which one.

Source

“Field/Value” column

The names of the source data fields are listed here.

"Type" column

Displays the data type.

Assign / Cancel assignment

Assigns the data fields selected in each list to one another or removes an existing assignment, respectively.

User-defined value

Opens a dialog where a specific value can be defined that will be written to a data field of the target data group every time the data group action is performed. Assign the user-defined value as usual to the field of your choice in the target data group. Once the value has been defined, it will be listed in the Source table.

Add value from query

Opens a dialog where a data group can be filtered and the result can be transferred to the target data field.

Value from query

Select the application and data group whose values should be queried.

Click "OK" to save changes and close the dialog again.

If a target data field with the file data type is assigned another file data field with a value from a query or from the processing context, the options button is displayed in the corresponding line in the field assignment, which opens the dialog for setting the options when saving files.

Click "OK" to complete the configuration of the data group action.

More information

Processes module

Create and manage processes

The areas of the "Processes" module

Creating and connecting elements

Analyze log file

Options

External data in processes

Java classes in process objects