admSetProjectWorkflowScheme
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 SIL Engine™ 2.5.8.
Syntax
admSetProjectWorkflowScheme(pkey, schemeName)
Description
Updates the project workflow scheme.Both the scheme and the project must exist.
Parameters
Parameter name | Type | Required | Description |
|---|---|---|---|
| pkey | string | yes | Project key. Must exist. |
| schemeName | string | yes | Scheme name. The scheme must exist. |
Return type
boolean
Returns 'true' if the project was updated and 'false' if not.
Updating the project workflow scheme happens smoothly only if the statuses in the destination scheme match the ones in the source scheme in both their name and step id. Otherwise, the workflow scheme update might cause some failures in issue transitioning. To avoid having these, it is mandatory to perform a Workflow Integrity Check and fix the errors for the workflow current step entries of the project.
Notes
When using an empty or null scheme name, the routine will set the default workflow scheme on the specified project.
In other words the code will look like this:
string pkey = "TEST"; string schemeName; return admSetProjectWorkflowScheme(pkey, schemeName);
It equivalents to the following code:
string pkey = "TEST"; string schemeName = ""; return admSetProjectWorkflowScheme(pkey, schemeName);
It will return 'true' and will set the default Jira workflow scheme (Default Workflow Scheme).
Otherwise, when using a nonexistent workflow scheme name, the routine will return 'false' and will not make any change.
See also