Page History

Project properties are were initially aimed to customize at customizing your workflow behavior depending on project features (metadata added to projects in the form of project properties), this way highly improving workflow reusability.

For example you can use project properties to:

• Enable/disable transitions depending on project properties property values.
• Set project customized values for timelines (dates), costs, weights, or any other date or numerical values used in your workflows. Can also be used for implementing non-numerical or non-date attributes.
• Set priorities among projects, that may be inherited to by issues, for example by using priority adjustment tables.
• Provide project related metadata that may be used by the workflow post functions to compose project customized dynamic text, setting custom or virtual fields with project customized values, etc, e.g., customer information, servers URLs, etc.

Conditions and Validators

• Check Condition on project property: compare the value of a project property with a literal value, a custom or virtual field value, or a composed text, disabling a transition if the comparison fails.Post functions:
• Validation of JWT project property 
• Logical condition
• Logical validator

Post functions

• Set or create project property: updates the value of a project property, or creates it in case it doesn't exist. Works on the current issue's project, or on any project its key can be provided.
• Read a project property: read the value of a project property and store its value into a custom or virtual field. Works on the current issue's project, or on any project its key can be provided.
• Function in the boolean Expression Parser, which is used in many features of the plugin:
  Function "projectProperty(property_name)" is available in the plugin's parser for reading the value of project property. The parser is a common module of the plugin available for the following features of the plugin:
  • Condition "Boolean Condition with math, date-time or text-string terms"
  • Validator "Boolean Validator with math, date-time or text-string terms"
  • Post function "Set a field as a function of other fields" and "Mathematical and date-time expression calculator".
• Copy project property
• Update fields based on rules

Logical expressions

JWT project properties can be referenced and validated when writing a logical expression in the Logical mode (e.g in the conditional execution parameter of post functions).

You can ask for the value of project properties in your JQL queries, by using 3 JQL functions provided by Jira Workflow Toolbox:

• projectsWhereTextProperty( project_property, operator, string_literal | regular_expression )
• projectsWhereNumberProperty( project_property, operator, numeric_literal )
• projectsWhereDateProperty( project_property, operator, date_literal )

You can use it, among other things, to extend the Jira native Project Category concept, by creating several project classifications by using Project Properties.

One of the two ways available in post-function "Assign to project role" for setting default assignee for a project role uses Project Properties with a certain format.

Setting user "feynman" as default assignee for project role "Developers", with internal identifier 10100. As you can be seen in the picture, you can use the name of the project role, or the internal identifier as the project property name. The second option has the de advantage that it's immune to project role renaming.