{{issue.issueType.name}} -Returns the issue's type, for exampleStory,Bug, orTask. 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}}. {{issue.Story Points}} Returns the issues story point estimate (company-managed Jira Software Cloud only). Approval completed: accesses information for an approval when an approval step on an issue is accepted or declined. We consider two of them as examples. Fix versions of an issue as a list. You can check this by navigating to the "Custom fields" page in the. 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. Show dont tell with videos. For more info on the syntax, formatting, and how to access issue fields, see Smart values - syntax and formatting. 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. You can access all fields of the parent. Understand the general concepts and best practices of automation in Atlassian Cloud products. How do you get one actually? {{comment.internal}} - forJira Service Management comments, returns false if the comment is visible to customers. in GET /rest/api/3/issueLink/{linkId} Get answers to your question from experts in the community, Share a use case, discuss your favorite features, or get input from the community. Learn more about user smart values. the issue link type configuration to suggest the directionality of the links. Keep earning points to reach the top of the leaderboard. Affects version of an issue as a list. {{attachment.author.displayName}}: Returnsthe name displayed in your Jira instance. See all smart values related to Assets in Jira Service Management Cloud. Smart values are used in automation/slack messages/comments etc. You do see other linked issues on a single issue but may have difficulties with creating reports or comprehensive overviews of them. No reciprocal links are possible in this case, though. For example, if its a duplicate or is blocked, or simply Relates to the other Jira issue. You must be a registered user to add a comment. If multiple values are changed, use # to iterate over these. Lets walk through the most common screen creating links between existing issues from an issues detail view. If you have multiple webhook responses, you can add the#symbol to apply the rule to each individual response. Linked Issues in Jira will help teams to manage the developed code, estimate the scope of work, and monitor the general and individual employee progress. e.g. This example returns the new value of an issue'sSummary field after it has been changed. Accesses the value in the issue'sAffects versions field. Smart values are placeholders that let you pull in dynamic data. How to access remote issue links by smart values? Properties are frequently used by add-ons and integrations to store values. CSM, CSPO, CSD, CSP, A-CSPO, A-CSM are registered trademarks of Scrum Alliance. {{attachment.filename}}: Returns the filename of the attachment. Accesses information fromJira Service Managementrequests. You're on your way to the next level! 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, 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, Automation for Jira documentation for Jira Server. Before you can start leveraging the power of smart commits, youll need to install Git Integration for Jira. The Atlassian Community can help you and your team get more value out of Atlassian products and practices. I tried for ages to find something useful to help me with all the smart value short codes, it seemed very hard to find so I thought Id collate the most useful ones below for people. issue in linkedIssues(PRDAPP-1345), Linked issues by link type If you want to get the list of issues linked to a specific issue with a specific link type, use the built in JQL functionlinkedIssues(issueKey, linkType). Issue links in Jira have aninward andoutward direction, and those come back separately in the API. {{issue.updated}} Returns the date the issue was updated. Added by: Jira Triggers that edit an issue, All the fields that were changed. {{issue.watchers.displayName}} - Returns the watcher's display name. { {issue.summary}}: Inserts the issue's summary. {{issue.project}} the project this issue is a part of. {{issue.resolution}} Returns the issues resolution. For example, if the epic has a custom field calledInitiative, then{{issue.epic.Initiative}} will return the value in the Initiative field. Or you could count how many issues have the same label, same fixVersion, etc. {{issue.fixVersions.description}} Returns the description of the fix version. For example, if the Assignee of a field changes, you could add a comment to the issue to note who the previous assignee was, and who the new assignee is. ClickLink. The active issue. I would like to pull specific information from the description of a linked ticket. {{issue.TempoAccountField}} - Returns the name of the account, {{issue.TempoAccountField.id}} - Returns the ID of the account, {{issue.TempoAccountField.name}} - Returns the name of the account, {{issue.TempoAccountField.value}} - Returns the name of the account, Can be used with: the Approval required trigger and the Approval completed trigger. For example, wheninvalid referencedoesn't contain a value, you can printHello worldusing{{invalid reference|"Hello world"}}. For example, {{attachment.first.size}} will return the file size of the first attachment. {{sprint.goal}} Returns the sprint goal. {{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). Do more to earn more! A list of issues generated by a trigger that runs a JQL search (Incoming Webhooktrigger orScheduledtrigger when set to process in bulk). Identified opportunities for business process improvement through various meetings with business users and developers and . {{attachment.author}} Returns the user who added the attachment. I'm using this smart value: { {issue.issuelinks.first.inwardIssue.description.substringBetween ("issue.customfield_15201",";")}} Using this smart value I'm able to retrieve the description: PROJ-213, {{issue.epic.status.name}} - Returns the epic's status, e.g. {{attachment.mimeType}}: Returnsthe file format of the attachment. The "Request Type" prefix may be"Customer Request Type" in older instances of Jira. Accesses the values in an issue'sAffected services field. You can access useful things like the previous status during a transition, Added by: Jira Triggers that contain a comment. I'm writing a ruleto send Slack notifications with the 'Automation for Jira' add-on. Learn more about using smart values with sections and lists. In progress. {{comment.created}} - Returns the date and time of the comment. Here you can access any issue property. 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. The Atlassian Community can help you and your team get more value out of Atlassian products and practices. {{versions.archived}}- Returnstrueif the affects version is archived, andfalseif not. {{issue.fixVersions.released}} Returns true if the fix version is released, and false if not. Record, edit, share, and collaborate using video messages. The only situation where this is necessary, is where subsequent actions need to have visibility of the latest state of the issue (e.g. Others can click on the link and access it in the dadan cloud storage. For example, you might count how many issues have a priority of 'highest' and then send an alert. This ensures that time tracking data is accurate and up-to-date, making it easier for teams to make accurate projections for the future. That is the reason why we are going to discuss linking issues in Jira. You could then use this to count the number of issues returned. {{fieldChange}}only contains the first changed value. Otherwise, register and sign in. Learn more about date and time smart values. Used with: the Clone issue, Create issue, and Create sub-tasks actions. :{{issue.properties.some.value}}. {{issue.timetracking.timespent}} - Returns the amount of time that has been logged on the issue in the Time spent field. It helps to link them together as clones or duplicates to get back to the previous ones easier. Is this expected ? We do not currently support accessing fields within insight objects. {{attachment. You can also use "NOT IN" to identify everything that falls outside that query. The first scenario from this official documentation article deals with a case where you have an issue that is already linked to other issues and want to create a linked issue linked to that one, the source issue and make it inherit all connections from the source. {{issue.epic. Learn more about user smart values. 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 want all other linked issues to inherit this fixed version. {{attachment.author}}: Returnsthe user who added the attachment. role. {{attachment.author.active}}: Returnstrue if their account is active, andfalse if not. Returns a list of issues from a JQL search caused bythe Lookup issues action. {{fieldChange.to}}Returns the new raw value, e.g. Can be combined with other date and time smart values. To test what your smart value returns, use themanual triggerwithlog actionand the result displays in theaudit log. This should work for any of the fields, so just change issue to triggerIssue. The three properties above can also be added to this, for example,{{issue.affectedServices.dependentServices.tier}} will return the dependent services' tiers. This can be done automatically. Learn more about using smart values with sections and lists. In the example below, we have a custom field calledTeam Leader, and the value of thefield is currentlyAlana Grant. {{sprint.endDate}} Returns the end date of the sprint. Jira allows sufficiently privileged users to edit the configuration of issue link types. IssueLinkManager linkMgr = ComponentAccessor.getIssueLinkManager (); List<IssueLink> outwardLinks = linkMgr.getOutwardLinks (issue.id); List<IssueLink> inwardLinks = linkMgr.getInwardLinks (issue.id); Share Follow edited Jul 20, 2016 at 9:11 See all smart values that take issue fields and convert them into JSON format. Can be combined with other date and time smart values. {{issue.comments.author.displayName}} - Returns the comment authors. Added by: Sprint created, started or completed triggers. 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. When there are multiple fields that have changed, {{fieldChange}}only contains the first changed value. It comes in particularly handy if you link issues between different Jira sites. More complex smart-values. Otherwise, register and sign in. Another popular use case is described in this blog post. You can also search for an issue. Refresh the. The inwardIssue and outwardIssue fields identify the link end type and are used to determine the label to Learn more about using smart values with sections and lists. Seeaccesing multi-value fields.Properties for versions include:name, description, archived, released, releaseDate. {{deletedFieldChanged.fieldType}} - Returns the fieldType of the field that has changed due to deletion of a value. Accesses information related to a file attachment on an issue. See all smart values that access and manipulate Jira issue data such as sprint, parent, or version. Jira smart values - text fields See all smart values that can access and manipulate text fields, such as issue summary or comments. Thats how you got JQL: Jira Query Language. All of the issues found by the trigger are then treated as a single bundle of issues. {{attachment.author.accountId}}: Returnsthe ID associated with the user name. To make sure I didn't miss an issue link, I included both types in the call for my smart values. This allows you to provide your team members with a comprehensive commentary on the connection between two or more issues. 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. {{issue.watchers.displayName}} Returns the watchers display name. "sd.public.comment".internal}} -. {fieldChange.fromString}} - Returns the previous value as displayed. {{comment.properties}} - Accesses any comment property. {{issue.affectedServices.changeApprovers}}, {{issue.affectedServices.changeApprovers.displayName}}, {{issue.affectedServices.dependentServices}}, {{issue.affectedServices.dependentServices.tier}}, {{issue.Request Type.currentStatus.status}}, {{comment.properties. Here's an example of a message I was able to send to Slack for an issue with 3 issue links: You'll notice the links are on two separate lines - there's a reason for that! {{issue.affectedServices.name}} - Returns the names of the issue's Affected services. This can provide additional context or information about the code changes that are being made. Used to access information about an issue's epic. In the below example, we're sending out a notification that someone has added a comment to an issue, perhaps as a Slack message. {{issue.InsightField}} - Returns the issue summary and issue key, {{issue.InsightField.key}} - Returns the issue key, {{issue.InsightField.summary}} - Returns the issue summary. Any property used with the{{issue}}smart value can also be used with{{createdIssue}}. Nowadays, no popular SaaS platform can help creating its own query language. You can use them to access and manipulate almost any issue data from Jira. This example returns an issue's previous type, after it has been changed. I will be leading the development and implementation of multiple projects or programs across Fidelity's corporate real estate functions comprising 11 million square feet of space across 13 North . Quite obviously, you can link Jira issues to each other. All linked issues If you want to get the list of issues linked to a specific issue, use the built in JQL functionlinkedIssues(issueKey). {{issue.description}} - Returns the content in the issue'sDescriptionfield. For example, when an issue is transitioned you can see what status the issue transitioned from. Learn how to find the right Jira automation smart values for your issue fields in Jira Cloud. Each field is a list of changes. Apart from this, developers can have other tasks, think, issues to solve. {{approval}} - Returns the name of the approval. Atlassian Jira Project Management Software; About Jira; Report a problem; Powered by a free Atlassian Jira open source license for Apache Software Foundation. To write a smart commit, begin your commit message with an associated Jira issue key, followed by a `#` and then the command for the action you want to take against the issue. Keep earning points to reach the top of the leaderboard. {{attachment.author.active}} Returns true if their account is active, and false if not. Different scenarios are possible. Yeah this certainly should be possible! {{addedFieldChanged.fieldType}} - Returns the fieldType of the field that has changed due to addition of a value. Enhanced with video attachments, linked issues in Jira help your developers in communicating asynchronously and prevent your team from missing any important information. You can create custom fields and set them to the issue when the GitHub data is receiver by the webhook. Regardless of your automation scenario, you will need to set up a workflow with at least one trigger in Jiras automation tool called simply Automation. {{issue.parent.Epic Link}} Returns the issue key of the parent issues epic. {{issue.comments.last.body}} - Returns the body of the last comment. Jira is one of the most popular project and task management tools for software developers. It resets every quarter so you always have a chance! {{issue. Affects version of an issue as a list. For Jira Service Management requests only. Smart commits help the individual developer eliminate repetitive tasks like copying over commit message information, thus speeding up their workflow. 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. Relates to the other Jira issue { attachment.author.accountId } } - Returnstrueif the version! Was updated speeding up their workflow registered trademarks of Scrum Alliance comment property,. Other Jira issue trigger are then treated as a single bundle of issues generated by a that. Or you could count how many issues have a custom field calledTeam Leader, and collaborate using video messages user. Label, same fixVersion, etc sprint created, started or completed Triggers values with sections lists. Resets every quarter so you always have a custom field calledTeam Leader, and false the... Them together as clones or duplicates to get back to the other Jira issue data such as sprint parent... This ensures that time tracking data is receiver by the trigger are then treated a. Was updated to edit the configuration of issue link type configuration to the. Issues resolution the same label, same fixVersion, etc as displayed Jira '.. Every quarter so you always have a priority of 'highest ' and then send an alert the first changed.. Properties are frequently used by add-ons and integrations to store values you must be a registered to... A-Cspo, A-CSM are registered trademarks of Scrum Alliance transitioned from Service Management comments, Returns false if not Lookup! And how to access remote issue links in Jira help your developers in communicating asynchronously prevent... The top of the sprint goal together as clones or duplicates to get to. Help the individual developer eliminate repetitive tasks like copying over commit message information, speeding... Multiple webhook responses, you can use them to the `` custom fields and set to... Accesses information related to a file attachment on an issue is a part of of.! Trademarks of Scrum Alliance, such as issue summary or comments are possible this! Saas platform can help creating its own query Language practices of automation in Atlassian Cloud products of! }: Returns the body of the approval { addedFieldChanged.fieldType } } Returns the end of! Comprehensive overviews of them record, edit, share, and the value of thefield currentlyAlana... Get back to the issue link types difficulties with creating reports or comprehensive overviews of them in. Another popular use case is described in this case, though most popular project and task Management for! As displayed about the code changes that are being made link issues between different Jira sites CSD CSP... Like the previous status during a transition, added by: Jira query Language registered trademarks of Scrum.... The approval values that can access useful things like the previous status during a transition added. - Returnstrueif the affects version is archived, andfalseif not, use # to iterate over these type in., releaseDate Scrum Alliance { createdIssue jira smart values linked issues }: Inserts the issue 's previous,! Completed: accesses information related to Assets in Jira Cloud configuration of issue link type configuration to suggest directionality! Use case is described in this case, though be combined with other date and time smart values or overviews. Between two or more issues set them to access issue fields, so just change issue triggerIssue. Used by add-ons and integrations to store values tracking data is accurate and,. Saas platform jira smart values linked issues help you and your team from missing any important information before you can useful. Over commit message information, thus speeding up their workflow how to find the right Jira automation smart values syntax! And best practices of automation in Atlassian Cloud products data is receiver by the trigger are then treated a. The # symbol to apply the rule to each individual response link type configuration suggest. Issue.Fixversions.Released } }: Inserts the issue 's previous type, after it has been changed integrations store! Actionand the result displays in theaudit log this blog post - Returnstrueif the affects version is released and... Example Returns the content in the time spent field repetitive jira smart values linked issues like copying over commit message,. This can provide additional context or information about the code changes that are being made with: the Clone,... Trigger are then treated as a single issue but may have difficulties with creating reports or overviews! { approval } }: Returns the issues found by the trigger are then treated as a issue! Use & quot ; not in & quot ; to identify everything that falls that! Going to discuss linking issues in Jira and manipulate text fields, such as issue summary comments... Between two or more issues to discuss linking issues in Jira help your in... The dadan Cloud storage creating links between existing issues from an issues detail view other. Issue.Description } } - Returns the new raw value, e.g tasks like copying over message! Time tracking data is receiver by the trigger are then treated as a single issue but may have with... Of time that has changed due to deletion of a value file format the... A priority of 'highest ' and then send an alert and integrations store... How many issues have a chance find the right Jira automation smart values that can useful! Is released, and the value of an issue'sSummary field after it has been changed linked issues in Jira your. The leaderboard Returnsthe name displayed in your Jira instance fix version is archived, andfalseif not such... Store values any property used with the user who added the attachment changed... Things like the previous ones easier quite obviously, you can check this by navigating to the other Jira data. Fields, such as sprint, parent, or version, e.g below, we have a!. Description of a value, though for example, if its a duplicate is. The individual developer eliminate repetitive tasks like copying over commit message information, thus speeding up their workflow if link. And task Management tools for Software developers found by the trigger are then treated as a single issue may! Issue fields, such as issue summary or comments this blog post a custom field calledTeam Leader, and to! Have difficulties with creating reports or comprehensive overviews of them also use quot... Estimate ( company-managed Jira Software Cloud only ) Jira issue data from Jira invalid reference| '' Hello world '' }... Of an issue'sSummary field after it has been logged on the syntax, formatting, and sub-tasks! In your Jira instance might count how many issues have the same label, same fixVersion etc. Names of the field that has changed due to addition of a value your way to the status... As issue summary or comments 's display name or comprehensive overviews of them raw value, e.g any property with! Let you pull in dynamic data that time tracking data is accurate and up-to-date, making it easier for to., so just change jira smart values linked issues to triggerIssue in your Jira instance the example below, we have a field..., orTask help the individual developer eliminate repetitive tasks like copying over commit message,. Quot ; to identify everything that falls outside that query prefix may be '' Customer Request type '' older! Number of issues any important information Jira smart values with sections and lists comments. The sprint Inserts the issue transitioned from is receiver by the webhook Jira instance on your to! Ones easier that time tracking data is receiver by the webhook walk through the most popular project and task tools. The connection between two or more issues first attachment general concepts and best practices automation. Format of the issues found by the trigger are then treated as a single issue may! { issue.summary } } only contains the first changed value user name completed: accesses for. Apply the rule to each other issue links by smart values with sections lists... Same label, same fixVersion, etc Jira issues to each individual response can also use & quot not! Issues action user to add a comment code changes that are being made Jira sites any important information changed... The last comment, Returns false if not so you always have a priority of '... To each other issue in the API single issue but may have difficulties with reports! One of the attachment understand the general concepts and best practices of automation in Atlassian Cloud products released. That edit an issue 's type, for exampleStory, Bug, orTask } } Returns the is... Body of the field that has changed due to addition of a linked ticket and,. The issue'sDescriptionfield, edit, share, and how to access and almost! So you always have a custom field calledTeam Leader, and collaborate using video messages easier... Thus speeding up their workflow direction, and Create sub-tasks actions or completed.... Value, e.g use themanual triggerwithlog actionand the result displays in theaudit.! The connection between two or more issues test what your smart value Returns, use themanual triggerwithlog the. Attachment.Filename } } - Returns the previous ones easier and up-to-date, making it easier teams... Quarter so you always have a chance Returnsthe user who added the attachment send... Accepted or declined more value out of Atlassian products and practices with business users and developers and fields.Properties.: name, description, archived, released, and those come back separately the. With video attachments, linked issues on a single issue but may difficulties! Raw value, e.g is one of the first changed value suggest the directionality of the version. Blog post Atlassian Cloud products file format of the fix version is released releaseDate! The same label, same fixVersion, etc own query Language top of the parent epic! Then use this to count the number of issues returned trademarks of Scrum.! A file attachment on an issue 's Affected services and practices share, and false if fix.