Please raise suggestion ticket in our public tracker, https://jira.atlassian.com/projects/JIRAAUTOSERVER. [feature/ISSUE-123-some-work, feature/ISSUE-456-more-work]. Note that this will return an encoded URL; everything after bitbucket.org/ will look different from what you see here. Join the Kudos program to earn points and save your progress. Awesome! See all smart values that are used to insert and format numerical values using math expressions. You can also trigger rules to run from third party services like Bitbucket or GitHub. 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. Note that repository contains additional nested smart values. {{deletedFieldChanged.values}} - Returns the value/values deleted. [Custom Field]}} - Returns the value in an epic's custom field. Join now to unlock these features and more. The changed field value is available anywhere smart values are supported using the{{fieldChange}}substitution. Smart values are one of the most potent ways to do so. See all smart values related to accessing Jira project details. Set the Equals condition to true. For example, you might count how many issues have a priority of 'highest' and then send an alert. And we have lots more automation templates and guides for you to use and learn from in the automation template library. Are you looking for server documentation? {{createdBranch.repository.url}} - returns the repositorys URL. Step 1: In the top-right corner of your Jira Automation Settings, select Create Rule. Each of your rules will have an audit log that you can review to see when the rule was triggered, the final result of the execution, and any actions that may have been performed. Accesses the details of a subtask's parent issue. Similar to{{issue. {{sprint.endDate}} -Returns the end date of the sprint. A representation of a release/version in Jira. After testing, disable both the HTTP dump and access logs to avoid performance issues. This will return a list of values, if the issue has more than one attachment. Here, we choose the Issue fields' condition and clarify that the issue type we are looking out for is a sub-task. See all smart values related to user fields, such as Reporter or Assignee. {{webhookResponse.status}} - response code e.g. Automation is currently available in Jira Software Cloud and Confluence Cloud. https://bitbucket.org/account/repo/TEST-123-some-feature, {{pullRequest.destinationBranch.repository}}, https://bitbucket.org/{7faf7dee-a29b-4faa-bbc2-d7128a6d3278}/{315a3ecb-1f18-4953-98ae-5890f93073b5}/addon/pipelines/home#!/results/7, [feature/ISSUE-123-some-work, feature/ISSUE-456-more-work], https://bitbucket.org/{6d6d87be-bdc2-42b5-ad8f-85cb915abc38}/{80c30dd6-2d2f-401c-ac33-8317adbc509d}/addon/pipelines/deployments#!/deployments/{888ba48c-0011-5a46-9d59-8da313851383}, Best practices for optimizing automation rules, View performance insights for automation rules, Connect your automation rule to another tool. {{version.name}} - Returns the version's name. [xxx].size}}: Returnsthe file size of a specific attachment. 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. You can access useful things like the previous status during a transition, Added by: Jira Triggers that contain a comment. 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. Smart values - syntax and formatting; Jira smart values - issues; Jira smart values - conditional logic; . They often contain sub-tasks, are stories that are part of a larger epic, or are simply linked to other issues using certain relationships. In the form that is shown, enter the details for your new webhook. A list of issues generated by a trigger that runs a JQL search (Incoming Webhooktrigger orScheduledtrigger when set to process in bulk). {fieldChange.fromString}} - Returns the previous value as displayed. Learn more about using smart values with sections and lists. This example shows the previous status id (for use in another Edit action). Learn more about automation triggers. Looking forward to see it implemented soon! You can check this by navigating to the "Custom fields" page in the. Examples of using smart values with dates. Andit appears you are using Server/Data Center version, as the Re-fetch action does not have the "delay rule" option for Cloud. Added by: Sprint created, started or completed triggers. 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. You're on your way to the next level! What I didn't notice, is that I entered the value: {{issue.sprint.name}}. Examples of how you can use smart values to set the numerical value of an issues field in your Jira automation rules. Check out some common DevOps automation rules where you can use these smart values. Can be combined with other date smart values. The Atlassian Community can help you and your team get more value out of Atlassian products and practices. For example, you might count how many issues have a priority of 'highest' and then send an alert. {{issue.created}} - Returns the issue's creation date. They are using the curly-brace syntax like { {someSmartValue}} . Get answers to your question from experts in the community, Smart value of trigger issue in automation. All of the issues found by the trigger are then treated as a single bundle of issues. for a select field. {{attachment.author.accountId}}: Returnsthe ID associated with the user name. 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 could then use this to count the number of issues returned. The three properties above can also be added to this, for example,{{issue.affectedServices.dependentServices.tier}} will return the dependent services' tiers. Which Jira-server version supports the use of smart value: "{{#if . }} {{issue.affectedServices.changeApprovers}}, {{issue.affectedServices.changeApprovers.displayName}}, {{issue.affectedServices.dependentServices}}, {{issue.affectedServices.dependentServices.tier}}, {{issue.Request Type.currentStatus.status}}, {{comment.properties. What third-party applications can I integrate with? As ever, test this rule out in your own instance. Learn more about using smart values with sections and lists. Used with: the Clone issue, Create issue, and Create sub-tasks actions. If multiple values are changed (e.g. {{attachment.author}}: Returnsthe user who added the attachment. {{versions.archived}}- Returnstrueif the affects version is archived, andfalseif not. I would like the value that enters the text field to be the name of the sprint that created the trigger. Your image appears to show too many curly-brackets around the value. This example returns an issue's previous type, after it has been changed. Properties are frequently used by add-ons and integrations to store values, e.g. Used with: any triggers that edit an issue. 2020-07-20T07:00:00.0+0000. Actions are the doers of your rule. E.g. You can find some automation templates to help you get started within the product library. Any property used with the{{issue}}smart value can also be used with{{createdIssue}}. For example, when an issue is transitioned you can see what status the issue transitioned from. {{commit.hash}} returns the SHA1 hash of the commit, e.g.4877576951f3eda43625d3345058e702dad3df0d. {{fieldChange.from}}- Returns the previous raw value, e.g. Because this smart value deals with multiple items (i.e: issues usually have many comments), it can be used with the # symbol to apply the rule to each individual comment. [Custom Field].name}} - Returns the visible label displayed on the left of the field. 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. There should be a locked field named either "Request Type" or "Customer Request Type" there. Smart values in Jira automation. Used with: the Create feature flag in LaunchDarkly action. {{sprint.isStarted}} - Returnstrue if the sprint has started, andfalse if not. Do more to earn more! Refers to the original issue that triggered the rule; used when you branch the chain. {{issue.Customer Request Type}} - Returns the customer request type for older Jira instances. You must be a registered user to add a comment. Learn more about automation triggers. Each DevOps trigger makes relevant smart values available, related to commits, changesets, committer users . Share the love by gifting kudos to your peers. Affects version of an issue as a list. If a customer has not responded to an issue in 5 days, close the issue and leave a comment. Access information related to all branches created in the rule, as a list. 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. {{approval.decision}} - Returns the final decision of the approval. I created an automation that created a value in a short text field. @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 ! Can be combined with other date and time smart values. In this way, approval returns two different values depending on the trigger being Approval required or Approval completed - https://support . A representation of a release/version in Jira. This smart-value allows you to access project specific attributes: Jira Service Management specific request type object that you can grab information from. The rule triggers on 'Issue created' and is followed by the 'Send web request' component. The following example prints all the issue keys returned from the JQL search, in bullet point form. Learn more about using smart values with sections and lists. 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. Seeaccesing multi-value fields, Added by: This is added any time an issue is added. Possible states include pending, in_progress, successful, failed, cancelled, or unknown. {{issue.comments.first.body}} - Returns the body of the first comment. Story points are integral for many agile teams. 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. In progress. You could then use this to count the number of issues returned. Accesses a Tempo Account field's properties. The option to created linked issues (and then pick the blocked option) exists, but only to pick the issue from the trigger value or the most recently created issue to create a link. 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. This re-fetches the latest state of the issue from Jira. https://bitbucket.org/account/repo. {{sprint.startDate}} - Returns the start date of the sprint. {{deletedFieldChanged.fieldType}} - Returns the fieldType of the field that has changed due to deletion of a value. Seeaccesing multi-value fields, Added by: This is added any time an issue is added. I found both of these smart values seemed to work: If neither of these work for you, there are a few other options in those linked questions you can try :), {{sprint.name}} returns only the sprint that started and which triggered this automation event. Learn about the concepts and procedures related to automation in Jira Cloud. General triggers These triggers can be used across all Jira products. {{createdBranches.repository.url}} - returns the URLs of each repository. Simply combine these components to create rules that can do anything from auto-closing old issues to notifying specific teams when a release has been shipped. I suspect not. A list of issues that have been created in the rule. 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. See all smart values related to Assets in Jira Service Management Cloud. Field value changed Available in Server Lite: No [Custom Field].defaultValue}} - Returns the value displayed on first view of the field. Learn about the concepts and procedures related to automation in Jira Cloud, Smart values allow you to access issue data within Jira. Note that repository contains additional nested smart values. {{versions.released}}- Returnstrueif the affects version is released, andfalseif not. {{versions.releaseDate}}- Returns the affects version's release date. . This applies to the legacy Insight app. If you've already registered, sign in. : To do,In progress, orDone). Properties are frequently used by add-ons and integrations to store values. They are variables in the sense that their actual values will be calculated while the automation rule is being executed: You can use two types of smart values: 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. You can specify a default value to prevent this. {{flags.key}} returns the key of the feature flag. This smart value accesses the changelog, and a list of changes for each field. This value supportsDate and Time functions, e.g. {{addedfieldChange.values}} - Returns the new value/values added. Otherwise, register and sign in. The following smart values are available to access and format development information from a connected source code management tool. {{comment.properties}} - Accesses any comment property. You must be a registered user to add a comment. A branch represents an independent line of development. What third-party applications can I integrate with? Step 4: Add 'Edit Issue' action . {{issue.Request Type.requestType.name}} - Returns the customer request type. Approval completed: accesses information for an approval when an approval step on an issue is accepted or declined. The information that you can access on the issue are described in the Available properties section below. Developers. {{pullRequest.destinationBranch.repository}} returns information related to the destination branchs repository. Do more to earn more! To test what your smart value returns, use themanual triggerwithlog actionand the result displays in theaudit log. Find issues that have the same custom field date as trigger issue. Is the IF statement available for Server version? It resets every quarter so you always have a chance! We do not currently support accessing fields within insight objects. Returns information related to the created feature flag. An environment represents a distinct ecosystem where products are deployed to. Added by: Webhook TriggerThis allows access to data that was sent along with the incoming webhookThe body of the Webhook request. What goes around comes around! See all smart values that can access and manipulate text fields, such as issue summary or comments. But it looks like functionality for the Jira cloud version. Select the Issue fields condition from the New condition drop-down menu. Examples of how you can use smart values to access and format items in a list, such as checkboxes and labels. There is a feature request for it though - check outAUT-648. { {issue. Learn more about list smart values. {{createdBranches.name}} - returns the names of the branches, {{createdBranches.url}} - returns the URLs of the branches. For example, wheninvalid referencedoesn't contain a value, you can printHello worldusing{{invalid reference|"Hello world"}}. You can set triggers to run on a schedule or as needed. Learn how to use these to interact with Jiras REST API. Learn more about services in Jira Service Management. 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. All of the issues found by the trigger are then treated as a single bundle of issues. We will ensure the story points of the parent and sub-task always remain in sync. action: log to the audit file this value. {{attachment.author.emailAddress}}: Returnsthe email address associated with the user name. Learn more about date and time smart values. {{pullRequest.destinationBranch}} returns information related to the destination branch of the pull request. {{pullRequest.destinationBranch}} returns the name of the destination branch, e.g.master, {{pullRequest.destinationBranch.url}} returns the URL of the destination branch, e.g. In the dropdown menu, you simply choose the field you want to work on, including custom fields and then edit. You can access all fields of the parent. This smart value only works for issues that have been added to an epic. [Custom Field].id}} - Returns the unique id for the field assigned by Jira. {{attachment.author.active}}: Returnstrue if their account is active, andfalse if not. This can be almost anything you want. {{rule.name}} - Returns the name of the rule that is currently running. Approval required: accesses information when an issue that requires approval is created or updated, or when new approvers are added to an issue. all fields available to{{issue}}are available here as well. If you're not using a Sprint Trigger, I don't believe it's possible to locate the active Sprint via smart values. Auto-suggest helps you quickly narrow down your search results by suggesting possible matches as you type. You can also use this with, . Examples of using smart values with text strings. That looks a little odd. Accesses any issue property. {addedfieldChange.field}} - Returns the field which has changed due to addition of a value. {{issue. However sometimes the two fields holds the same person, resulting in an email with twice the same name. Can you please assist us in working out the following issues? {addedfieldChange.valueIds}} - Returns the id/ids of new value/values added. Refers to the original issue when you branch the chain. [property]}}, you can also access custom field information on your issues. The trigger for automation is starting a new sprint (trigger = start sprint). E.g. Used with the Version created, Version updated, and Version released triggers. Automation for Jira has a trigger that reads incoming webhooks, both in on-premises and cloud intances. Keep earning points to reach the top of the leaderboard. If you have multiple webhook responses, you can add the#symbol to apply the rule to each individual response. In the example below, we have a custom field calledTeam Leader, and the value of thefield is currentlyAlana Grant. Accesses the previous issue created in the rule. {{attachment.mimeType}}: Returnsthe file format of the attachment. {{issue.project}} - the project this issue is a part of. 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. . ), then type 'webhooks'. For smart values related to the Insight feature in Jira Service Management, see Jira smart values - Assets. Also provides the customer portal URL for Jira Service Management issues. Added by: Webhook TriggerThis allows access to data that was sent along with the incoming webhookThe body of the Webhook request. They allow you to automate tasks and make changes within your site. There is no Jira smart value referring to approval name (so that we can differentiate when there are multiple approvals in a workflow). my-custom-prod-env, {{environment.type}} returns the environment type. All of the issues found by the trigger are then treated as a single bundle of issues. {{branch.repository.url}} returns the URL, e.g. Learn more about user smart values. Do you have any idea how I find active sprint smart value? {{deletedFieldChanged.valueIds}} - Returns the id/ids of value/values deleted. my-awesome-repository. Reviewing your audit logs is an effective way of debugging your rules. As a result of this design, the automation got initiated while triggered by a transition, however the data needed for the automation could not be yet updated. Accesses information relating to the sprint that triggered the rule. [Custom Field].description}} - Returns the text displayed below the custom field viewed in the Simple Search column. These smart values are only available for the Build successful, Build failed and Build status changed development triggers. The rule actor is the user who executes a rule. They allow you to access and manipulate almost any data in Jira. {{issue.epic.key}} - Returns the epic's key, e.g. all fields available to{{issue}}are available here as well. {{versions.name}}- Returns the name of the affects version. You can access the current watchers of an issue. At the same time, it would be to good to mention that it is Jira-cloud functionality only. Note that repository contains additional nested smart values. {{attachment.created}}: Returnsthe date and time the attachment was added to the issue. Visit the marketplace to integrate your build or deployment tool with Jira Cloud. {{issue.parent.priority.name}} - Returns the priority of the subtasks's parent issue. A build represents the process in which files are converted into their final consumable form. {{pullRequest.updatedDate}} returns the time (UTC) when the pull request was last updated (created, declined or merged), e.g. Every rule starts with a trigger. {{pullRequest.title}} returns the title of the pull request, e.g. For example, {{attachment.first.size}} will return the file size of the first attachment. This value supportsDate and Time functions. Multiple comments on the active issue (this example is explained in detail inhow to use smart values), Components of an issue as a list. global admin section. The URL to access the issue. Try adding.accountId after coordinator (so{{#if(issue.assignee.equals(issue.coordinator.accountId))}}. Here you can access any issue property. The issue smart values are used to access information related to the rules active issue, which is the issue the rule is currently acting on. Returns the value of the Jira Service Managements rate custom field. {{issue.description}} - Returns the content in the issue'sDescriptionfield. Thisshould not be usedsince it requires an expensive reload of issue data. [property]}} You can access useful things like the previous status during a transition, Added by: Jira Triggers that contain a comment. Join now to unlock these features and more. Accesses time tracking estimates. You can access all fields of the Epic. Learn more about date and time smart values. If a rule is inactive, it will not execute until it is enabled. Used with the Related issues condition. Learn how to find the right Jira automation smart values for your issue fields in Jira Cloud. Keep earning points to reach the top of the leaderboard. Or you could count how many issues have the same label, same fixVersion, etc. A pull request represents proposed changes before they are integrated into an official project. Keep earning points to reach the top of the leaderboard. Challenges come and go, but your rewards stay with you. {{addedFieldChanged.fieldId}} - Returns the fieldId of the field that has changed due to addition of a value. In the following example, we list each comment that an issue has, and include the author and creation date/time: In this example, we return the name of the person who added the last comment on an issue: Used to access the values in an issue's Components field. In the below example, we list each fix version that the issue has been added to, followed by the version's release date, in bullet point form. {{issue.parent.key}} - Returns the issue key of the subtask's parent issue. I've not been able to find such kind of information. View topic Examples of using math expression smart values I recall there are suggestions in the backlog to add "wait until the prior step finishes" or "delay X seconds" actions. 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. I'll mention the docs discrepancies to the person that maintains our documentation. Affects version of an issue as a list. The URL to access the issue. I would like to use this in a reminder email, that is sent to two people, using as source two different people fields. issue The active issue. If youre an Automation for Jira app customer on a server product, check out the Automation for Jira documentation for Jira Server. When a PR is merged in Bitbucket/GitHub/GitLab, then transition the issue in Jira. 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). What third-party applications can I integrate with? The changed field value is available anywhere smart values are supported using the{{fieldChange}}substitution. 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. Triggers will listen for events in Jira, such as when an issue is created or when a field value is changed. {{commit.shortHash}} returns the truncated SHA1 hash of the commit, e.g. For example, you might count how many issues have a . We use the following smart-value to sum up story points from all sub-tasks: {{issue.subtasks.Story Points.sum}}. I would like to use this in a reminder email, that is sent to two people, using as source two different people fields. {{version.archived}} - Returnstrue if the version is archived, andfalse if not. For example, when setting multiple Fix Versions, then you can iterate over these using{{#changelog.fixVersion}}{{toString}}. Triggers can be set to run on a schedule, and can be customized before being applied to a rule. {{environment.name}} returns the use-provided name for the environment, e.g. Used to access information about an issue's epic. {{deployment.environment}} returns my-custom-prod-env, {{deployment.environment.type}} returns production. Learn more about using smart values with sections and lists. You can view the status of an automation rule to identify if the rule is currently active or not. {{branch.repository.name}} returns the name of the repository. See, This allows access to data that was sent along with the incoming webhook, Added by: Send web request with "Wait for response" checked. You can view the audit log of an individual rule, project-wide or at a global level. You can check this by navigating to the "Custom fields" page in theglobal admin section. {{issue.timetracking.timespent}} - Returns the amount of time that has been logged on the issue in the Time spent field. Send a daily Slack message with a list of issues still open in the Sprint. Can be used with both Approval required and Approval completed triggers: {{approval.createdDate}} - Returns creation date of approval. Can be combined with other user-related smart values. Challenges come and go, but your rewards stay with you. Understand the general concepts and best practices of automation in Atlassian Cloud products. Exclusive to the Approval required trigger: {{approval.initiator}} - Returns account id of initiator of request. {{issue.comments.reverse.body}} - Returns the issue's comments, in reverse order. Accesses the values in an issue'sAffected services field. These smart values can only be accessed through other root keys (e.g{{deployment.environment}}).
