Versions Compared

Key

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

This document lists the expected text/raw input value that should be provided to set Jira Standard and Custom fields. The easiest is to use the "Expected Value" tab of the Groovy editor help system. It lists the possible expected values for the selected Field and Value Type. This is applicable in contexts where you set a field value or comment an issue or write a conditional Groovy script. Select the Field and Value Type as Set field value to constant or Groovy template. Click on Expected Value. The help editor displays the expected text/Groovy templates values for the selected field.

You might also want to look at Standard fieldsPredefined custom fields, and User-created custom fields to know how to access the fields of an issue object.

...

 Field Name

Expected input value

Examples

Affects Version/s
  • Version name or id (id takes precedence over the name) should be provided
  • To set multiple values, you should provide version names or ids (idtakes precedence over the name) separated by a comma.
  • 2.0
  • 10000
  • 2.0,3.0
  • 10020,V1

Assignee

Any of the following user detail should be provided:

  • Username
  • Email address
  • Full name
Note

It is recommended you use Username(s) because Email address(es) and Full name(s) are not unique in Jira.



Component/s
  • Component name or id (idtakes precedence over the name) should be provided
  • To set multiple values, you should provide component names or ids (id takes precedence over the name) separated by a comma.
  • C1
  • C1,C2
  • 10000

DescriptionAny simple single/multi-line text should be provided
  • Test
  • Testing of
    First project
    Second project

Due DateString representing a timestamp in theformat specified in Jira system settings.

11/Apr/17


EnvironmentAny simple single/multi-line text should be provided

QA Environment


Fix Version/s
  • Version name or id (id takes precedence over the name) should be provided
  • To set multiple values, you should provide version names or ids (id takes precedence over the name) separated by a comma
  • 2.0
  • 2.0,3.0
  • 10020

Issue type


Note

Use with caution!

Changing the issue type should only be done if the current and new issue types share the same workflow, or if the issue's Status exists in both the current and new workflow. Otherwise, the operaton will fail.

Also, when changing the issue type of the current issue, make sure to move the post-function below the "Set issue status to the linked status of the destination workflow step" built-in post-function.

String representing the issue type name or id

  • Bug
  • 10020
Labels
  • String representing a label should be provided.
  • To set multiple labels, you should provide values separated by space.
  • NewLabel
  • Label1 Label2 Label3

Original EstimateNumber representing the estimate in seconds or a duration string should be provided.
  • 36000
  • 3w 2d
  • 2w 4d 5h 50m

Priority

Priority name or id (id takes precedence over the name) should be provided

  • High
  • 2

Remaining EstimateNumber representing the estimate in seconds or a duration string should be provided.
  • 36000
  • 3w 2d
  • 2w 4d 5h 50m

Reporter

Any of the following user detail should be provided:

  • Username
  • Email address
  • Full name
Note

It is recommended you use Username(s) because Email address(es) and Full name(s) are not unique in Jira.



ResolutionResolution name or ID (id takes precedence over the name) should be provided
  • Won't Do
  • 11212

Security levelSecurity level name or id (id takes precedence over the name) should be provided
  • QA1
  • 10001

Status


Note

Use with caution!

Changing the Status of an issue is normally done only through an issue transition. Changing the Status field value directly will not validate potentially required fields (such as the Resolution field), and will leave no trace in the issue history. This should be used only in specific cases.

Also, when changing the Status of the current issue, make sure to move the post-function below the "Set issue status to the linked status of the destination workflow step" built-in post-function.

Finally, the Status field cannot be set during a Create transition.

String representing the status name or status id


  • Open
  • 10020


  • Open
  • 10020
SummaryAny simple single/multi-line text should be provided

This is the summary of the issue


Time SpentNumber representing the time spent in seconds or a duration string should be provided.
  • 36000
  • 3w 2d
  • 2w 4d 5h 50m

Votes
  • Any of the following user detail should be provided:

    • Username
    • Email address
    • Full name
  • To set multiple values, you can provide a combination of user details (as mentioned above) separated by a comma.
Note

It is recommended you use Username(s) because Email address(es) and Full name(s) are not unique in Jira.



Watchers
  • Any of the following user detail should be provided:

    • Username
    • Email address
    • Full name
  • To set multiple values, you can provide a combination of user details (as mentioned above) separated by a comma.
Note

It is recommended you use Username(s) because Email address(es) and Full name(s) are not unique in Jira.



...

 Field Name

Expected input value

Examples

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
SprintString representing the ID of the sprint should be provided.

1

Story pointsString representing the number of story points should be provided

5

Jira Service Desk fields

 Field Name

Expected input value

Examples

Approvers
  • Any of the following user detail should be provided:

    • Username
    • Email address
    • Full name
  • To set multiple values, you can provide a combination of user details (as mentioned above) separated by a comma.
Note

It is recommended you use Username(s) because Email address(es) and Full name(s) are not unique in Jira.



Customer Request Type
  • Customer Request Type name or internal ID
  • IT help
  • sd/desktoplaptopsupport
Organizations
  • Organization name ID should be provided.
  • To set multiple values, you should provide the Organization names or IDs separated by a comma.
  • Org1
  • Org1,Org2
  • 1
  • 1,33
Request Participants
  • Any of the following user detail should be provided:

    • Username
    • Email address
    • Full name
  • To set multiple values, you can provide a combination of user details (as mentioned above) separated by a comma.
Note

It is recommended you use Username(s) because Email address(es) and Full name(s) are not unique in Jira.



...