Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

When using the user parameter in a JSON trigger, It is only possible to include the userID, and in some cases a user type workflow parameter.

(info) A JSON trigger action does not accept the UserName.Example:Confluence userName.

In the example below, the assign trigger action uses the Confluence userID.

Code Block
"triggers:"
[
    {"event": "on-change-state",
    "conditions":
    [
        {"state": "DraftReview"}
    ],
    "actions":
    [
        {"action": "assign",
            "approval": "Teamreview",
            "user": "5d52a37ef0f22a0da2d6f070"}
    ]}
]


In the example below, the approve trigger action specifies the approver using a Confluence userID.

Code Block
"triggers":
"remove-restrictions", "view": {"user": ["8876348538457834"]}[
    {"event": "on-change-state",
    "conditions":
    [
        {"state": "Review"}
    ],
    "actions":
    [
        {"action": "approve",
            "approval": "Teamreview",
            "user": "5d52a37ef0f22a0da2d6f070"}
    ]}
]

The "user" parameter is used in the following JSON trigger actions:

The userId can also be added to the recipient parameter in the "send-email" trigger action.

Groups

When using the group parameter in a JSON trigger, you can include either the groupName and/or the groupID.Example:and in some cases a group type workflow parameter.

In the example below, the "send-email" trigger action uses the Confluence group name  qa_reviewteam for the recipients of the custom email.

Code Block
"triggers":"
[
    {"event": "on-change-state",
    "conditions":
    [
        {"state": "DraftQAReview"}
    ],       "actions":
    [
        {"action": "remove-restrictions", "viewsend-email",
            "recipients":
            [
     			"qa_reviewteam"
            ],
            "notification": {"groupsubject": ["thisIsMyGroupName", "87128762348792347839284"]"${content.title} is in the QAReview approval state",
                "title": "${content.title} is in the QAReview approval state",
                "body": "Hello, ${content.link} in the ${content.space} space is in the QAReview approval state and needs to be reviewed for publishing"}}
    ]}
]

(info)  user also accepts valid user type workflow parameters and group alsoaccepts valid group typeworkflow parameters.For trigger actions, the "group" parameter is only currently used in the

Workflow parameters

Workflow parameters defined in the workflow can be added to some trigger actions using the enclosed in the "@" operator.

(info) For triggers, a user or group type workflow parameter is only currently valid for use in  the "send-email" trigger action as a value for "recipients".

Code Block
"triggers":
[
    {"event": "on-change-state",
    "conditions":
    [
        {"state": "Approved"}
    ],
    "actions":
    [
        {"action": "send-email",
            "recipients":
            [
                "@creator",
                "@my_project_team@",
				"@my_QA_leader@"
			],
            "notification": {"subject": "${content.title} is in the Approved published state",
                "title": "${content.title} is in the Approved published state",
                "body": "Hello, ${content.link} in the ${content.space} space is in the Approved published state"}}
	]}
]