Retrieve - 1 (superior) directory attribute

This service retrieves exactly one attribute (e. g., 'Description') from a group. If the requested attribute is not specified, the service continues retrieving the corresponding attribute from the superior group until a specified attribute is found or the main group is reached.

In/Out

Name

Details

Data type

In

Database name

Name of the database in which the function of type Automated task is carried out.

<Text>

In

Database language

Language the service uses for logging in to the database, for example, en for English. You can specify this in more detail, for example, en for English or en_US for English (United States). This is helpful, for example, if English (Australia) has been set in the database, but standard English (USA) has not been set.

If you want to add the country, you need to create a language constant and model it as a language in the data flow.

<Text> or <Language>

In

User login

Login name of the user that is used for carrying out the Automated task function. If no user is defined, arisservice is used.

<Text>

In

Password

Password of the user that is used for carrying out the Automated task function.

<Password>

Selected items

Exactly one attribute is retrieved from multiple groups, for example, the attribute Description/Definition. Groups can also be identified by selecting multiple models or objects. In this case, groups containing these models and objects are selected.

In

Identification

Either connect models, objects, or groups from the preselection of another object of type Human task, Automated task, or Event (process instance started), or enter GUIDs and use the Create collection operator. The group containing the selected items is identified.

<Text collection>

In

(Superior) group attribute to be retrieved

The selected attribute is retrieved (exactly one group attribute from multiple groups). If the group attribute is empty, retrieval of the attribute of the superior group continues until a specified attribute is found or the main group is reached. Either connect a group attribute type from the preselection of another object of the Human task, Automated task, or Event (process instance started) type, or enter the API name or a GUID.

<Text>

In

Use default language

If this is defined as TRUE, the default language of the database is used in case of a missing language.

<Boolean>

Out

Error

If automation errors occur, context-specific error messages are displayed indicating, for example, that ARIS server is not available.

<Text>

Out

Result

Returns either TRUE or FALSE (Boolean), depending on whether or not the service was successfully performed.

<Boolean>

Out

Values

Required attribute values are returned in a list.

<Text collection>

Retrieve exactly one (superior) group attribute