This is the documentation of JSU for Jira Server/Data Center. If you are using JSU on Jira Cloud, see our JSU Cloud documentation.
The 'Fields Required' checks whether values for specified fields are set for a given transition.
You must select mandatory fields when configuring the transition. For example:
JSU default behavior is to apply the context settings; this means that a field that is required by this check, but has no valid context for the current issue, won't be checked. Thus you may select to ignore the context, in that case, a field will be required by this check, even if its context is not configured for the current issue.
For information on how to configure a check in Jira, see the Jira documentation.
You can define a custom error message for JSU validators to provide a clear explanation of the situation to your users.
If you leave this field empty, a default error message from Jira will be displayed on validation errors. This might be a bit too technical, making it difficult for you users to understand the cause of the error.
A workflow is configured so that the 'Resolve' transition has the 'Fields Required' check where 'Fix Version' is mandatory. If a user attempts to resolve an issue on this workflow, where the 'Fix Version' field its value is not set, the check will fail and no action will be performed.
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.
Preconditions can be configured in 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 the 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)