Versions Compared

Key

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


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



UI Text Box
sizemedium
typeinfo

Features used to implement this example:

Predicted due date of an epic

UI Text Box
iconfalse
typeinfo

Given the ..., provides a Predicted Due Date

Configuration

Use case

The prediction of the completion date of an epic is very useful for reporting and planning purposes. 

This use case calculates the predicted completion date based on cumulated remaining estimates of all issues linked to each epic.

To calculate the remaining estimates, a second calculated field will be used, which is explained in this use case: Total remaining estimate in an epic (all linked issues)


Image AddedConfiguration

steps
UI Steps


UI Step

Create a new Calculated Date-Time Field (by JWT) custom field and name it appropriately.

UI Text Box
typetip
Check JWT calculated date-time fields to learn the steps on how to add a calculated date-time field

Providing a description will help you to identify what the custom field does, but this step is optional.



ui-
ui-step
Click on Edit Math/Time

Parser expression

Image Removed

And click on Save

Add the following expression:

Code Block
languagebash
titleDate/Time expression for Calculated Date/Time field:
linenumberstrue
addTimeSkippingWeekends(%{system.currentDateTime}, {issue.cf10200
UI Text Box
typeinfo
The math expression used in this example is : addTimeSkippingWeekends({00057}, {10200
}*{DAY}, LOCAL, {FRIDAY}, {SATURDAY}
)


UI Expand
titlemore info...


UI Text Box
typeinfo

{issue.cf10200} is

Where {00057} is

the field code for

Current date and time and {10200} is the field code for custom field Epic Remaining

To achieve this, the following functions are used:

the calculated field Epic Remaining. See this use case on how to calculate this value: Total remaining estimate in an epic (all linked issues)

Additionally to the JWT calculated number field this example uses the addTimeSkippingWeekends() function.

addTimeSkippingWeekends()




UI Step

Click on Edit Display Format to configure the display format

Image Removed

UI Step

The display format should be configured as shown below

Image Removed


UI Steps

Display Format

UI Step

Format type

Choose Date Time Picker




UI Step

Add the field to the relevant view screens.

UI Text Box
typenote

Remember: All calculated fields are read-only and cannot be manually updated on a create or edit screen.



UI Step
UI Step

Check the results

Once configured and added to an issue screen (e.g. an epic), the result will look like this:




Image Added Related use cases

Page properties report
headingsField type, JWT feature, Label
sortByTitle
cqllabel = "calculated-field" and space = "JWTSDC" and ancestor = "27068727"


Excerpt Include
DECADIS:Contact support
DECADIS:Contact support
nopaneltrue


Page properties
hiddentrue


JWT feature

Image Added

Field typeDate-time
Parser functionsaddTimeSkippingWeekends()
Label

Status
colourRed
titlestaff pick