Versions Compared

Key

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


Panel

On this page

Table of Contents
maxLevel2
exclude(On this page|Use case).*
stylecircle
typeflat
separatorpipe



UI Text Box
sizemedium
typeinfo

Use case

Within JWT, project properties can be used to add additional meta data to your project, that than be later referenced throughout JWT's features.

In the following use case we use a project property to define a user that is the only one who is allowed to execute specific transitions.


UI Expand
titleWhy should I use a project property for this?


UI Text Box
sizemedium
typetip

Why use a project property instead of defining the user to be checked against right in the condition/ validator itself?

By using a project property for defining the user to be checked against, the configuration can be reused in several transitions. If then the user changes, the username must only be adapted in one central spot instead of going through every transition and check the configuration.





Prerequisites

UI Expand
titleSet up the project property

In order to get the value of the project property later on in the condition or validator, the property has first to be created.

UI Steps


UI Step

Head over to the project you want to create the project property in.


UI Step

Head over to Project settings → Details


UI Step

Add the following text to the project description:

Code Block
linenumberstrue
{approver=<username>}


UI Text Box
typeinfo

Replace <username> with the actual username you want to set as approver.






Configuration

UI Steps


UI Step

Add the Validation of JWT project property or Condition on JWT project property to the desired transition or create a new transition.


UI Step

Property key

Enter the name of the project property:

Code Block
linenumberstrue
approver


UI Text Box
typeinfo

In this case we named the project property approver. If you use a different name, make sure to update the above expression accordingly.



UI Step

Property value

Enter the following expression:

Code Block
linenumberstrue
%{system.currentUser}



UI Step

Operator

Choose is equal

UI Text Box
typetip

This way the transition can only be executed by the approver. Any other user won't be able to do so.




Include Page
DECADIS:_snip_validator_only
DECADIS:_snip_validator_only

UI Expand
titleValidator only


UI Steps


UI Step

Error message

Enter the following expression in the Advanced text mode:

Code Block
linenumberstrue
"Only the approver (" + projectProperty("approver") + ") is allowed to execute this transition."


UI Text Box
typeinfo

The function used is projectProperty().






Screenshots

Image Added


Related use cases

Page properties report
firstcolumnUse case
headingsJWT feature, Workflow function, Parser functions, Label
sortByTitle
cqllabel = "use-case-workflow" and ancestor in ("32215651","32215785")


Excerpt Include
DECADIS:Contact support
DECADIS:Contact support
nopaneltrue


Page properties
hiddentrue




Page properties
hiddentrue



Status
Tech review

Status
colourGreen
titledone

Style guide

Status
titletodo

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