Page tree

Contents


JSU for Jira Server

This is the documentation of JSU for Jira Server. If you are using JSU on Jira Cloud, you can find the documentation here.

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.


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

(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.

You can specify a custom error message, which might better explain the situation to your users.

If you leave this field empty, a default error message will be displayed. However, that might be a bit too technical, making it difficult for you users to understand the validation error.

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

In its different modules (especially those for workflows), the JSU app supports many different field types. System fields, as well as custom fields.

However you should be aware, that not all field types are supported. Also not in all combinations. We think we cover the most important field types and still are continuously adding and improving which and how different field types are supported. But the one you need, might just not (yet) work. Some custom fields of other third party app might never get supported.

For that reason you should always test anything you do with the JSU app with fields. Before you buy a license for JSU, try it with a free evaluation license, if it works for you.

Precondition Configuration

Preconditions can be configured in a several ways:

  • A result of a precondition can be negated 
  • A result of a precondition can be combined with a result of previous preconditions using the following ways:
    • Discard the result of previous precondition (Results of the previous preconditions are not taken into account)
    • AND (All of the preconditions have to be true to allow execute a post function)
    • OR (Only one of the preconditions has to be true to allow execute a post function)