Jira expressions
The Jira expression field types store the result of your own Jira expression, for when no other field type fits.
You write the expression once.
FieldCraft runs it for each work item and stores the result, so you can search and sort by it.
Field types in this sectionβ
Pick the type by what the expression returns and how you want to search it.
| Field type | Stores | Use it for |
|---|---|---|
| Jira Expressions - Text | Text | Labels and short summaries, such as 3/5 done. JQL matches text only exactly |
| Jira Expressions - Number | A number | Scores and counts, with rounding, a unit and a traffic light or progress bar |
| Jira Expressions - Date | A date | A day, such as the latest due date among the sub-tasks |
| Jira Expressions - Date & time | A date and time | A moment, such as when the last comment was added |
| Jira Expressions - User | A user | A person, searchable with currentUser() |
To write, check and save an expression, see Write a Jira expression.
When another type fits betterβ
Built-in types follow their data more closely than an expression does.
-
To show a field of the parent or the epic, use the Parent Field types. They update when the parent changes.
-
To total the children, use Rollup.
-
To count down to a date, use Countdown. It stays current on its own.
Calculated with the app's accessβ
FieldCraft runs the expression with the app's access. It can read work items and comments that the person viewing the field can't see.
Everyone who can see the work item sees the stored value.
A Jira admin acknowledges this once per field before it calculates. See Acknowledge app access.
When the value updatesβ
FieldCraft runs the expression again when the work item changes a field that the expression reads.
If it can't tell what the expression reads, every change counts.
On a parent, the expression runs again when you add, remove or move a child. If it reads .subtasks or .stories, a child's status change counts too.
For children, you need Update parents and children turned on in the Settings tab.
Changes to the parent or to linked work items don't reach the field. It catches up when the work item changes or when you open it.
When you open the work item, FieldCraft runs the expression again, at most every 15 minutes.
Expressions never refresh hourly.
Relatedβ
-
Write a Jira expression: use the editor, snippets and the check before you save.
-
Jira expressions on the Atlassian developer site: the language, its objects and their properties.
-
Acknowledge app access: let the field read data with the app's access.