Versioning

Xponent includes project version control that allows snapshots to be created at any time. The snapshot includes journeys, graphs, metrics and connections.  All users have ability to view previous versions for those projects to which they have access.  However, in order to create (publish) a new version or restore an existing version, you need to be an owner, operator or configurer within your organization, or an admin on the project.

Xponent strongly recommends to always create a version for deployment and not use Current as a non-development deployed graph.

Creating (Publishing) a New Version 

To create a new version navigate to the Project Settings section, choose Versions and click on the Publish New Version button. You will be prompted for a description of the version. As a best practice, you should always capture what you had changed as the description, your name as the creator and creation date for the new version. Xponent will automatically prepend a version tag of the form 'v#' where # is an integer starting at 1 and capture the version created date. The description, creator name, date of creation will be information that will appear when you want to compare between any 2 versions.

 

This creates a locked snapshot of the project. Versions can not be deleted. 

Choosing the Active Version 

The active version is the version as displayed in the editor.  By default, the active version is the current editable version.  Via the admin panel, one can change the active version to view contents of previous published version. 

To view which version is active, go to the Project Settings tab. You will land on the Versions tab by default.

The active version can be any of the published versions in the list or it can be the current editable version. The active version is chosen by selecting the radio button for the version you want in the list of versions. 

When the version is chosen the Active Version will update to show the version number and name and will show a locked padlock. 

Navigation items in mapper and editor and project page (and certain portions of admin screen, like environments and connections), as well as deployments will now show data from this this locked version. The screen will be greyed out, and ability to edit graph or project will be disabled until setting active version to current. The locked padlock will appear at the top of the screen along with the version description. 

Only graphs with listeners that were valid at time of publishing of version will be available to deploy/visual test.

If a published version is the active version when deploying a graph from admin screen, that version of the graph will be deployed, and will be indicated in UI.

To resume editing go back to the Admin console and select the checkbox next to the 'Current' version. This will then change back to the unlocked green padlock. 

Restore and Archive

It is possible to revert back to a previous version and make that the current version. If you would like to save any changes that you have before restoring an old version you should publish a new version before restoring a previous one. 

When you restore a version it will archive any future versions ahead of the version that you are restoring. This would allow you to return to the original version stream at a later date if this is just a temporary change. In the image above version 2 is restored and versions 3 and 4 are archived under version 2 and shown below. To return to the original versions use the Restore Archive button. 

If an archive is restored it will reapply all versions in that archive. in the case of nested archives, it will only restore the top level of archives, but will then open up the next level to be restored if needed.



Privacy Policy
© 2022 CSG International, Inc.