Deactivate an Application Version

After making changes to an activated application, in order to include the latest changes and also to test the changes in Workspace (in case of a process application), you must first deactivate the activated application version.

Note:

Not sure which application version is active? Click and choose View Activated Versions. The active version is identified by its version tag and shows a Running status.

To deactivate an activated application version:

1. From the application's main page, click Activate.

   The activation pane for the active version of your application opens.

   Note that instead of Activate:

   • the Deactivate and purge button is displayed for process applications.
   • the Deactivate button is displayed for decision applications.

   Under Last Activation, clicking View more options displays other available options such as View Activated Versions and View API.

2. For process applications, click Deactivate and purge.

   In the resulting pane, you get a message that if you choose to deactivate and purge it will delete the currently activated version of the application, including the running and completed process instances, and all associated analytics data. You're asked to confirm the action.

   Caution: If working in a production environment, use the Deactivate and purge option with care. Deactivating and purging a process application permanently deletes all existing (running or completed) process instances and associated analytics data for your application version.

3. For decision applications, click Deactivate.

   In the resulting pane, you get a message that if you choose to deactivate the decision application, decision services of this version will be unavailable. You're asked to confirm the action.

   Caution: If working in a production environment, use the Deactivate option with care. When you deactivate a decision application, the decision services exposed by it will no longer be reachable. Only decision service endpoints of activated decision applications can be reused by other process applications as well as external clients.

4. Click Confirm.
   An intermediate message lets you know that your application is being deactivated. You get a confirmation after deactivation, and the Activate pane opens.
5. Specify a snapshot to activate. See Work with Snapshots.
   1. In the Select a snapshot field, leave New snapshot selected to capture your most recent changes.
   2. In the Snapshot name field, optionally change the default date/time name.
6. Resolve validation issues, if needed.
   Validation results for the selected snapshot are listed under Validation Summary with a View validation issues in detail link to drill down to warnings or errors. You can still activate with warnings, but errors must be fixed before you can activate.
7. For process applications, the Make it default checkbox displays. Keep the checkbox selected if you want to make this version (that you're going to activate) as the default version. The default version of a process application will be visible in the Start Requests page of Workspace.
8. Click Activate.
   If you’re creating a new snapshot, a Taking Snapshot status appears, followed by a message that the application is being activated. Once complete, you get a confirmation that the application is activated.
9. For a process application, you can test the new activation in Workspace.
   1. Click Test in Workspace. A new browser tab opens with Workspace. Notice that the URL is the same except for workspace at the end rather than designer.
   2. On the Start Requests page, select your activated application, listed by its application name and process.
   3. Run the application as an end user would. For example, if the application starts with a form, complete and submit the form.