| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
| Note | ||||||
This field will be no longer availabel be available in version 5.0.112 113 and higher. Instead, the field functionality is now available within a separate and free app, STAGIL Traffic Lights. To retrieve field values via the new app, a Traffic Light (calculated type) field needs to be manually configured. |
| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
How to Create an Assets Traffic Light Field
...
Go to JIRA Administration → Issues → Custom Fields → Add Custom Field and choose STAGIL Assets Traffic Light.
...
Type a Name and optional a Description. Press Create.
...
Select ⚙️ → Issues.
Under FIELDS, select Custom fields.
Click Create custom field. Make sure to select All to filter down the STAGIL field.
Find the Assets Traffic Lights field, select the type you want to create and click Next.
Add a Name for your field and an optional Description → Next.
Configure field context → Create.
Add the new custom field to one or multiple screens by ticking the corresponding box and clicking Update.
...
How to Configure an Assets Traffic Light Field
Go to your Find the custom field and click configure on the right side. Click Edit Stagil Assets Traffic Light.
...
Now you have the configuration screen.
...
Issue Source
Here you can choose JQL, current issue or based on relation of current issue. By defining the source of issues, you define the amount and type of issues, that you want to filter in the next stepyou want to configure, click the 3 dot menu, → select Configure. Then select Edit STAGIL Traffic Lights to open the following page:
...
Issue Source
Issue Sourcedefines the issue scope to run the query through and validate the values for the Traffic Lights field:
Issue Source = Current Issue: used to run queries about the field values within the current issue.
Example:
🟥 IF the date in the Start Date field is occurring before today’s date, THEN the Traffic Light field red
🟨 IF the date in the Start Date field is occurring one day from now, THEN the Traffic Light field is yellow
🟩 IF the date in the Start Date field is occurring two weeks after today’s date, THEN the Traffic Light field is green
...
Issue Source = JQL. ‘JQL’ refers to an option to define a scope of issues via a JQL query and validate them through custom conditions. Consequently, the query results define the Traffic Lights values.
Example:
Issue scope: project = “Open Space Project” AND issuetype = “Story”
🟥 IF more than 1 issue within the scope is unassigned, THEN the Traffic Light field red
🟨 IF more than 1 issue within the scope is “Waiting for Approval”, THEN the Traffic Light field yellow
🟩 IF there is no issue in status category “In progress” or “To Do”, THEN the Traffic Light field green
Issue Source = Links of Current Issue. Select an issue link as a base for the JQL query. The query will run through all issues associated with the current issue through the selected link type.
Light/Condition/Order
Here, you can define conditions for each light , based on your selected issue source above. First, you define the JQL and then, optionally, the quantity number of issues which that trigger the color of the light's colour. For example: If , if there are more than 5 issues within the defined JQL queue, they all will be marked with a red traffic light. Besides this, you can rearrange the order of the colors colours by sorting them up or down.
...