Versions Compared

Key

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

Availability:

Status
colourBlue
titleJIra
Status
colourPurple
titleJira Service Management

Category:
Appanvil karma designer
summary
page{"premium":true,"name":"page","children":[{"id":"lfi8jBK4QX7bZqV_gWgeY","params":{"padding":20,"gap":10},"children":[{"id":"TLM0qAkS21eAyrXzza25j","name":"row","children":[{"id":"7VVCcyVt4__Q3wbGo5_7h","name":"column","children":[{"name":"spacer","params":{"space":10},"children":[],"id":"PNPLOWZmSWqoQr3nq4R79"},{"name":"image","params":{"templateId":"full-width rounded","alignment":"center","position":"center center","borderRadius":{"all":0,"bbl":0,"bbr":0,"btl":0,"btr":0,"isIndividualCorners":false},"image":{"value":"att48758825","target":"_blank","type":"attachment"},"shouldOpenDialog":false},"children":[],"id":"luZTmREfaPvOuFjw6_q8G"},{"name":"text","params":{"templateId":"simple paragraph","value":[{"type":"paragraph","children":[{"type":"paragraph","children":[{"fontSize":16,"lineHeight":"24px","color":"#555","letterSpacing":0,"text":"","fontFamily":"Open Sans, sans-serif"}]}]}]},"children":[],"id":"bAXmUwtxzdKMdPYinINK0"}],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"}},{"id":"ftVOrk9jIJtoVhdHfZEyc","name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"}},{"id":"6ZG9ySC-Rs_hwxvP7jmDG","name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"}},{"id":"ND7z7KISHm8WnxJ0zw-Ma","name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"}},{"id":"8JrFMoF7J8JyYIrKfO3US","name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"}},{"id":"8vJfH6Jr_tkXRYpjsGZE3","name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"}}],"params":{"layout":[1],"gap":10,"minHeight":200,"padding":20,"borderRadius":25,"backgroundColor":"#592360","size":"full","backgroundSize":"cover"}}],"name":"section"}],"id":"SK_jc3s-_GRiwqh2cB5Tn"}

Ever find yourself wondering about the time left to complete a task or needing a simple way to assess the urgency of your assignments?

Whether it's selecting a date from a calendar, manually setting a date, or linking to other due dates, you can set the due date as per your preference. The Due date field dynamically updates whenever you view or update the issue. It calculates and displays the difference between the current date and the due date right at your fingertips. The field is presented using SVG number fields, ensuring a straightforward and user-friendly representation of the remaining time.


Table of Contents
minLevel1
maxLevel2
outlinefalse
typelist
printablefalse

Field configuration

Info

Before starting the field configuration, please follow the instructions for creating custom fields

Create a Custom Field

Step 1: Set a name and description

Provide a good name for the new custom field. Make it descriptive, concise, and easy to understand for others who will use it. Avoid using ambiguous or overly technical terms.

Step 2: Setup color and size

Set a color for the field and set different colors for your value.

Step 3 (optional): Set dependent due date

Select an issue's date field that serves as the due date representation.


Field view and edit

Info

The time range is displayed in days (d), hours (h) and minutes (min).

A negative value indicates that the task is overdue based on the configured due date.


Related Use Cases

WSJF (Weighted Shortest Job First)Calendar field


Jira Service Management (JSM)

Warning

The Time in status field is currently not available for Jira Service Management.


JQL expression

The Due Date Countdown field can be accessed like this.

Code Block
${fieldName}.Time left: number

Find further information here https://support.atlassian.com/jira-software-cloud/docs/find-specific-issues/

Example: perform a search for all issues with a due date set within the next 10 days (= 864,000,000 milli seconds).

Code Block
"Due date countdown.Time left" < 864000000


Data Structure (Automation)

Info

Use Custom Fields custom fields with Automation automation (DRAFT)

Note

To ensure accurate calculations, it's essential to set both the impact and urgency values when configuring the priority. Failure to do so may result in inadvertent overwriting of value during recalculation processes.

To set the value via automation, you need to at least set the dueDate value. timeLeft and formattedTimeRange are set on the next rendering step in the issue view

Code Block
{
  "dueDate": Date,
  "timeLeft": number,
  "formattedTimeRange": string
}

Example: assume today is the 14th December 2023, the dueDate is the 24th December 2023.

timeLeft is the difference from those two dates in milliseconds, the formattedTimeRange is a formatted representation of that range.

Code Block
{
  "dueDate": "2023-12-24T10:38+0100",
  "timeLeft": 863952646,
  "formattedTimeRange": "09d 23h 59min"
}