getIssueFields

Owned by No Reply
Last updated: Oct 22, 2021 by Jonathan Muse

Looking for the documentation on the newest versions of SIL Engine and the Simple Issue Language for Jira 8 for Server/Data Center? Click here !

Availability

This routine is available starting with katl-commons 2.5.15 / 2.6.7.

This routine is available for Jira server and cloud deployment options.


Syntax

getIssueFields(issueKey)

or

getIssueFields(issueKey, getNullFields) 

Description

Returns a map with all standard and custom fields of an issue. The map contains pairs of field name and field values.

Parameters

Parameter name

Type

Required

Description

issueKey

string

Yes

Key of the selected issue.

getNullFieldsbooleanNoFlag for specifying whether the fields with null values should be retrieved too. If not specified, it defaults to "false".

Return type

string []

The return value is a string array containing all fields values for the selected issue. Each value can be retrieved from the array by key (the field id).

Example

Example 1

string[] fields = getIssueFields("DEMO-1");
return fields["summary"];

Example 2

We can use the routine to partially clone an issue by copying only some of the fields from the original issue:

string[] fields = getIssueFields("TP-1", true);
string issue = createIssue(fields["project"], fields["parent"], fields["issueType"], fields["summary"] + " - part 2");
%issue%.customfield_10000 = fields["customfield_10000"];
%issue%.description = "Partial clone of issue TP-1";
return issue;

See also