Values
Workflow Enhancer for Jira let’s you compare the value of a field or macro against different types of values, listed below:
String
Example | |
---|---|
any String has to be enclosed by " (quotation marks) |
|
Regular Expression
Example | |
---|---|
any regular expression has to be enclosed by / (forward slashes) |
|
|
|
+ matches the preceding element one or more times |
|
? matches the preceding element zero or one time |
|
( ) defines subexpression |
|
{n} matches the precending element exactly n times |
|
{min, max} matches the preceding element at least min and at most max times |
|
In the examples above ε always stands for the empty word. For example, in the case of /a?/
there can be either one "a" or no "a".
Field interpolation in Regular Expression
For your field to be evaluated in regex, you must use the {field_id} notation, as expressions of the type {field_name} will not be evaluated. For custom fields, this will be of the form {customfield_123}, for system fields, it is generally the name in lowercase with spaces and special characters removed, as per the table below. Note that, when inserting a field using the UI, it will show the {field_name} by default, and this must be converted to {field_id}.
Example | |
---|---|
A field in a regular expression is replaced by its value (as string) |
|
The value of the field is evaluated |
|
Use double curry brackets ( |
|
Custom fields are supported |
|
Use |
|
Use |
|
Both left and right curry braces need to be escaped. Regex like /\{abc}/
will not work.
System Field Name in English | Field ID |
---|---|
Description | description |
Summary | summary |
Issue Type | issuetype |
Priority | priority |
Resolution | resolution |
Version/s | versions |
Fix Version/s | fixVersions |
Component/s | components |
Labels | labels |
Environment | environment |
Linked Issues | issuelinks |
Attachment | attachment |
Assignee | assignee |
Reporter | reporter |
Due Date | duedate |
Time Tracking | timetracking |
Security Level | security |
Date
Example | |
---|---|
Date pattern: dd.mm.yyyy hh:mm |
|
|
|
The maximum date value is 31.12.2099 23:59
.
Timespan
Example | |
---|---|
Labor Timespan pattern: n1w n2d n3h n4min , where n1, n2, n3, n4 are non negative integers |
|
Real Timespan pattern: n1W n2D n3H n4MIN , where n1, n2, n3, n4 are non negative integers |
|
|
|
| Wrong: Right: 8 |
Workflow Enhancer for Jira works with the time tracker of your Jira such that a timespan of Jira is automatically a labor timespan. This also means that a date and timespan field cannot be added.
If the time tracker is disabled, we have 1 day = 8 hours and 1 week = 5 days.
So, if your Jira time tracker settings are 1 labour day = 24 hours and 1 labor week = 7 labor days, labor timespan and real timespans are the same.
Float
Example | |
---|---|
Pattern: d+(.d*)? or d*(.d+)? where d is an integer |
|
The Workflow Enhancer for Jira float data type works with negative values, but the parser does not support unary operations.