This function has been renamed with the JWT 3.0 release.
Find the new documentation at:
Purpose
There is a condition and a validator available for checking the value of a Project Properties. These features allows to hide a transition (condition) or block the execution of a transition if certain Project Properties doesn't contain an expected value.
These features are of great value for building reusable workflows, that behave somehow differently according to certain characteristics of the projects. Each particular characteristic of the project is set by means of a Project Properties.
Example: Allowing issue reopening in certain projects, while forbidding it in other ones
We are going to implement a validation for preventing issues to be reopened in projects where Project Properties "allowReopening" has value different from "Yes" or is missing.
We use Check project property validator in transition "Reopen Issue" using the following configuration:
Once configured, transition "Reopen Issue" looks like this:
The project property is created in project's description as shown:
Jira Workflow Toolbox provides a Expression Parser, which is used in the main features of the plugin. This parser provides a set of functions for checking the existence of a project property, and reading its value:
| FUNCTION | RETURNED VALUE |
|---|---|
| projectProperty(string property_name) : string | Returns a string with the value of project property with name property_name in current issue's project. Shows an error message if project property doesn't exist. Example: projectProperty("maxNumberOfReopenings") returns "3", provided there is a string {maxNumberOfReopenings=3} in the description of current issue's project. |
| projectProperty(string property_name, string project_key) : string Available since version 2.2 | Returns a string with the value of project property with name property_name in project with key project_key. Shows an error message if project property doesn't exist. Example: projectProperty("maxNumberOfReopenings", "CRM") returns "3", provided there is a string {maxNumberOfReopenings=3} in the description of project with key "CRM". |
| projectPropertyExists(string property_name) : boolean Available since version 2.2 | Returns true only if there is a project property with name property_name in current issue's project, i.e., if project's description contains a string like {property_name=value}. Example: projectPropertyExists("maxNumberOfReopenings") returns true only if there is a string like {maxNumberOfReopenings=x} in the description of current issue's project. |
| projectPropertyExists(string property_name, string project_key) : boolean Available since version 2.2 | Returns true only if there is a project property with name property_name in project with key project_key. Example: projectPropertyExists("maxNumberOfReopenings", "CRM") returns true only if there is a string like {maxNumberOfReopenings=x} in the description of project with key "CRM". |
The parser is a common feature, making Project Properties available in the main features of the plugin:
- Condition and Validator Boolean condition and validator with math. date-time or text-string terms
- Post-functions Set a field as a function of other fields, Copy parsed text to a field and Mathematical and date-time expression calculator
