Versions Compared

Key

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

Users

When using the "user" parameter in a JSON trigger, It it is only possible to include the userIDand in some limited cases a user type workflow parameter.(info) A

JSON trigger

...

actions does not accept the Confluence userName.

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

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

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

Code Block
"triggers":
[
    {"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 "recipients" 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 groupIDand in some cases group type workflow parameter.

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

Code Block
"triggers":
[
    {"event": "on-change-state",
    "conditions":
    [
        {"state": "QAReview"}
    ],     "actions":
    [
        {"action": "send-email",
            "recipients":
            [
     			"qa_reviewteam"
            ],
            "notification": {"subject": "${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"}}
    ]}
]

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"}}
	]}
]
Info

If adding the JSON trigger using workflow builder there is no need to include the opening "triggers": JSON markup notation, since it will be added by workflow builder.