JWT project properties

JWT project properties are key-value pairs added to a project description.

The main goal of the properties is to provide project metadata, which can be referenced and used in multiple JWT features.

Format of JWT project properties

A JWT project property can be added to any project description in the following format:

{propertyKey=propertyValue}

The screenshot shows an example with 5 JWT project properties:

Property key	Property value	Potential use case
codeReview	compulsory	Could be used to enforce certain parts of the workflow related to code reviews using Condition on JWT project property or Validation of JWT project property.
maxResponseTime	30	Could be used to set individual SLA times per project. These could be used in combination with JWT JQL functions to set up filter subscription or to automatically update an issue priority using an Update field action.
technology	java	Could be used in many JWT functions or expressions using the Advanced text mode.
database	oracle	Could be used in many JWT functions or expressions using the Advanced text mode.
stageURL	https://stage/myapp	Could be used in many JWT functions or expressions using the Advanced text mode.

JWT project properties and workflows

Project properties were initially aimed at customizing your workflow behavior depending on project features (metadata added to projects in the form of project properties).

For example you can use project properties to:

Enable/disable transitions depending on project property values.
Set project customized values for timelines (dates), costs, weights, or any other date/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 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

Post functions

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

Available functions

JWT provides special parser functions to work with JWT project properties.

Function	Short description	Output
defaultUserForRole()	Returns the user name of the default project role user.	TEXT
isActive()	Checks whether users are active	BOOLEAN
projectCategory()	Returns the project category of a given project.	TEXT
projectProperty()	Returns the value of a given project property.	TEXT
projectPropertyExists()	Checks whether a project property exists.	BOOLEAN

JWT project properties and JQL

You can use JWT project properties in JQL queries, by using any of the JQL functions provided by Jira Workflow Toolbox:

Function	Short description	Output
projectsWhereDateProperty()	Returns projects with specific properties containing a date	TEXT LIST
projectsWhereNumberProperty()	Returns projects with specific numeric properties.	TEXT LIST
projectsWhereTextProperty()	Returns projects with specific text properties.	TEXT LIST
usersWithDateTimeProperty()	Returns users with specific date or date-time properties.	TEXT LIST