UC_CUSTOM_ATTRIBUTES - Grouping Criteria in Executable Objects

When configuring your system it is possible to define custom attributes, such as business units and regions, that help organize your company's processes. When developers and object designers configure the objects, they can assign them these custom attributes. When the objects are executed, the corresponding tasks can be filtered out in the Process Monitoring perspective using the custom attributes as filter criteria.

As an administrator, you define the custom attributes in this Variable (VARA) object. The attributes that you specify here are then available for selection on the objects General page > Custom Attributes dropdown list. For more information, see General Page.

This Variable is supplied with system Client 0 and can be copied to other Clients and customized as needed. If the variable is defined in the system Client 0 and in a local Client, the definition of the local Client is used.

Key: Name of the object variable

You can set the variable with or without a preceding & character.

Note: Object variables are read-only and cannot be changed at runtime.
Value 1: Name of the VARA object which supplies reference values. The entries in this column must be unique withing the Variable. If there are duplicate names, only the last one is used.

You can specify static or dynamic VARA objects. If you use a static reference variable, the system uses the value of the Key column. If you use a dynamic reference variable, the system uses the value of the Result column (or the Value 1 column, if there is no result column).

Important! You can only use grouping criteria if a reference VARA object is defined. Otherwise, there are no reference values to adopt and dynamic variables cannot be resolved (incorrect login info or invalid SQL).
Value 2: Name of the grouping criterion

If the variable includes multiple entries with the same grouping criterion, the system uses the first entry that it finds (the variables are processed from top to bottom). Values of the same grouping criteria are not combined.
Restart required: Automic Web Interface (logout/login)

Assigning Grouping Criteria Executable Objects

You must define a reference value to assign grouping criteria to executable objects. To do so, use the Custom Attributes in the Metadata section of the General page of executable objects. You can define the value manually, select it from reference values or read it directly from the object variable. For more information, see General Page.

The grouping criteria can then be selected in the Process Monitoring perspective. The left area lists all reference and user-defined values of the grouping criteria which can be used to filter tasks.

Notes:

If the same grouping criterion is assigned to an object multiple times, the defined values are combined. The object variable returns all the grouping values separated by commas. When you filter tasks in the Process Monitoring perspective, you find them under each of these values.
Object variables that are derived from this variable are always inherited to the subordinate tasks, regardless of the setting that is defined in the Variables page nor the Prompt Sets page. If there is an object variable in the subordinate task that is derived from the same grouping criterion, the values are not overwritten but combined (the entries are separated by commas). For more information, see Variables Page and Prompt Sets Page.