However sometimes the two fields holds the same person, resulting in an email with twice the same name. You could then use this to count the number of issues returned. Learn more about date and time smart values. Properties are frequently used by add-ons and integrations to store values, e.g. These smart values are only available for the Pull request created, Pull request declined and Pull request mergedtriggers. This example returns an issue's previous type, after it has been changed. Otherwise, register and sign in. Thanks for sharing the link back in this question, it might help others in future! {{build.name}} returns the name of the build, e.g. Seeaccesing multi-value fields.Properties for versions include:name, description, archived, released, releaseDate. {{attachment.author.active}}: Returnstrue if their account is active, andfalse if not. They kick off the execution of your rules. Keep earning points to reach the top of the leaderboard. Get answers to your question from experts in the community, Automation JQL condition: using smart values. {{issue. For example if a rule has both a Create branch in GitHub action and a Create branch in GitLab action, {{createdBranches}} will return the values of both branches as a list. The active issue. for a select field. For example, you can use the following smart values to send a Slack message that includes the issue key and issue summary: { {issue.key}} { {issue.summary}} Check out how we use smart values in our Jira automation template library. For example, you might count how many issues have a priority of 'highest' and then send an alert. If you've already registered, sign in. {{version.archived}} - Returnstrue if the version is archived, andfalse if not. {{issue.epic.key}} - Returns the epic's key, e.g. It may contain, for example, branches and tags names.This value is optional and may be an empty list. {{fieldChange.from}}- Returns the previous raw value, e.g. Or you could count how many issues have the same label, same fixVersion, etc. {{pullRequest.updatedDate}} returns the time (UTC) when the pull request was last updated (created, declined or merged), e.g. In the dropdown menu, you simply choose the field you want to work on, including custom fields and then edit. For example, when setting multiple Fix Versions, then you can iterate over these using{{#changelog.fixVersion}}{{toString}}. When an issue is raised without an assignee, auto-assign to whoever created it. Can be combined with other date and time smart values. Triggers will listen for events in Jira, such as when an issue is created or when a field value is changed. {{pullRequest.destinationBranch}} returns the name of the destination branch, e.g.master, {{pullRequest.destinationBranch.url}} returns the URL of the destination branch, e.g. A branch represents an independent line of development. TEST-123-some-feature, {{repository.url}} returns the absolute URL of the repository, e.g. {{version.description}} - Returns the version's description. These can be combined with other user smart values. {{fieldChange.to}}Returns the new raw value, e.g. {{issue.Story Points}} - Returns the issue's story point estimate (company-managed Jira Software Cloud only). @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 ! You can access all fields of the Epic. If a field or value doesn't exist, it will return an empty value:{{invalid reference}}. {{issue.security.name}} - Returns the security level name. {{changelog.issuetype}} - Changelog information for theIssue type field. 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. {{deletedFieldChanged.valueIds}} - Returns the id/ids of value/values deleted. Used to access the values in an issue'sFix Versionsfield. Note that repository contains additional nested smart values. Now whenever the story points of a sub-task changes, it will be reflected in the parent 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, A list of issues generated by a trigger that runs a JQL search (, trigger when set to process in bulk). You must be a registered user to add a comment. 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. Refers to the original issue when you branch the chain. Understand the general concepts and best practices of automation in Atlassian Cloud products. Learn more about using smart values with sections and lists. Smart values - syntax and formatting; Jira smart values - issues; Jira smart values - conditional logic; . Some issue properties are more complex, and theyve been described in their own sections on this page. 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 you please assist us in working out the following issues? {{version.released}} - Returnstrue if the version is released, andfalse if not. What goes around comes around! A deployment represents the process in which a product is released in an environment. {{issue. Affects version of an issue as a list. Triggers can be set to run manually, based on a condition you set or scheduled. {{commit.hash}} returns the SHA1 hash of the commit, e.g.4877576951f3eda43625d3345058e702dad3df0d. Seeaccesing multi-value fields.Properties for versions include:name, description, archived, released, releaseDate. Learn more about date and time smart values. ISSUE-12: Fix bugs, {{pullRequest.url}} returns the absolute URL of the pull request, e.g.https://bitbucket.org/pull-request/182. We use the following smart-value to sum up story points from all sub-tasks: {{issue.subtasks.Story Points.sum}}. We will ensure the story points of the parent and sub-task always remain in sync. You can also use this withlists. If a customer has not responded to an issue in 5 days, close the issue and leave a comment. Smart values in Jira automation. {{issue.comments.reverse.body}} - Returns the issue's comments, in reverse order. These smart values can only be accessed through other root keys (e.g{{deployment.environment}}). 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. Fix versions of an issue as a list. {{flag.key}} returns the key of the feature flag. As ever, test this rule out in your own instance. {{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. Returns the value of the Jira Service Managements scale custom field. Wonderful :). {{issue.timetracking.timespent}} - Returns the amount of time that has been logged on the issue in the Time spent field. Acording with the documentation, Automation JQL condition suport smart values. In this template, we show you how to sum up the story points of all sub-tasks then update the parent issue with this value. This can be obtained by sending a webhook to a webhook test site (like https://requestbin.com) or by intercepting the message by enabling Jira's HTTP access logs and HTTP dump from the System > Logging and Profilingscreen and then checking the request data. Note that this will return an encoded URL; everything after bitbucket.org/ will look different from what you see here. {{pullRequest.sourceBranch}} returns information related to the source branch for the pull request. {{issue.duedate}} - Returns theissue's due date. Note that this will return an encoded URL; everything after bitbucket.org/ will look different from what you see here. {{fieldChange}}only contains the first changed value. You could then use this to count the number of issues returned. Smart values allow you to access and manipulate a wide range of issue data within your site. Triggers can be set to run manually, based on a condition you set or scheduled. The URL to access the issue. {{issue.fixVersions.releaseDate}} - Returns the fix version's release date. Added by: Webhook TriggerThis allows access to data that was sent along with the incoming webhookThe body of the Webhook request. Can be combined with other date smart values. The trigger for automation is starting a new sprint (trigger = start sprint). Prints the issue key and its status (e.g. They enable customizing automation actions to be useful for your team and your customers. {{branch.repository.url}} returns the URL, e.g. https://bitbucket.org/{6d6d87be-bdc2-42b5-ad8f-85cb915abc38}/{80c30dd6-2d2f-401c-ac33-8317adbc509d}/addon/pipelines/deployments#!/deployments/{888ba48c-0011-5a46-9d59-8da313851383}. Accesses the values in an issue'sAffected services field. Connect your source code management, build or deployment tool to use these smart values. https://bitbucket.org/commit/121212, {{commit.isMergeCommit}} returns True if commit is a merge commit, {{commit.timestamp}} returns the timestamp (UTC) the commit was created. These smart values can only be accessed through other root keys (e.g. To get a property in it, we should use{{webhookData.someValue.childValue}}. {fieldChange.fromString}} - Returns the previous value as displayed. For example,jira:issue_updated :issue_commented. [property]}} {{approval}} - Returns the name of the approval. Connect thousands of apps for all your Atlassian products, Run a world-class agile software organization from discovery to delivery and operations, Enable dev, IT ops, and business teams to deliver great service at high velocity, Empower autonomous teams without losing organizational alignment, Great for startups, from incubator to IPO, Get the right tools for your growing business, Docs and resources to build Atlassian apps, Compliance, privacy, platform roadmap, and more, Stories on culture, tech, teams, and tips, Training and certifications for all skill levels, A forum for connecting, sharing, and learning. Learn more about using smart values with sections and lists. Affects version of an issue as a list. Used with: any triggers that edit an issue. Used with the Version created, Version updated, and Version released triggers. To prevent this, I thought let's use this construct: {{#if(issue.assignee.equals(issue.coordinator))}} Name 1,{{/}}. {{issue.parent.key}} - Returns the issue key of the subtask's parent issue. Create and configure Jira automation rules, Branch automation rules to perform actions on related issues, Issue data (Automation format) payload for Send Web Request, Issue data (Jira format) payload for Send Web Request action, Limitations in team-managed projects for automation rules, Permissions required for Jira Cloud automation rules, Test a Jira automation rule using the Manual trigger, Transfer Jira automation rules from one user to another, Differences between Automation in Jira Server and Jira Cloud, Examples of using math expression smart values, Examples of using smart values with dates, Examples of using smart values with lists, Examples of using smart values with text strings, Use Jira automation rules to modify issues, Convert wiki markup to HTML or plain text in Jira automation, Move an issue to another project using automation, Version created, Version updated, and Version released triggers. {{comment.visibility.type}} - Returns the comment restriction type if any, e.g. Can be combined with other date and time smart values. Field value changed Available in Server Lite: No This is how you would return multiple responses using the smart value: Accesses information for a worklog entry that has just been logged against an issue. Properties are frequently used by add-ons and integrations to store values. Learn more about user smart values. This example returns the new value of an issue'sSummary field after it has been changed. Here, we choose the Issue fields' condition and clarify that the issue type we are looking out for is a sub-task. If it has a time you may need to strip off the time part for the comparison by changing the format: {{triggerIssue.customfield_10043.jqlDate}}. 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. {{pullRequest.title}} returns the title of the pull request, e.g. Jira Software Questions Smart value of trigger issue in automation Smart value of trigger issue in automation Eliyahu Klein Jan 09, 2023 Hi, I created an automation that created a value in a short text field. We select the exact field we are listening out for, in this case story points. Used to access information about an issue's epic. If this issue is a sub-task, then parent refers to the parent issue. {{branch.repository}}). {{issue.parent.priority.name}} - Returns the priority of the subtasks's parent issue. Returns a list of issues from a JQL search caused bythe Lookup issues action. Learn more about automation triggers. OMGYou're right. Use an IDE like Visual Studio Code to find the path. {{comment.created}} - Returns the date and time of the comment. {{comment.properties. The Atlassian Community can help you and your team get more value out of Atlassian products and practices. {{createdBranch.repository.url}} - returns the repositorys URL. E.g. I would like to use this in a reminder email, that is sent to two people, using as source two different people fields. For example, if the epic has a custom field calledInitiative, then{{issue.epic.Initiative}} will return the value in the Initiative field. {{comment.properties}} - Accesses any comment property. 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 better to use this than name as it cannot be changed. 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, A list of issues generated by a trigger that runs a JQL search (, trigger when set to process in bulk). Understand the general concepts and best practices of automation in Atlassian Cloud products. Added by: Jira Triggers that edit an issue, All the fields that were changed. Similar to{{issue. { {issue. If this issue is in an Epic, then epic refers to the Epic issue. You can specify a default value to prevent this. If a condition fails, the rule will stop running and no actions following the condition will be performed. Learn how to use automation in Confluence Cloud, and see what components and variables you can use to build rules. The legacy Insight App will reach end of service on March 31, 2022. {{attachment.mimeType}}: Returnsthe file format of the attachment. They can add significant power and complexity to your rules. Smart values are variables that you can use in automation action configuration parameters. {{versions.releaseDate}}- Returns the affects version's release date. Or .displayName if accountId doe not work as hoped. {{attachment.author.displayName}}: Returnsthe name displayed in your Jira instance. {{issue.fixVersions.description}} - Returns the description of the fix version. Examples of how you can use smart values to set the numerical value of an issues field in your Jira automation rules. Create a sample project and follow all of the breadcrumbs in the audit log of the rule details. See all smart values related to accessing Jira project details. {{pullRequest.state}} returns the state the pull request is in - Open, Merged, or Declined. {{versions.archived}}- Returnstrueif the affects version is archived, andfalseif not. You can also use this with, . Any property used with the{{issue}}smart value can also be used with{{createdIssue}}. {{commit.repository}} returns the information related to the repository. General triggers include: Field value changed - when a field value is changed Form submitted - when forms attached to an issue are submitted {{issue.fixVersions.released}} - Returnstrue if the fix version is released, andfalseif not. If this issue is a sub-task, then parent refers to the parent issue. {{build.refs}} returns the refs of the build, e.g. Platform Notice: Cloud, Server, and Data Center - This article applies equally to all platforms. Exclusive to the Approval completed trigger: {{approval.approver}} - Returns approvers account id. Accesses time tracking estimates. {{version.id}} - Returns the version's ID. Examples of using smart values with dates. {{issue.affectedServices.tier}} - Returns the tiers of the issue's Affected services. For example, the smart value{{now.plusDays(5)}} references the current time and adds 5 days to it, while {{issue.summary}} will print off the summary of the issue. - Any ideas on this one? 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. {{attachment.author.accountId}}: Returnsthe ID associated with the user name. A condition refines the rule so it wont act too broadly. {{approval.addedApprovers}} - Returns the set of approvers added to issue. {{comment.body}} - Returns the body of the comment that triggered the rule. {{issue.comments.author.displayName}} - Returns the comment authors. See, This allows access to data that was sent along with the incoming webhook, Added by: Send web request with "Wait for response" checked. {fieldChange.toString}}- Returns the new value as displayed. Keep earning points to reach the top of the leaderboard. General triggers These triggers can be used across all Jira products. {{createdBranches.repository.url}} - returns the URLs of each repository. Create and configure Jira automation rules, Branch automation rules to perform actions on related issues, Issue data (Automation format) payload for Send Web Request, Issue data (Jira format) payload for Send Web Request action, Limitations in team-managed projects for automation rules, Permissions required for Jira Cloud automation rules, Test a Jira automation rule using the Manual trigger, Transfer Jira automation rules from one user to another, Differences between Automation in Jira Server and Jira Cloud, Examples of using math expression smart values, Examples of using smart values with dates, Examples of using smart values with lists, Examples of using smart values with text strings, Use Jira automation rules to modify issues, Convert wiki markup to HTML or plain text in Jira automation, Move an issue to another project using automation, Learn how to use these to interact with Jiras REST API. Learn how to integrate your source code management tool with Jira Cloud, Visit the marketplace to integrate your build or deployment tool with Jira Cloud. this is only available for some triggers. The problem with the interface was, that it worked in two steps - first the re-open transition and then the update of fields. Learn how to use these to interact with Jiras REST API. Examples of how you can use smart values to manipulate and format dates in your Jira automation rules. Used with: the Clone issue, Create issue, and Create sub-tasks actions. I would like to use this in a reminder email, that is sent to two people, using as source two different people fields. Triggers will listen for events in Jira, such as when an issue is created or when a field value is changed. For example, when an issue is transitioned you can see what status the issue transitioned from. action: log to the audit file this value. E.g. {{attachment.created}}: Returnsthe date and time the attachment was added to the issue. {{comment.visibility.value}} - Returns the comment restriction label if any, e.g. Accesses information for the current running rule. You were right, the rule was running too quickly, so the field was empty.I modify de trigger to give it time, and got the result expected. 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 . Learn more about list smart values. As for if and when the support will go to server, I have no idea. Awesome! Smart values allow you to access issue data within Jira. text {{/}}, or is this a Jira-cloud only functionality ? A representation of a release/version in Jira. If you have multiple webhook responses, you can add the#symbol to apply the rule to each individual response. issue The active issue. The "Request Type" prefix may be"Customer Request Type" in older instances of Jira. Jira smart values - issues To test what your smart value returns, use the manual trigger with log action and the result displays in the audit log. {{issue.url}} - Returns the URL of the issue. In this way, approval returns two different values depending on the trigger being Approval required or Approval completed - https://support . 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). Returns the value of the Jira Service Managements scale custom field. I've not been able to find such kind of information. There should be a locked field named either "Request Type" or "Customer Request Type" there. Actions are the doers of your rule. {{issue. Only one word but It changes the whole picture. Triggers: Triggers wait for defined events to take place in your Jira instance and will then execute the automation rule. Story points are integral for many agile teams. Learn more about using smart values with sections and lists. Do more to earn more! Go to templates. Because this smart value deals with multiple items (i.e: issues can have many watchers), it can be used with the#symbol to apply the rule to each individual component. Learn more about list smart values. In Linux/Mac OS, use a jq command, such as: In Windows, we can use Powershell's ConvertFrom-Json: Working with incoming webhook data in Automation for Jira. Examples of using smart values with lists. 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) Note that repository contains additional nested smart values. This applies to the legacy Insight app. {addedfieldChange.valueIds}} - Returns the id/ids of new value/values added. In the project menu, click on Project Settings. {{rule.name}} - Returns the name of the rule that is currently running. Learn more about date and time smart values. Is the IF statement available for Server version? ), then type 'webhooks'. For more information on when issues is available, see, Multiple comments on the active issue (this example is explained in detail in, Properties for versions include:name, description, archived, released, releaseDate, "Customer Request Type" in older instances of Jira. You can also trigger rules to run from third party services like Bitbucket or GitHub. 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. You could then use this to count the number of issues returned. all fields available to{{issue}}are available here as well. Please try just two around each side: Of note: what is the type of your field? Triggers can be set to run on a schedule, and can be customized before being applied to a rule. 2020-07-20T07:00:00.0+0000. Understand the general concepts and best practices of automation in Atlassian Cloud products. Reviewing your audit logs is an effective way of debugging your rules. Select the Issue fields condition from the New condition drop-down menu. This value supports Date and Time functions. A representation of a release/version in Jira. {{pullRequest.destinationBranch.repository}} returns information related to the destination branchs repository. With the 're-fetch issue data' action (which I seldom use), I noticed that this can put the automation execution on-hold for the whole 5 seconds! {{branch.repository}} returns information related to the repository the branch belongs to. {{createdBranch.product}} - returns the product that the branch was created in (for example, Bitbucket). {{sprint.name}} - Returns the sprint name. Note that repository contains additional nested smart values. You can access the current watchers of an issue. {{worklog.visibility}} -available when the worklog is restricted, {{worklog.visibility.type}} -available when the worklog is restricted, {{worklog.visibility.value}} -available when the worklog is restricted. View topic Examples of using math expression smart values The URL to access the issue. Returns the value of the Jira Service Managements rate custom field. First, you need a sample from the webhook payload data. A repository represents a collection of files and associated metadata. When there are multiple fields that have changed, {{fieldChange}}only contains the first changed value. {addedfieldChange.field}} - Returns the field which has changed due to addition of a value. You can access the current watchers of an issue. See all smart values that are used to insert and format numerical values using math expressions. A list of issues that have been created in the rule. {{attachment.author}}: Returnsthe user who added the attachment. {{deletedFieldChanged.values}} - Returns the value/values deleted. Examples of using smart values with text strings. For example, you might count how many issues have a priority of 'highest' and then send an alert. https://bitbucket.org/account/repo. That is not the correct custom field id for the field you want. {{deletedFieldChanged.fieldType}} - Returns the fieldType of the field that has changed due to deletion of a value. If more than one flag has been created throughout the rule, {{flag}} will return the most recently-created flag. Challenges come and go, but your rewards stay with you. If multiple values are changed, use # to iterate over these. View topic Find the smart value for a field Learn how to find the right Jira automation smart values for your issue fields in Jira Cloud. This smart-value allows you to access project specific attributes: Jira Service Management specific request type object that you can grab information from. {{issue.project}} - the project this issue is a part of. {{issue.affectedServices.changeApprovers}}, {{issue.affectedServices.changeApprovers.displayName}}, {{issue.affectedServices.dependentServices}}, {{issue.affectedServices.dependentServices.tier}}, {{issue.Request Type.currentStatus.status}}, {{comment.properties. Learn more about using smart values with sections and lists. {{pullRequest.sourceBranch}} returns the name of the source branch, e.g. The issue is not so much with the smart values itself, but with the {{#if }} statement. Can be combined with other date and time smart values. In the form that is shown, enter the details for your new webhook. The spacing format is mentioned in the following article: New automation smart values in Jira Cloud, https://jira.atlassian.com/browse/JIRAAUTOSERVER-212, Smart-value-in-published-article-doesn-t-work. A build represents the process in which files are converted into their final consumable form. ^ I tested this with Issues that had been in a previous Sprint, and were in the new Sprint being started - and the rule was successful, enteringonlythe new Sprint's name into the Description field, no old Sprint names. {{commit.repository.url}} returns the repositorys URL. You can view the status of an automation rule to identify if the rule is currently active or not. Accesses information related to a file attachment on an issue. 2 edit issue actions that need to 'add' to the value of a field instead of overwriting it). Examples of how you can use smart values to access and format items in a list, such as checkboxes and labels. What are conditions? 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 can access useful things like the previous status during a transition, Added by: Jira Triggers that contain a comment. Issues in Jira rarely exist in isolation. After a lot of searches, I found the answer on: https://community.atlassian.com/t5/Jira-questions/Store-Active-Sprint-in-New-Field-Using-Jira-Automation-Script/qaq-p/1695408. Can be used with both Approval required and Approval completed triggers: {{approval.createdDate}} - Returns creation date of approval.