Description
The regular expression based pattern matching conditioning is a powerful way to do workflow automation by giving the workflow designer a way to control whether actions should be done or not based on the issues related to the transition.
Pattern matching conditioning
This takes advantage of the Substitution variables to provide a very flexible way to condition based on matching issue information with a regular expression (regex). This may be a little bit more complex/less usable for simple cases, but can be very powerful for covering many use cases. The simple cases can still be done with little knowledge of regular expressions. All the standard Substitution variables can be used.
Regex qualifiers
Qualifiers are used to make is easier to construct a regex pattern that matchers the user scenario.
Exact
When looking for patterns, one can either find something that matches the pattern or you can do an exact match on the pattern. Doing find is usually easier and covers most use cases, but is not as precise as doing an exact match. The default is Find. Select the Exact checkbox if needed to be more precise.
Value | Pattern | Find | Exact Match |
---|---|---|---|
abc | abc | ||
abc | ab | ||
abc | ac | ||
abc | b | ||
abc | .*b.* |
Literal
Regex has various characters that have special meaning. These characters need to be escaped (using \) if you want the character to not have special meaning. In some cases, you want to ignore all special character meaning and match on the literal string. Use the Literal checkbox to treat the pattern as a literal string.
Value | Pattern | Normal | Literal |
---|---|---|---|
abc | .bc | ||
.bc | .bc | ||
abc | abc* | ||
ab | abc* | ||
ab | abc+ |
Negative
Regex can be difficult when you want to condition on something not matching. The Negative checkbox makes it easy to reverse the condition so that the condition is true if the match is false and vice versa.
Value | Pattern | Normal | Reverse | Notes |
---|---|---|---|---|
abc | abc | |||
xyz | abc | |||
\S+ | Use Exact to make sure there is no match on a value containing a blank with other characters |
Case sensitivity
Regex patterns, by default, are case sensitive. Use the embedded flag (?i) to get case insensitive matching.
Value | Pattern | Normal |
---|---|---|
ABC | abc | |
ABC | (?i)abc |
Or conditions
Value | Pattern | Normal | Notes |
---|---|---|---|
a | a|b | ||
b | a|b | ||
abc | (abc)|(xyx) | Use ( ) or (?: ) for grouping |
Related information
-
Pattern match condition (One Appfire Support Knowledge Base)
-
How to use pattern matching conditioning (One Appfire Support Knowledge Base)
-
How to condition the creation of issues (One Appfire Support Knowledge Base)
-
How to condition with multi-value fields (One Appfire Support Knowledge Base)
-
How to condition issue creation (One Appfire Support Knowledge Base)
-
How to add condition to a blank or empty field (One Appfire Support Knowledge Base)
-
How to debug condition configurations (One Appfire Support Knowledge Base)
-
How to use regular expressions (Information)
-
How to use pattern matching conditioning (Update on Transition for Jira)
-
Pattern match condition (Create on Transition for Jira)
-
Pattern match condition - Cloud (Create on Transition for Jira)
-
Debug condition configurations (Create on Transition for Jira)
-
Define condition based issue creation (Create on Transition for Jira)
-
Add condition to a blank or an empty field (Create on Transition for Jira)
-
How to condition with multi-value fields (Create on Transition for Jira)
Tips
What if I don't need conditions?
Just leave blank (default).
Regex references
- Java pattern - concise summary of regex pattern syntax and special characters
- Regex expressions - reference
Watch out for regex reserved characters
Unless you use literal, you need to be sure any regex reserved characters you use are intentional.
Examples: * + ( ) { } |
Test your regex interactively before you implement your workflow conditions using one of the regex testing websites like: RegexPlanet.
Conditions must both be met
If more than one condition is specified, both must be satisfied (the conditions are anded). Most OR conditions can be done through a single (more complex) regex pattern. See the tip below.
What if I have more than 2 conditions?
Regex patterns can be constructed to handle many situations that involve multiple comparisons.
Example
Value | Regex |
---|---|
Priority: %original_priority%, Status: %original_status% | Priority: (Blocker|Critical|Major), Status: (Open|In Progress) |