Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Excerpt

Description

The 'Regular Expression Check' compares the value of a text, number or url's field against a regular expression. For example to verify that the content matches a given format.

Configuration

You must select the field to be checked and enter the regular expression. For example:

  • [0-9]{4}-[0-9]{4} would allow numbers such as: 1245-7783
  • [0-9]+ EUR$ would allow price tags such as: 34 EUR
  • [a-z]* would allow an empty string, or any lower case word such as: yellow
  • Option [A,B] would allow a selection of options: Option A, Option B or both.

Detailed Documentation on Regex can be found here:  https://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html It is quite technical though. A good website that could help further is https://www.freeformatter.com/java-regex-tester.html where you can test them and also have a less technical documentation with examples. Hope this helps.


For information on how to configure a check in JIRA, see the JIRA documentation.

(info) If the field is a multiline text field, the text will be split on the newline character before applying the expression to each token. The HTML editor may add an additional newline character when pressing the "enter" key.

(info) Be careful what kind of regular expressions you are using. Some might be exploited by a malicious person. See ReDoS . It is your responsibility as JIRA administrator to only use safe regular expressions.

Include Page
Custom Error Message
Custom Error Message

Example

A workflow is configured so that the 'Resolve' transition has the 'Regular Expression Check' where 'TextField' has to match '[a-z]*'. If a user attempts to resolve an issue on this workflow, where the 'TextField' is for example '7 pieces', the check will fail, and no action will be performed. However 'pieces' as content would be allowed.

Supported Field Types

Include Page
Supported Field Types
Supported Field Types

...