[Release 44 - New Workflow] Migrate "Versions" menu to "Draft state"

From release 44 (launched in August 2017), AODocs is replacing the Versions menu on workflow states with a new type of workflow state, Draft, and different types of transitions.

With the new workflow configuration:

  • check-out / check-in within a workflow is more user-friendly to configure
  • permissions on the draft and main version are easier to configure
  • manual and automated check-out / check-in can’t be used at the same time
  • new versions are created during workflow transitions

This means that AODocs will gradually deprecate the Versions menu of the workflow states, beginning in release 44.



What is changing with release 44?

Before release 44, the Versions menu was used to perform the version control actions:

  • New version
  • Check-out / check-in / Discard check-out


In release 44, the Versions menu is no longer displayed in workflow states where the Do nothing option is selected. Also, newly created workflow states don’t have a Versions menu.

AODocs will continue to support workflow configurations that use the Versions menu until release 46 (expected for the end of year 2017). After this version, workflow configurations using the Versions menu will no longer work.

Below is an example of a publication workflow with the check-out / check-in feature before release 44:


Below is the same publication workflow after release 44 using the new Draft states:


Before release 44

After release 44

Check-out / check-in and Discard check-out actions happened on the document when the document entered the workflow state configured with the Versions menu.

Check-out / check-in happen during  workflow transitions.

The main version had the first workflow state of the draft version.

The main version doesn’t take the first workflow state of the draft version.

Permissions for the main and draft versions were complicated because they were managed both in the Permissions menu and the Versions menu.

There are two types of state: Draft and  Standard.

All workflow permissions are managed in the Permissions menu on the workflow state.

The Versions menu no longer exists.

Human errors combining manual and workflow automated check-out / check-in caused the wrong permissions to be applied to the document.

The workflow state of a document is frozen if it has been checked-out manually.


Manual check-in is forbidden if the check-out is triggered by a workflow transition, to limit human error and loss of permissions.

Automatic discard can be configured in the workflow configuration.

For the moment, a check-out can be canceled (draft discarded) only manually. The upcoming release of AODocs will restore this capability.


Administrators can no longer manually force a workflow state from Standard to Draft (or the reverse). They have to follow the workflow actions.


How to migrate your workflow to the new engine?

For help with your migration and to find out about best practices, contact the AODocs support team.

Was this article helpful? 2 out of 2 found this helpful
If you didn’t find what you were looking for, don’t hesitate to leave a comment!
Have more questions? Submit a request



Please sign in to leave a comment.