JIRA, an issue tracking tool owned by Atlassian, is widely used by agile teams to manage their work effectively. One of its powerful features is Smart Values, which allow you to pull data from other fields or calculations into a new field, streamlining your workflow. Let's delve into the list of all JIRA Smart Values and explore their functionality.
Smart Values help you keep your data consistent and up-to-date across your JIRA projects. They can be used in various contexts, such as creating calculated fields, setting default values for fields, or building complex search queries. Here's a comprehensive list of all JIRA Smart Values, categorized for easier understanding:
JIRA System Fields
JIRA has numerous built-in fields that store information about issues. These fields can be used as Smart Values to fetch and display data:
For instance, you can use fields like `created`, `updated`, `due`, `duedate`, `project`, `issuetype`, `summary`, `description`, `reporter`, `assignee`, `status`, `priority`, `labels`, and more.
Issue Link Fields
JIRA allows you to link issues together. You can use Smart Values to fetch data from linked issues.
Examples include ` issuetypeoflink`, `issuelinksfrom`, `issuelinksto`, `issuelinkschildren`, and `issuelinksself` to get information about linked issues.
System Calculated Fields
JIRA provides several built-in calculated fields that can be used as Smart Values.
Some examples are `calculation` for performing simple mathematical operations, `timeoriginalestimate` and `timeestimate` to work with time-based fields, and `attachmentssize` to get the total size of attachments.
JIRA Custom Fields
You can create custom fields in JIRA to store additional data relevant to your team's work. Smart Values can fetch data from these custom fields as well:
Let's say you have a custom field named `myCustomField`. You can use it as a Smart Value in other fields or calculations:
Custom Field with Single Value
For custom fields that store a single value, you can use the field name itself as a Smart Value.
For example, if `myCustomField` stores a text value, you can use it like `${myCustomField}` in other fields or calculations.
Custom Field with Multiple Values
Custom fields that store multiple values, like a multi-select or checkbox, require a specific function to fetch data. You can use functions like `valueof`, `firstof`, or `minof` to extract data from such fields.
For an example, if `myCustomField` is a multi-select, you can use `${valueof(myCustomField)}` to get all selected values as a comma-separated string.
Custom Field with Complex Data Structure
Some custom fields store complex data structures, like an object or an array. In such cases, you can use functions like `mapof`, `reduce`, or ` incremental` to extract data from these fields.
For example, if `myCustomField` stores an array of objects, you can use `${mapof(myCustomField, 'Key to extract')}` to get the extracted values as a comma-separated string.
JIRA Functions
JIRA provides various functions that can be used in conjunction with Smart Values to perform actions, like calculations, comparisons, or conversions:
Mathematical Functions
You can use mathematical functions like ${add}, ${subtract}, ${multiply}, ${divide} to perform calculations using numeric values.
Date and Time Functions
Date and time functions like ${formatDate}, ${addDays}, ${subtractDays} can help you manipulate and display dates and times in different formats.
Text Manipulation Functions
Text manipulation functions like ${toUpper}, ${toLower}, ${capitalize}, ${replace}, ${substring} can be used to transform text data.
Logical Functions
JIRA also provides logical functions like ${equal}, ${notEqual}, ${greaterThan}, ${lessThan} to compare values and make decisions based on the results.
Best Practices and Tips
When using Smart Values, it's essential to follow best practices to ensure your data remains accurate and reliable:
Keep Your Values Atomic
Try to keep your Smart Values atomic, meaning they represent a single piece of data. This approach makes your fields easier to understand and maintain.
Use Descriptive Names
When creating custom fields, always use descriptive names to make it clear what data the field stores. This improves the usability of your Smart Values.
Test Your Smart Values
After setting up Smart Values, always test them to ensure they behave as expected. Unexpected results can lead to misinterpreted data and errors in your workflow.
You've explored the comprehensive list of all JIRA Smart Values and learned how to use them effectively. As your team grows and evolves, you can harness the power of Smart Values to adapt your JIRA workflows and make your work more efficient. So, go ahead and embrace this feature to unlock new possibilities in your project management!