The Checklist custom field can be programmatically manipulated to extract and modify its data using the Simple Issue Language (SIL).
On this page:
Table of Contents | ||
---|---|---|
|
Note |
---|
This requires that both the Checklist for Jira SIL Connector and the SIL Engine for Power Suite apps already be installed in your Jira instance. |
Using checklists in SIL scripts
Checklist fields can be accessed in SIL scripts using their ID, name, or alias. For more information, see the Anova documentation.
Manipulating checklist items
Because Checklist yields an array of JSON values when queried, you can install the Checklist for Jira SIL connector. The connector adds a new structure to the SIL scripts named oChecklistItem
. The structure makes it easier to manipulate checklist items in SIL scripts without having to worry about the back-end JSON format.
oChecklistItem structure
Field | Type | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|---|
assigneeIds | String[] | A list of the usernames to which the item is assigned (only one assignee is currently supported).
| ||||||||
checked | Boolean | Whether the item is checked or not.
| ||||||||
dueDate | String | The due date of the item as an ISO string.
| ||||||||
globalItemId | Number | The internal unique ID of the global item to which this item is linked. When no ID is set, the item is considered to be a local item. | ||||||||
id | Number | The ID for the checklist item.
| ||||||||
isHeader | Boolean | Whether the item is a header or not.
| ||||||||
mandatory | Boolean | Whether the item is mandatory or not. | ||||||||
name | String |
The name of the checklist item.
| ||||||||
priorityId | String | The numeric priority ID of the item as a string.
| ||||||||
rank | Number | The rank of the item in the checklist, starting from 0. When the checklist is updated, the rank value is ignored, and the order in which the items are set in the array of checklist items is applied. | ||||||||
statusId | String | The status ID of the item.
| ||||||||
linkedIssueKey | String | The key of the issue resulting from an item-to-issue conversion. |
Note |
---|
Some values will be ignored until you activate the feature All feature-related fields can be set, but will be ignored when the checklist is loaded in Jira until their related settings are enabled. For instance, setting the |
Status | ||
---|---|---|
|