See all smart values that can access and manipulate text fields, such as issue summary or comments. If I use a smart value of type: {{sprint.name}} the field returns me all the sprints that exist in the "sprint" field, including those that are already closed. Triggers, conditions, and actions are the building blocks of automation. Smart values are one of the most potent ways to do so. Special conditions and actions are available to create powerful rules that can work across complex issue relationships. Acording with the documentation, Automation JQL condition suport smart values. Can only be used when the active issue is a subtask, and can't be used to access a standard issue's parent issue. Step 2: Save the Issue generated trigger. This was something we have added since the split and I suspect that the server team has not caught up. {{deletedFieldChanged.values}} - Returns the value/values deleted. OMGYou're right. Through the dot notation you can access fields like issue type, status and custom fields (details on how you can use these to interact with Jira's REST api arehere). {{rule.actor}} - Accesses the rule actor user. {{issue.latest.description}} - Returns the status's description. Challenges come and go, but your rewards stay with you. If you've already registered, sign in. You can also use this with, . {{addedFieldChanged.fieldType}} - Returns the fieldType of the field that has changed due to addition of a value. {{environment.name}} returns the use-provided name for the environment, e.g. Added by: Jira Triggers that edit an issue, All the fields that were changed. There should be a locked field named either "Request Type" or "Customer Request Type" there. Affects version of an issue as a list. This means that when using automation, actions often need to apply, not only to the source issue that triggered the rule, but also to any issues that are related to the source issue. The three properties above can also be added to this, for example,{{issue.affectedServices.dependentServices.tier}} will return the dependent services' tiers. Keep earning points to reach the top of the leaderboard. @Daniel Ramotowski, more people seem to be interested in this functionality, as there was already a ticket open forhttps://jira.atlassian.com/browse/JIRAAUTOSERVER-212 ! Issue commented, Added by: Clone Issue Action, Create Issue Action, Create Sub-tasks Action, A list of issues that have been created in the rule, The type of event that triggered the rule such as: jira:issue_updated :issue_commented. Learn more about date smart values. Every rule starts with a trigger. Jira smart values - JSON functions See all smart values that take issue fields and convert them into JSON format. {{branch.repository}} returns information related to the repository the branch belongs to. {{version.project.key}} - Returns the project key of the project the version belongs to. There should be a locked field named either "Request Type" or "Customer Request Type" there. The legacy Insight App will reach end of service on March 31, 2022. At the same time, it would be to good to mention that it is Jira-cloud functionality only. {{attachment.author.active}}: Returnstrue if their account is active, andfalse if not. {{comment.properties. 2020-07-20T07:00:00.0+0000. {{attachment.author.timeZone}}: Returns the timezone the user is registered being in; this doesn't change dynamically based upon where the user logs in from, it is the timeZone registered in their user account. Examples of how you can use smart values to access and format items in a list, such as checkboxes and labels. You can also trigger rules to run from third party services like Bitbucket or GitHub. {{issue.parent.epic.summary}} - Returns the summary of the parent issue's epic. A representation of a release/version in Jira. Exclusive to the Approval required trigger: {{approval.initiator}} - Returns account id of initiator of request. Used with the Version created, Version updated, and Version released triggers. We use the following smart-value to sum up story points from all sub-tasks: {{issue.subtasks.Story Points.sum}}. These smart values are only available for the Pull request created, Pull request declined and Pull request mergedtriggers. You can also use this withlists. {{versions.name}}- Returns the name of the affects version. [feature/ISSUE-123-some-work, feature/ISSUE-456-more-work]. The Atlassian Community can help you and your team get more value out of Atlassian products and practices. Used with: the Create feature flag in LaunchDarkly action. Added by: Send web request with "Wait for response" checkedOn successful request, you will be able access webhook response data using the following smart values: Multiple responses can be access via the following fields: Added by: Worklogged TriggerThe worklog entry that has just been logged against an issue. A list of issues generated by a trigger that runs a JQL search (Incoming Webhooktrigger orScheduledtrigger when set to process in bulk). Jira smart values in automation rules. Whenever you want to edit a field in Jira, use the 'Edit issue' action. {{deletedFieldChanged.fieldType}} - Returns the fieldType of the field that has changed due to deletion of a value. {{versions.released}}- Returnstrueif the affects version is released, andfalseif not. A build represents the process in which files are converted into their final consumable form. Because this smart value deals with multiple items (i.e: issues can have many fix versions), it can be used with the#symbol to apply the rule to each individual fix version. Learn how to find the right Jira automation smart values for your issue fields in Jira Cloud. Learn more about using smart values with sections and lists. {{attachment. First, you need a sample from the webhook payload data. Learn more about services in Jira Service Management. Share the love by gifting kudos to your peers. If a field or value doesn't exist, it will return an empty value:{{invalid reference}}. I've not been able to find such kind of information. PROJ-213, {{issue.epic.status.name}} - Returns the epic's status, e.g. {{deployment.state}} returns the state of the deployment. Try adding.accountId after coordinator (so{{#if(issue.assignee.equals(issue.coordinator.accountId))}}. For more information on this, see Configuring a webhook later on this page. {{issue.reporter.displayName}} - Returns the issue's reporter. Accesses information for the version that triggered the rule. I am glad to learn that helped you. You can also use the quick search (keyboard shortcut is . Because this smart value deals with multiple items (i.e: issues can have many Affects versions), it can be used with the#symbol to apply the rule to each individual component. For example, when an issue is transitioned you can see what status the issue transitioned from. See all smart values that are used to insert and format numerical values using math expressions. The changed field value is available anywhere smart values are supported using the{{fieldChange}}substitution. {{addedFieldChanged.fieldId}} - Returns the fieldId of the field that has changed due to addition of a value. Learn about the concepts and procedures related to automation in Jira Cloud, Smart values allow you to access issue data within Jira. What are conditions? Learn more about user smart values. I created an automation that created a value in a short text field. For example if a rule has both a Create branch in GitHub action and a Create branch in GitLab action, the details of the most recent branch will be returned. Is there any information on the web available about the "{{#if functionality)? Select Automations - Create Rule. In automation configuration , use "Issue Created" trigger and use the log action to get the smart value below :- Accesses the value in the issue'sAffects versions field. {{issue.affectedServices.dependentServices}}- Returns the list of services that this issue's services depend on. Used with: any triggers that edit an issue. Through the dot notation you can access fields like issue type, status and custom fields (details on how you can use these to interact with Jira's REST api are here) For example, you might count how many issues have a priority of 'highest' and then send an alert. Share the love by gifting kudos to your peers. A condition refines the rule so it wont act too broadly. Or you could count how many issues have the same label, same fixVersion, etc. {{commit.message}} returns the commit message, e.g. {{repository.name}} returns the name of the repository, e.g. Added by: Webhook TriggerThis allows access to data that was sent along with the incoming webhookThe body of the Webhook request. Returns the value of the Jira Service Managements rate custom field. The only situation where this is necessary, is where subsequent actions need to have visibility of the latest state of the issue (e.g. When an epic is marked as done move all of its stories to done also. {{issue.Request Type.currentStatus.status}} - Returns the status of the current request. Available anywhere smart values are supported, to access the value of a field that has changed. Jira automation - Data Center and Server (Latest), Examples of using smart values with dates, Examples of using smart values with lists, Examples of using math expression smart values, Examples of using smart values with text strings. Set the Equals condition to true. {{branch.repository}}). In this component, we use the following settings:The email address of the reporter is captured in the smart value {{reporter.emailAddress}}, but we need to use it in a URL and therefore will use the smart value {{reporter.emailAddress.urlEncode . Get answers to your question from experts in the community, Smart value of trigger issue in automation. {{changelog.summary}} - Changelog information for theSummaryfield. Because this smart value deals with multiple items (i.e: issues can have many components), it can be used with the#symbol to apply the rule to each individual component. What goes around comes around! Your thorough reply here helped me in a completely different use case. On successful request, you will be able access webhook response data using the following smart values: The worklog entry that has just been logged against an issue. Can be combined with other date and time smart values. Share the love by gifting kudos to your peers. Here you can access any issue property. {fieldChange.toString}}- Returns the new value as displayed. View topic Examples of using math expression smart values For example, when setting multiple Fix Versions, then you can iterate over these using{{#changelog.fixVersion}}{{toString}}. I'll mention the docs discrepancies to the person that maintains our documentation. [xxx].size}}: Returnsthe file size of a specific attachment. See all smart values used to insert conditional logic such as if/equals/and statements into comments and other text fields. In this way, approval returns two different values depending on the trigger being Approval required or Approval completed - https://support . The only situation where this is necessary, is where subsequent actions need to have visibility of the latest state of the issue (e.g. {{approval}} - Returns the name of the approval. There are many ways you can edit a field. {{issue.comments.size}} - Returns the number of comments on the issue. {{flag.key}} returns the key of the feature flag. Is there a way to similar functionality in Jira-Server? {{deployment.environment}} returns information related to the deployment environment. These smart values are only available for the Deployment successful, Deployment failed and Deployment status changed developmenttriggers. Returns information related to all feature flags created in throughout the rule or branch, as a list. See all smart values that access and manipulate Jira issue data such as sprint, parent, or version. {{issue.timetracking.timespent}} - Returns the amount of time that has been logged on the issue in the Time spent field. {{commit.shortHash}} returns the truncated SHA1 hash of the commit, e.g. Approval required: accesses information when an issue that requires approval is created or updated, or when new approvers are added to an issue. Accesses the values in an issue'sAffected services field. action: Re-fetch issue (This will slow down the rule by reloading the newly created issue, as all of the data may not be ready when the rule runs.). We do not currently support accessing fields within insight objects. View the list of available triggers. Is the IF statement available for Server version? Use{{fieldChange.fromString}}and{{fieldChange.toString}}to access display values and{{fieldChange.from}}and{{fieldChange.to}}to access raw values (for a select field for example). Learn how to use automation in Confluence Cloud, and see what components and variables you can use to build rules. Accesses information relating to the sprint that triggered the rule. In progress. You can set triggers to run on a schedule or as needed. {{pullRequest.sourceBranch}} returns information related to the source branch for the pull request. {{createdBranches.name}} - returns the names of the branches, {{createdBranches.url}} - returns the URLs of the branches. Added by: Webhook TriggerThis allows access to data that was sent along with the incoming webhookThe body of the Webhook request. {{issue.parent.Epic Link}} - Returns the issue key of the parent issue's epic. I suspect not. {{rule.name}} - Returns the name of the rule that is currently running. Learn more about automation triggers. For example, PROJ-123. However, you can now change the rule actor for your automation rules. Here is an example automation rule which can be used as a templated rule for creating a Release Center Epic from any (or selected) Jira Software project versions automatically: Rule step. However sometimes the two fields holds the same p. Learn how to use automation in Confluence Cloud, and see what components and variables you can use to build rules. https://bitbucket.org/account/repo. Affects version of an issue as a list. It some places it pops up, but there is no real explanation. Automation allows you to focus on the work that matters, removing the need to perform manual, repetitive tasks by allowing your teams to automate their tasks, processes, and workflows. We do not currently support accessing fields within insight objects. . In the below example, we're sending out a notification that someone has added a comment to an issue, perhaps as a Slack message. {{commit.repository.url}} returns the repositorys URL. You could then use this to count the number of issues returned. You can specify a default value to prevent this. 2 edit issue actions that need to 'add' to the value of a field instead of overwriting it). {{approval.addedApprovers}} - Returns the set of approvers added to issue. Seeaccesing multi-value fields, Added by: This is added any time an issue is added. In the example below, we have a custom field calledTeam Leader, and the value of thefield is currentlyAlana Grant. my-awesome-repository. for a select field. Accesses information related to a file attachment on an issue. In my use case I am receiving data from an API interface and the problem is that my automation is executed based on the transition and later there are a few branches, where one of them is selected based on some value in a custom field. For example, you might count how many issues have a priority of 'highest' and then send an alert. Or .displayName if accountId doe not work as hoped. Now whenever the story points of a sub-task changes, it will be reflected in the parent issue. If you've already registered, sign in. See all smart values that can manipulate the values of items in a list. Step 1: In the top-right corner of your Jira Automation Settings, select Create Rule. An environment represents a distinct ecosystem where products are deployed to. {{version.name}} - Returns the version's name. The spacing format is mentioned in the following article: Smart-value-in-published-article-doesn-t-work. Send a daily Slack message with a list of issues still open in the Sprint. Hi John, thanks a lot for your quick response. 200, {{webhookResponse.headers}} - headers that can be accessed with dot nation, {{webhookResponse.body}} - body that can be accessed with dot nation, {{webhookResponses}} - list of responses made when list operations. {{pullRequest.destinationBranch.repository}} returns information related to the destination branchs repository. Thisshould not be usedsince it requires an expensive reload of issue data. What I didn't notice, is that I entered the value: {{issue.sprint.name}}. Step 3: Set up the condition like this: Change the field's value to Issue Type. You can access an insight field's full name, key, or summary through the following smart values: You can access a Tempo Account field's properties through the following smart values: To test what your smart value returns, use the, The active issue. it is not supported in server version now. {{assignee.displayName}} - Returns the assignee, {{reporter.displayName}} - Returns the reporter, {{issueType.name}} - Returns the issue type, {{resolution}} - Returns the resolution status, {{created}} - Returns the date the issue was created, {{updated}} - Returns the date the issue was updated, {{Story Points}} - Returns the story points for the issue (company-managed Jira Software), {{Story point estimate}} - Returns the story points for the issue (team-managed Jira Software). The "Request Type" prefix may be"Customer Request Type" in older instances of Jira. You can check this by navigating to the "Custom fields" page in theglobal admin section. We select the exact field we are listening out for, in this case story points. global admin section. Returns the issue's comments. For example, {{attachment.first.size}} will return the file size of the first attachment. Summary Automation for Jira has a trigger that reads incoming webhooks, both in on-premises and cloud intances. {{issue.parent.priority.name}} - Returns the priority of the subtasks's parent issue. Challenges come and go, but your rewards stay with you. General triggers These triggers can be used across all Jira products. They enable customizing automation actions to be useful for your team and your customers. Create an issue and update the Insight custom field with the object that have User attribute updated with portal only customer , and also add the portal only customer as reporter. 4877576. To test what your smart value returns, use themanual triggerwithlog actionand the result displays in theaudit log. See, This allows access to data that was sent along with the incoming webhook, Added by: Send web request with "Wait for response" checked. If you've already registered, sign in. : To do,In progress, orDone). Learn how to use automation in Confluence Cloud, and see what components and variables you can use to build rules. That looks a little odd. You're on your way to the next level! You must be a registered user to add a comment. Or you could count how many issues have the same label, same fixVersion, etc. I would like to use this in a reminder email, that is sent to two people, using as source two different people fields. For more information on when issues is available, seeRun a rule against issues in bulk. {{issue.created}} - Returns the issue's creation date. {{version.id}} - Returns the version's ID. A pull request represents proposed changes before they are integrated into an official project. Used to access the values in an issue'sFix Versionsfield. To get a concrete example, let's consider the payload below: Here are some examples of ways to test the JSON path to get the right data in the smart values, so you can get it right on your first try! You could then use this to count the number of issues returned. {{issue.resolution}} - Returns the issue's resolution. {{attachment.author}}: Returnsthe user who added the attachment. There is a feature request for it though - check outAUT-648. {{issue.affectedServices.tier}} - Returns the tiers of the issue's Affected services. But it looks like functionality for the Jira cloud version. {{issue.watchers.emailAddress}} - Returns the watcher's email address. Learn more about configuring time tracking. You're on your way to the next level! {{branch.repository.url}} returns the URL, e.g. twoEdit issueactions that need toaddto the value of a field, instead of overwriting it. Smart values in Jira automation.