| Table plus |
|---|
| applyColStyleToCell | true |
|---|
| heading | 0 |
|---|
| columnTypes | s,s,s,s |
|---|
| multiple | false |
|---|
| columnAttributes | style="background:#e5e7ea;font-weight:bold,,style="background:#e5e7ea;font-weight:bold, |
|---|
| enableSorting | false |
|---|
|
Syntax | autotransition(transition, issueKey, [skipStateCheck, [skipConditions, skipValidators]]) |
Package | Alias | autotransition(transition, issueKey),
autotransition(transition, issueKey, skipStateCheck) |
Pkg Usage,
autotransition(transition, issueKey, skipStateCheck, skipConditions, skipValidators) |
|
Description
| Excerpt |
|---|
|
Executes a transition and moves to the specified step. |
Executes a transition and moves to the specified step. It will execute the transition only if the transition is valid for the current status of the issue. If the skipStateCheck parameter is set to true, the routine will force the target transition even if the issue is currently inside another transition and has been modified.
...
| Table plus |
|---|
| applyColStyleToCell | true |
|---|
| columnTypes | s,s,s,s |
|---|
| heading | 0 |
|---|
| multiple | false |
|---|
| enableSorting | false |
|---|
|
Parameter name | Type | Required | Description |
|---|
transition | String | Yes | Name of the transition that will be executed. | issuekey | String | Yes | Key of the issue the transition will be executed for. | skipStateCheck | Boolean | No | If set to "true", will force the target transition even if the issue is currently inside another transition and has been modified. | skipConditions | Boolean | No | If set to true, will not check conditions on the target transition | skipValidators | Boolean | No | If set to true, will not check validators on the target transition |
|
Return Type
Boolean (true/false)
If the return value is "true", the transition was executed successfully. A "false" return value means that the transition failed. In this case check the log for additional details.
| Note |
|---|
Starting with version 2.5.3, autotransitions are executed after the script has finished. Since we do not know the result of the operation at the time the routine is called inside the script, it will return "true" by default. |
Examples
Example 1
| Code Block |
|---|
|
autotransition(121, "PRJ-123"); |
...
Returns "true" if the transition requirng requiring information for the issue PRJ-232 was executed and "false" if the transition wasn't executed.
| Note |
|---|
To use the routine on the Create Issue transition, it is very important that you place the SIL post function after the "Creates the issue originally" post function but before "Fire a Issue Created event that can be processed by the listeners.". Positioning the SIL™ post function otherwise will de-synchronize the issue from the workflow. That will set an invalid status for the workflow step it is in. If the transition requires a screen it will not be displayed for additional input. You should do all issue modifications in or before the post function that contains the calling of the auto transition. All post functions executed by the called transitions should not modify the issue. These post functions could be used for sending notifications. If there are validations and /or conditions in the transition called after the one that contains the auto transition, and these validations fail, the transition will not be executed.
|
| Info |
|---|
Frequent ProblemsProblem: When executing an autotransition, it fails with the message: It seems that you have tried to perform a workflow operation (<Transition _Name >) that is not valid for the current state of this issue (<Issue _Key >). The likely cause is that somebody has changed the issue recently, please look at the issue history for details. Solution: Set the skipStateCheck parameter to "true ". |
See also
| Filter by label (Content by label) |
|---|
| showLabels | false |
|---|
| max | 25 |
|---|
| showSpace | false |
|---|
| cql | label = "workflow_routine" and space = currentSpace ( ) |
|---|
| labels | array_routines |
|---|
|