| Warning |
|---|
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 ! |
| Info | ||
|---|---|---|
| ||
This routine is available starting with katl-commons SIL Engine™ 4.0.16 |
Syntax
getInput(customfield_id)
or
getInput(keyword)
| Info |
|---|
Make sure that a transition screen has been attached to the current transition. |
...
| Excerpt |
|---|
Gets the value of a field in the transition screen. Should only be used in transitions that require a screen. |
| Warning |
|---|
This routine has a very limited working scope. Since it The routine handles transient values, therefore it will work correct correctly only if an interval is called starting from the moment the user clicks the Submit button on the transition screen up to the point when the issue is saved in the database. Therefore we can define the valid scope for the routine to be validators and certain post-functions. It means that you will not be able to use it in conditions, SIL services, SIL listeners nor from the SIL Gadget. While using When used in post-functions this routine will work works in SIL post functions that run before the routines that save the issue in the database. The latter are default Jira post-functions that can be easily recognized by their name, for instance "Update change history for an issue and store the issue in the database", for a regular transition "Creates the issue originally", for the "Create Issue" transition, and so on. |
Parameters
Parameter name | Type | Required | Description |
|---|---|---|---|
customfield_id/keyword | string | Yes | Id of the custom field (customfield_id) or the specific keyword for the standard fields. |
Return type
string
The value of the field in the transition screen.
Examples
Example 1 - checking whether a certain custom field has
...
a given value
| Code Block |
|---|
return getInput("customfield_12003") == "abc"; |
Returns Checks if the value set in the transition screen for customfield_12003 is "abc".
Example 2 -
...
getting the comment a ticket has
...
on a transition screen
| Code Block |
|---|
getInput("comment");
|
...