Versions Compared

Key

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


Info
titleAvailability

This routine is available starting with SIL Engine™ 4.6.3.

Table plus
applyColStyleToCelltrue
heading0
columnTypess,s,s,s
multiplefalse
columnAttributesstyle="background:#e5e7ea;font-weight:bold,,style="background:#e5e7ea;font-weight:bold,
enableSortingfalse

Syntax

admGetCustomFieldOptions(fieldName, projectKeys, issueTypes)

Package

Alias

Pkg Usage

Description

Excerpt
hiddentrue
Retrieves the option list of a custom field for the specified context (projects and issue types).

Retrieves the option list of a custom field for the specified context (projects and issue types).

All parameters are required, but if the project keys and issue types arrays are empty, the global context is going to be used.

Each option will reside on a separate line. In case of cascade selects, the child options will be prefixed with a space character.

The new line  separator is system dependent (where the system can be Windows, Mac or Linux. The line separator can be either '\n', '\r' or '\r\n'.
This routine only handles custom fields of the following types: single select, multi select, radio buttons, checkboxes and checkboxes and cascading selects.

Parameters

Table plus
applyColStyleToCelltrue
columnTypess,s,s,s
heading0
multiplefalse
enableSortingfalse

Parameter name

Type

Required

Description

fieldName

...

String

Yes

Name of custom field.

projectKeys

...

String []

No

Project keys.

issueTypes

...

String []

No

Issue types.

Return

...

Type

stringString

Returns a string representing the options of the specified custom field.

...

Examples

Example 1

Get the options of the "CF_CASCADE" custom field, using the global context.

Code Block
admGetCustomFieldOptions("CF_CASCADE", {}, {});

Possible result as a string:

Code Block

Example 2

Get the options of the "CF_

...

SELECT" custom field, using the

...

Possible result as a string:

Code Block
Parent option 1
 Child option 1
 Child option 2
Parent option 2
 Child option 1
 Child option 2

...

context for projects "PRJ1" and "PRJ2" and issue types "Bug" and "Task".

Code Block
admGetCustomFieldOptions("CF_SELECT", {"PRJ1", "PRJ2"}, {"Bug", "Task"});

...

Possible result as a string:

Option 1 Option 2 Option 3
Code Block

See also

Filter by label (Content by label)
showLabelsfalse
max25
showSpacefalse
cqllabel = "jiracustomfield_fieldadmin_routine" and space = currentSpace ( )
labelsjiraarray_attachment_routineroutines