In most of cases, if some specific change are required in the configuration, each version of the Minyaa Workflows plugin are able to come with an UpgradeTask class who will take in charge these modification.
The UpgradeTask is based on a JIRA extension point managed by the Universal Plugin Manager (UPM). On plugin deployment, if an UpgradeTask has never been executed, UPM will launch it.
The required changes are done in background ... In not yet identified cases, some of these upgrade may encounter some issues and causes that some of your Workflows are not correctly migrated with the new configuration related the new plugin version.
Such cases have been experimented by a part of our customer with a large number of Workflow.
In order to allow them to replay these Upgrades, a dedicated REST APIs has been implemented. It allows to re-launch some if them on some of your Workflows.
/rest/minyaaWF/1.0/workflows/upgrade
| Description | Launch a (or more) Upgrade Tasks on a set of Workflow. Only UpgradeTask who extends com.alkaes.jira.upgrade.AbstractWorkflowUpgradeTask are allowed. The class AbstractWorkflowUpgradeTask is used by different Alkaes Plugin as soon as they provide Upgrade Task related Workflows. | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Method | POST | ||||||||||||
| Content-Type | application/json | ||||||||||||
| Parameters | PayLoad Parameters :
Sample : Error rendering macro 'code': Invalid value specified for parameter 'com.atlassian.confluence.ext.code.render.InvalidValueException' {
"pluginKey": "fr.alkaes.minyaa.jira-plugin-minyaa-workflows",
"workflowNames": [
"nameOfMy1stWorflow",
"nameOfMy2ndWorflow"
],
"upgradeClassNames": [
"fr.alkaes.myaawf.upgrade.UpgradeTask_001",
"fr.alkaes.myaawf.upgrade.UpgradeTask_002"
]
} | ||||||||||||
| HTTP 200 Return | In case of success, the list of Upgraded Workflows per Upgrade Task are listed ... Error rendering macro 'code': Invalid value specified for parameter 'com.atlassian.confluence.ext.code.render.InvalidValueException' {
"pluginKey": "fr.alkaes.minyaa.jira-plugin-minyaa-workflows",
"performedUpgrades": {
"fr.alkaes.myaawf.upgrade.UpgradeTask_001": [
"nameOfMy1stWorflow",
"nameOfMy2ndWorflow"
],
"fr.alkaes.myaawf.upgrade.UpgradeTask_002": [
"nameOfMy1stWorflow",
"nameOfMy2ndWorflow"
]
}
} |