Versions Compared

Old Version 1

changes.mady.by.user Jennifer Choban

Saved on

compared with

New Version 2

changes.mady.by.user Jennifer Choban

Saved on

Key

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

Global Checklists are currently in BETA and will be available in Issue Checklist for Jira

Status
colourBlue
titleenterprise
once released. Contact our support team if you currently use Issue Checklist for Jira
Status
colourPurple
titlePRO
would like to participate in the Beta.

Table of Contents

Checklist Completed Field

The Checklist Completed field is a single line text field with a value of “All Completed” or “Not Completed”. The field only stores the completion status of local checklists associated with the issue, not global checklists.

Initial State

When the issue is created, the Checklist Completed field is null if the issue does not have a checklist. Once a checklist is added to the issue, the field is updated based on the completion status of the items on local checklist(s). If the checklist is removed from the issue, the field will be automatically set to "All Completed".

More Details

  • Save local checklist items to Jira custom fields must be enabled.

  • Not available in Team-managed (Next gen) projects.

  • If there are multiple checklists on the issue and any of them are incomplete, the field will be set to “Not Completed”.

  • The field is automatically kept in sync and users should not edit the field value. 

  • Changes to the field trigger issue-updated event which can start Automation rule automatically.

Image RemovedImage Removed

View file
nameInvalid file id - UNKNOWN_MEDIA_ID
View file
nameInvalid file id - UNKNOWN_MEDIA_ID

Uses

How to Find the Custom Field ID

When using custom fields with automation, scripts, etc. you may need the ID number of the custom field.

Excerpt
nameCustomFieldId

To find the ID of the custom field:

  1. Log in as a Jira Administrator.

  2. Go to Jira Settings > Issues > Custom fields.

  3. Search for the indicated custom field.

  4. Click the More menu (…) and select Edit Details.

  5. Copy the URL of the page. The URL will end with the ID number of the custom field.

    Image Removed
    View file
    nameInvalid file id - UNKNOWN_MEDIA_ID
Note

Custom fields can be duplicated by some errors or rare scenarios. If you are experiencing issues with accessing custom fields, make sure you are referencing the custom field that is currently used by Issue Checklist.

Using REST API
Getting custom field IDs using Jira Rest API is a fairly easy process. By using the REST API request, you can easily obtain the custom field ID. Here is an example REST API request (you can open using web browser):

Status
titleGET
https://test-instance.atlassian.net/rest/api/3/field/search?type=custom&query=Checklist

You can run the request using a web browser. However, please keep in mind that this requires administrative privileges, which means that you need to be logged in to an administrator account to run the request successfully.

The result of this request will contain the custom field ID that you're looking for. The response will include a values array that contains a list of custom fields. Each custom field in the array will have an id attribute that you can use to identify it.

It's important to note that the description information in the response can help you identify fields from other plugin versions. This information can provide context about the purpose of the field, allowing you to determine if it's the one you're looking for.

Example result:

Code Block
languagejson
{
  "maxResults": 50,
  "startAt": 0,
  "total": 2,
  "isLast": true,
  "values": [
    {
      "id": "customfield_10034",
      "name": "Checklist Completed",
      "schema": {
        "type": "string",
        "custom": "com.atlassian.jira.plugin.system.customfieldtypes:textfield",
        "customId": 10034
      },
      "description": "Do not delete. Custom field with Checklist completion status. Automatically created and managed by Issue Checklist Pro (Sandbox)."
    },
    {
      "id": "customfield_10099",
      "name": "Checklist Completed",
      "schema": {
        "type": "string",
        "custom": "com.atlassian.jira.plugin.system.customfieldtypes:textfield",
        "customId": 10099
      },
      "description": "Do not delete. Custom field with Checklist completion status. Automatically created and managed by Issue Checklist Free."
    }
}