Property description
The selectUserObjectRelation stream selects users related to each object based on the specified user relation type. Only objects with such a user relation will be included, for example, to notify stewards when an object’s workflow state changes.
Minimal JSON
{
"key": "key",
"type": "selectUserObjectRelation",
"userRelationTypeKeys": [""]
}
Nested properties
| Property | Description | Values | Mandatory |
|---|---|---|---|
key | Unique key of the stream. | string | Yes |
type | selectUserObjectRelation | string | Yes |
userRelationTypeKeys | Array of keys of user relation types that the objects must have and which also become the target of the automation’s action. For example, when the workflow state is changed on object A, its data steward is notified. | array of strings | Yes |
keepCurrent | Determines whether the automation also selects the current object along with its user relations. For more information, see Keep current example. | boolean | No |
keepOrigin | Determines whether the object ID from which the select started is remembered. | boolean | No |
keepUserOrigin | Determines whether the ID of the originally assigned user is retained. Used mainly for actions with expressions such as Send Notification. Used to retain and select information such as the original user in a changed user object relation or the creator of a comment. | boolean | No |
Keep current example
We have object with A the following user relations:
The specified user relation type is core_steward.
"keepCurrent": true
- First automation result: [A, Steward 1, Steward 2] = We select the object and all its related users.
"keepCurrent": false
- First automation result: [Steward 1, Steward 2] = We discard [A] and only return the related users [Steward 1, Steward 2].