The Traffic Light custom field can be used in 2 ways:
- For continuous tracking from the start date to keep on incrementing the days elapsed without a known end date
- For grading the performance at the end by calculating the days elapsed with a known start and end date
Both can be done with the Calculate Days Elapsed for Traffic Light Post Function which initialises the information required for tracking the day elapsed.
Adding the Post Function
For the basics on setting up a workflow, please refer to JIRA's documentation on configuring workflows
To modify an existing workflow to include the Calculate Days Elapsed Post Function,
Select the workflow transition to perform the calculate days elapsed post function
It is possible to start tracking from the issue creation by adding the post function to the Create transition
- Click on Add post function and add a Calculate Days Elapsed for Traffic Light post function.
Fill in the settings for the post function
Traffic Light Custom Field The target Traffic Light custom field to update. Traffic Light Mode 7 modes: - Start: this will Start the target Traffic Light custom field value (include 1st day).
- Stop: this will Stop the target Traffic Light custom field value (ignored if existing Traffic Light SLA is already stopped).
- Clear: this will clear and reset the target Traffic Light custom field value.
- Resume: this will Resume SLA calculation for the target Traffic Light custom field value ONLY IF there are existing Traffic Light SLA value (ignored if existing Traffic Light SLA is already running).
- Start/Resume: this will Resume SLA calculation for the target Traffic Light custom field value if there are existing Traffic Light SLA value (ignored if existing Traffic Light SLA is already running) OR Start the target Traffic Light custom field value.
- Set: this will set the days elapsed from the Start till End date specified below (existing values will be replaced).
- Accumulate: this will retain any existing days elapsed value and add it to the days elapsed from the Start till End date specified below.
- e.g. An issue took 4 working days to resolve and the Traffic Light is stopped at 4 days, but after the issue has been closed for 2 days, it is reopened with Traffic Light set to Accumulate mode → after issue is reopened, the number of working days will start counting from 4 days.
Start Date The start date to calculate the days elapsed. If the date custom field value is null, the Traffic Light value will be cleared. End Date The end date to calculate the days elapsed to. If the date custom field value is null, the Traffic Light value will be cleared. - If it is Current Date, then the Traffic Light days elapsed will continue to update everyday.
- If it is Today, it will use the date and time when the post function was executed.
- For other date/datepicker custom fields, it will use the value provided at the point in time that the post function is triggered.
Exclude First Day
Whether to exclude the 1st day in the calculation. When ticked, it means to exclude the 1st day from the Start Date from counting as a working day. The default setting is to include the 1st day. Accumulate only if there is existing Days Whether to accumulate the days if there is no existing Traffic Light value. The default is set to accumulate regardless if there is existing SLA value. Types of Start/End Date Fields options (for Set and Accumulate Mode)
- Current Date - to continue counting the Traffic Light SLA until the next post function is executed
- Today - The date and time the post function was triggered
- System Date Fields - Issue's Created Date, Due Date, Resolution Date, Updated Date
- Custom Fields - Date Picker or Date Timer Picker custom fields added by administrators
Publish the workflow