Now, you can define a custom variable in ARN template JQLs and pass it’s value from a Webhook URL parameter. JQLs in the template shall use that value and produce issue data accordingly.
Let’s see the steps:
Step 1
Add/edit any type of template in ARN
In the JQL section within the template, include a custom variable in the JQL like this
project = "[projectId]" and fixVersion ="[versionId]" and labels = "[labelName]"
Step 2
When a template with such JQL is added to a rule with webhook trigger, you can pass the value of this custom variable in the Webhook URL parameter like this.
https://arn.upraise.io/arn/executewebhook/42256/b5b995e3-bb1b-4bf9-adda-efae0dda458b?versions=10000&labelName=ARN
While passing values of custom variables in the webhook URL, spaces and special characters should be replaced with relevant URL encode values.
Example : If the value of a labels field is “ARN & Roadmap Portal”, then it will be passed in the webhook URL like this:
JQL : project = "[projectId]" and fixVersion ="[versionId]" and labels = "[labelName]"
You can use any online service like this to convert the variable value in valid format.
Important points to note
Like version variable, passing value of custom variable in the Webhook URL is optional and rule would still get triggered when additional parameter is not passed.
Like version variable, you can include multiple variables for the same field in the JQL and then pass their corresponding values in the webhook URL.
Example: Value of two labels field variables (ARN & Upraise) is passed in webhook URL below
JQL :projoect="[projectId]" and fixVersion ="[versionId]" and labels in ("[labelName]","[labelName1]")You can exclude version variable altogether and only use custom variable like this :
JQL :projoect="[projectId]" and labels = "[labelName]"
Webhook:
https://arn.upraise.io/arn/executewebhook/42256/b5b995e3-bb1b-4bf9-adda-efae0dda458b?labelName=ARNYou can include multiple such custom variables in the JQL and pass their values to webhook URL
Example: Value of a labels field (ARN) and component field (Rules) is passed in webhook URL below
JQL :projoect="[projectId]" and labels = "[labelName]" and components = "[componentName]"
In case the template has multiple JQLs and the custom variable is included only in few of them, in that case, system shall ignore the custom variable passed in webhook for the JQLs in which that custom variable is not included.
In case of custom variables for user picker fields like assignee, reporter, while passing their value in the webhook URL , use their Jira account id instead of Jira user names.
Example : in below JQL, if you have to pass variable value for the Jira user “John W”, you have to use his Jira account Id.
JQL :projoect="[projectId]" and assignee="[assigneeName]"
There is no change in template preview screen and users shall not be able to pass value to custom variable in the template preview through version selector screen.