Get started

Use case library

JWT expression editor

JWT expression parser functions

JWT workflow functions

JWT remote actions

JWT automation rules

JWT calculated fields

JWT calendars

JWT properties

JWT JQL functions

Cloud migration hub

Additional product info

Versions Compared

Old Version 5

changes.mady.by.user Iheb Kharab

Saved on

compared with

New Version Current

changes.mady.by.user Vicente Domínguez Navarro

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


What are JWT project properties?

The following screenshot shows Jira edit project details dialog with 5 examples of project properties:

Image Removed

codeReview: used to enforce or to make optional
UI Text Box
sizemedium
typeinfo

Project Properties is a simple mechanism implemented by Jira Workflow Toolbox, to include machine-readable JWT project properties are key-value pairs into projects description, using the format {property=value}, thereby operating as an effective way for adding metadata to your Jira projects.

UI Expand
titleExamples of project properties

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}

Image Added


The screenshot shows an example with 5 JWT project properties:

Property keyProperty valuePotential use case
codeReviewcompulsoryCould 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
: time elapsed since issue notification to first responders. Can be used to set alarms with JQL filters and subscriptions, to increase priority when the deadline approaches, etc.
  • technology: project technology. Can be used in auto-composed texts, workflow customization, JQL searches, etc.
  • database: database provider. Can be used in auto-composed texts, workflow customization, JQL searches, etc.
  • stageURL: URL of stage environment. Can be used to compose an auto-comment to inform the user where to test the solution before release. 
    • 30Could 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.
    technologyjavaCould be used in many JWT functions or expressions using the Advanced text mode.
    databaseoracleCould be used in many JWT functions or expressions using the Advanced text mode.
    stageURLhttps://stage/myappCould 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).


    Image AddedAvailable functions

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

    Page properties report
    firstcolumnFunction
    headingsShort description, Output
    sortByTitle
    cqllabel in ("miscellaneous","user_group_role_function") and space = currentSpace() and text ~ "project property"

    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:

    Page properties report
    firstcolumnFunction
    headingsShort description, Output
    sortByTitle
    cqllabel = "project-properties" and space = currentSpace() and ancestor = "27066670"

    Setting the default assignee for a project role

    You can use JWT project properties in the Assign to project role post function for setting a default assignee for a specific project role.


    Image AddedUse cases and examples

    Page properties report
    headingsJWT feature, Workflow function, Parser functions, Label
    cqllabel = "use-case" and parent = currentContent()

    Excerpt Include
    DECADIS:Contact support
    DECADIS:Contact support
    nopaneltrue


    Page properties
    hiddentrue


    Tech review

    Status
    colourGreen
    titledone

    Style guide

    Status
    colourGreen
    titledone

    Page status

    Status
    colourGreen
    titlecomplete

    Status
    titletodo
    Status
    colourYellow
    titleReady for review
    Status
    colourGreen
    titledone
    Status
    colourRed
    titleflagged

    Purpose of project properties

    Info

    Customizing workflow behavior depending on projects

    Project properties are initially aimed to customize your workflow behavior depending on project features