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

PropertyDescriptionValuesMandatory
keyUnique key of the stream.stringYes
typeselectUserObjectRelationstringYes
userRelationTypeKeysArray 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 stringsYes
keepCurrentDetermines whether the automation also selects the current object along with its user relations. For more information, see Keep current example.booleanNo
keepOriginDetermines whether the object ID from which the select started is remembered.booleanNo
keepUserOriginDetermines 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.booleanNo

Keep current example

We have object with A the following user relations:

diagram

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