You can drive Elements diagrams through the release lifecycle and store version history for each diagram.

Warning: authorization of diagrams is an optional step that is only available on Enterprise Spaces and needs to be enabled for the specific map.

Article outline

  • Creating and managing releases

  • Diagram version management

  • Publishing releases and diagrams

  • Version history

  • Frequently asked questions

Creating and managing releases

Users with release manager permission can create and manage releases. Go to the Main App and select "Releases" from the left-hand menu. Click on the button in the upper-right corner of the screen to create a new release.

You will have to name the release and set the target release date. You will also have to specify the type of release and its risk level.

Once you create a release it will be visible in the list.

Diagram version management

Elements diagrams have a standard versioning process:

  1. You create and change diagrams in the "draft" state. Only editors and named viewers can access draft diagrams.

  2. When the diagram is ready, you can assign it to a release. Doing so puts in the "ready for release" version which is view-only.

  3. When the Release is published, that diagram is published. The previously published version is automatically archived as view-only.

In order to make a diagram "ready for release", expand the toolbar in the diagram application (1), open the right panel for the diagram by clicking on the "versions" tag (2), then select the "version" tab (3) and click "make ready for release" (4).

You will have to choose the target release for the diagram (or you can leave it blank and assign it later) and provide your Elements password to finalize the operation. If you plan on using the release-training functionality then also provide quick feedback explaining what was changed in the scope of this version.

Publishing releases and diagrams

When you are ready to publish the release (and all diagrams assigned to it) open the versions tab for the diagram and click on the name of the release next to the "Ready for release" tag. This will take you straight into the release app.

You can also go to the release app from the main application by clicking on the name of the release in the release list.

Once there, review if all the diagrams that you want to publish are marked with a ✓. You also have the ability to add diagrams to the release that were made "ready to publish" but not assigned to any release yet.

Click the "Publish" button in the upper-right corner of the screen to publish the release and assigned diagrams.

Version history

If you have edit rights or stakeholder access you can expand the toolbar (1), open the right panel for the diagram by clicking on the version tag (2), and select the "versions" tab (3) to view the version history. You can click through the horizontal timeline of the diagram to load the previous versions of the diagram and understand how it changed over time.

Click on "View version history" to pop up a modal window with more details about each version (like who created the version, when and what comment was left by the user).

Read this next article on versioning diagram hierarchies to avoid breaking your diagram hierarchy.

Did this answer your question?