Document toolboxDocument toolbox

Set up project fields as project properties

Owned by Leo Díaz Murillo
Last updated: Feb 21, 2024 by Rita Fernández Madrazo
3 min read

Enabling Projectrak fields as properties will allow to:

  • Use project values to find issues in the JQL

  • Use project values in workflows using Jira Expressions

It is possible to enable fields as project properties for the following project field types:

  • Text

  • Date

  • Number (the project property won't include the prefix or suffix)

  • Status

  • Priority

  • List

  • User

Enable a field as a project property

Go to the field manager and once there, you can enable the field as a project property from the configuration buttons.

Before to enable the field as project property, you will se a message like this:

  • “View project values” permission will be ignored. By activating a field as property, its values will bypass Projectrak's permission “View project values”, so the information will be available in Jira, but remains restricted in Projectrak screens.

  • The field edition will be blocked after enabling a field as a project property.

🕒 Please note that this operation may take several minutes.

Disable a field as a project property

Go to the field manager and once there, you can disable a field as a project property from the configuration buttons.

🕒 Please note that this operation may take several minutes.

How to use a project property

Once you have enabled a field as project property, you can see the property name in the column called Project property name:

Use this name in the JQL or, alternatively, anywhere that can use project properties such as Jira Expressions.

Using project properties in the JQL (Jira Query Language)

Please, ensure you have enabled the field as project property.

Using properties in the JQL will allow you to find issues based on project values.

Start typing the word project and the JQL autocomplete will help you and you can complete with the name of your property.

Using project properties in Jira Expressions

Please be sure to review Atlassian's documentation on https://developer.atlassian.com/cloud/jira/software/jira-expressions/

Using properties in Jira Expressions will allow you to (for example) condition the workflow based on project values using scripting apps.

To access a project property from a Jira Expression you need to know the project property name, for example, ‘Projectrak status’. Below, you can see an example of JMWE using project properties in a Jira Expression in a workflow validation:

For more information, please review JMWE documentation https://appfire.atlassian.net/wiki/spaces/JMWEC/pages/466226183/Build-your-own+scripted+Validator