Versions Compared

Key

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

This document lists the expected text input value that should be provided to set Jira Standard and Custom fields. You might also want to look at Standard Jira fields, Predefined Custom fields and User-created custom fields to know This document lists the expected text input value that should be provided to set Jira Standard and Custom fields. You might also want to look at Standard Jira fields, Predefined Custom fields and User-created custom fields to know how to access the fields of an issue.

...

 Field NameExpected input valueExamples
Affect Version/s

Version name(s) or ID(s) should be provided. You can add multiple versions by typing them separated by commas.

To obtain the ID of a version, use this REST API call that returns all version details in a project:

https://{yourdomain.atlassian.net}/rest/api/2/project/{projectIdorprojectKey}/version

Note

When you set an input value using the ID(s) you need to prefix it with "id". For example: id:10101.


  • 2.0
  • 2.0,3.0
  • id:10011
  • 1.0, id:10111
Assignee

AccountId should be provided, or empty string for Unassigned

accountId:557058:3a41d4ee-3331-4363-8cdf-f90a2da92f7e

AttachmentsAttachment URL should be provided. You can add multiple attachments typing the URL's separated by commas.
Components

Component name(s) or ID(s) should be provided. You can add multiple components by typing them separated by commas.

To obtain the ID of Componentsnavigate to the field configuration, edit the field and look at the end of the page URL in the navigation bar to find the ID.

Note

When you set an input value using the ID(s) you need to prefix it with "id". For example: id:10101.


  • C1

  • C1,C2

  • id:20500

  • C3, id:20100
DescriptionAny simple single/multi-line text should be provided
  • This is a description
Due DateDate in ISO_8601 format
  • 2016-08-05
Environment Any simple single/multi-line text should be provided
  • This is the QA Environment
  • QA
Fix Version/s

Version name should be provided. You can add multiple versions by typing them separated by commas.

  • 2.0
  • 2.0,3.0
Issue TypeIssue Type name should be provided.
  • Bug
  • Task
-line text should be provided
  • This is a description
Due DateDate in ISO_8601 format
  • 2016-08-05
Environment Any simple single/multi-line text should be provided
  • This is the QA Environment
  • QA
Fix Version/s

Version name(s) or ID(s) should be provided. You can add multiple versions by typing them separated by commas.

To obtain the ID of version, use this REST API call that returns all version details in a project:

https://{yourdomain.atlassian.net}/rest/api/2/project/{projectIdorprojectKey}/version

Note

When you set an input value using the ID(s) you need to prefix it with "id". For example: id:10101.


  • 2.0
  • 2.0,3.0
  • id:10102
  • 1.0, id:10111
Issue Type

Issue Type name or ID should be provided.

To obtain the ID of Issue Typenavigate to the field configuration, edit the field and look at the end of the page URL in the navigation bar to find the ID.

Note

When you set an input value using the ID(s) you need to prefix it with "id". For example: id:10101.


  • Bug
  • Task
  • id:10010
Labels

Any simple text should be provided. You can add multiple labels by typing them separated by spaces.

  • NewLabel
  • Label1 Label2 Label3
  • 1 2 3
Linked IssuesYou cannot set this field using a text value. See JSON input for fields to set this.NA
Original Estimate

A Number of seconds or a duration string.

  • 25200
  • 3w
  • 4w 2d 1h
Priority
Priority name or ID should be provided.
To obtain the ID of Prioritynavigate to the field configuration, edit the field and look at the end of the page URL in the navigation bar to find the ID.


Note

When you set an input value using the ID(s) you need to prefix it with "id". For example: id:1.


  • Highest
  • Low
  • id:4
Remaining Estimate

A Number of seconds or a duration string.

  • 25200
  • 3w
  • 4w 2d 1h
Reporter

Username should be provided.

  • carter
Resolution

Resolution name or ID should be provided.

To obtain the ID of Resolutionnavigate to the field configuration, edit the field and look at the end of the page URL in the navigation bar to find the ID.

Note

When you set an input value using the ID(s) you need to prefix it with "id". For example: id:10000.


  • Won't Do
  • DuplicateDuplicate
  • id:10000
Security level

Security level name or ID should be provided.

Note

When you set an input value using the ID(s) you need to prefix it with "id". For example: id:10001.


  • QA Domain
  • Security Level for Dev
  • id:10001
SummaryAny single-line text should be provided
  • Credit Card issue module
Time TrackingYou cannot set this field using a text value. See JSON input for fields to set this.
NA
Watchers

AccountId should be provided. You can add multiple users by typing them separated by commas.

  • accountId:557058:3a41d4ee-3331-4363-8cdf-f90a2da92f7e
  • accountId:557058:3a41d4ee-3331-4363-8cdf-f90a2da92f7e,accountId:557356:3a41d4ee-3331-4363-8cdf-f90a2da925e8

Predefined Custom fields

Note that while setting the Customer Request Type
 Field NameExpected input valueExamples
Account

Account ID or name should be provided. To obtain the Account ID navigate to the Account and look at the end of the page URL in the navigation bar to find the ID, as shown below.

Eg: https://test.atlassian.net/plugins/servlet/ac/io.tempo.jira/tempo-accounts#!/account/2/

  • 1
  • NewYork Account
ApproversAccountId should be provided. You can add multiple users by typing them separated by commas.
  • accountId:557058:3a41d4ee-3331-4363-8cdf-f90a2da92f7e
  • accountId:557058:3a41d4ee-3331-4363-8cdf-f90a2da92f7e,accountId:557145:3a41d4ee-3331-4363-8cdf-f90a2da926h9
All Capture for Jira fieldsAny simple single/multi-line text should be provided

All the Capture for Jira fields expect a text value.

Customer Request Type

The Customer Request Type ID or name should be provided. To obtain the Customer Request Type ID

  • Manually set the Customer Request Type for an issue
  • In the Nunjucks tester, test for the id of the Customer Request Type for the issue: {{ issue.fields['Customer Request Type'].requestType.id }}
Note

Note that

you can set

when setting the Customer Request Type

field only in the 

in the Create issue

 post-function using the Set fields of new issue option.
Note

 post-function, you must provide a value for 

any

every field that is declared as mandatory for that request type.


  • 41
  • Travel Request
Epic ColorAny simple single/multi-line text should be provided
  • ghx-label-6
Epic LinkIssue KEY of an Epic should be provided.
  • TEST-300
  • TP-33
Epic NameAny simple single/multi-line text should be provided
  • Creation of a new issue
Epic StatusStatus value should be provided
  • To Do
  • Done
Flagged

Option value should be provided.

  • Impediment
Organizations

The value should be a comma-separated list of Organization names or IDs. To obtain an Organization ID, navigate to the Organization and look at the end of the page URL in the navigation bar to find the ID, as shown below: 

Eg: https://test.atlassian.net/projects/PSDF/organization/1

  • 1
  • 1,33
  • Org 1, Org 2
  • Org 1, 4


Raised duringSession ID should be provided. The session ID can be obtained from the URL when you view the session. To obtain the Session ID navigate to the Session and look at the end of the page URL in the navigation bar to find the ID.
  • 10011
Request ParticipantsAccountId should be provided. You can add multiple users by typing them separated by commas.
  • accountId:557058:3a41d4ee-3331-4363-8cdf-f90a2da92f7e
  • accountId:557058:3a41d4ee-3331-4363-8cdf-f90a2da92f7e,accountId:557145:3a41d4ee-3331-4363-8cdf-f90a2da926h9
Satisfaction DateDate in ISO_8601 format
  • 2016-08-05
Sprint

Sprint ID should be provided. 

(info) To identify the Sprint ID, add the Sprint to an issue and use the Nunjucks Script tester with the following template: {{issue.fields["Sprint"] }} and look at the id field in the result.

  • 3
  • 12
Story pointsAny number
  • 3.1
  • 10

Team

Team ID should be provided. To obtain the Team ID navigate to the Team and look at the end of the page URL in the navigation bar to find the ID, as shown below.

Eg: https://test.atlassian.net/plugins/servlet/ac/io.tempo.jira/tempo-teams#!/team/2

  • 3
  • 1 (for the default team)
Team (Portfolio)

Team ID should be provided. 

(info) To identify the team ID, add the Team to an issue and use the Nunjucks Script tester with the following template: {{ issue.fields.Team }}

Note
titleLimitations when setting this field

You cannot clear this field, nor set it if it already has a value. This is due to JIRA Portfolio bugs.


  • 3
  • 1
Test SessionsSession ID should be provided. You can add multiple sessions by typing them separated by commas. To obtain the Session ID navigate to the Session and look at the end of the page URL in the navigation bar to find the ID.
  • 10011
  • 10012, 10013

...

Custom field typeExpected input valueExamples
Check boxes / Multi select list

Option value(s) or id(s) should be provided. You can add multiple options by typing the value(s) or id(s) separated by commas. 

Note

When you provide the id(s) you need to prefix it with "id". For example: id:10209

To obtain an option ID, you can go to the custom field configuration, navigate to the Option, edit it and look at the end of the page URL in the navigation bar to find the ID.

  • choice1
  • choice2,choice3
  • id:10209,id:10206


Radio buttons / Single select list

Option value or id should be provided

Note

When you provide the id you need to prefix it with "id". For example: id:10209

To obtain an option ID, you can go to the custom field configuration, navigate to the Option, edit it and look at the end of the page URL in the navigation bar to find the ID.

  • Option1
  • Option2,Option3
  • id:10204


Select list (cascading)

Parent value or id - Child value or id should be provided to set both the parent and child levels. To set just the parent, you should provide only the parent value or id.

Note

When you provide the id you need to prefix it with "id". For example: id:10209

To obtain the parent or child ID, you can go to the custom field configuration, navigate to the parent or child, edit it and look at the end of the page URL in the navigation bar to find the ID.


  • Parent and child values:
    • 2 - 2.1
    • OS - Z/OS
    • id:10200 - id:10202
  • Parent value only:
    • 2
    • OS
    • id:10200


Single Group PickerGroup name should be provided
  • Group1
Multi Group PickerGroup name should be provided. You can add multiple groups by typing them separated by commas.
  • Group1
  • Group1,Group2
Project Picker (single project)Project key should be provided
  • TEST
User Picker (single user)
AccountId should be provided.

accountId:557058:3a41d4ee-3331-4363-8cdf-f90a2da92f7e

User Picker (multiple users)AccountId should be provided. You can add multiple users by typing them separated by commas.
  • accountId:557058:3a41d4ee-3331-4363-8cdf-f90a2da92f7e
  • accountId:557058:3a41d4ee-3331-4363-8cdf-f90a2da92f7e,accountId:557145:3a41d4ee-3331-4363-8cdf-f90a2da926h9
Version Picker (single version)
Version name should be provided.
  • 2.0
Version Picker (multiple versions)Version name should be provided. You can add multiple versions by typing them separated by commas.
  • 2.0,3.0
Text Field (single line)Any simple single text should be provided
  • Testing in progress
Text Field (multi line)Any simple single/multi-line text should be provided
  • Description:
    Development in progress
Text Field (read only)Any simple single/multi-line text should be provided
  • This is a regression test
URL FieldText representing a URL should be provided
Number FieldNumber should be provided
  • 30
LabelsAny simple text should be provided. You can add multiple labels by typing them separated by spaces.
  • NewLabel
  • Label1 Label2 Label3
  • 1 2 3
Date pickerText representing a date should be provided
  • 2017-02-21
Date Time PickerText representing a date/time should be provided
  • 2017-02-21T10:20:00.000+0100

...