Versioning

Xponent includes project version control, allowing snapshots to be created at any time. The snapshot consists of journeys, graphs, metrics, connections, and Environments. All users can view previous versions of those projects to which they have access.

 To create (publish) a new version or restore an existing version, you need to be an owner, operator, or configured within your organization or an admin on the project.

Xponent strongly recommends always creating a deployment version and not using Current as a non-development deployed graph.

Publishing a New Version

To create a new version, navigate to the Project Settings section, select Versions, and click the Publish New Version button. You will be prompted to enter a Name and Description for the version. As a best practice, describe all changes for the version in the description field and click Publish Version to save. While doing this, you can bold, italic, or underline the content if required. Xponent automatically tags each version with a unique identifier (For Example, "v#") and captures the creation date, making it easy to trace the version history.

Each version displays essential metadata, including the Name, Description, Author, Source, and Timestamp (created or updated in local time). When a version is published or restored, the Source column is updated based on the version it is derived from. The Create/Update timestamp indicates the recency of the current version. This creates a locked snapshot of the project data for consistent traceability. Additionally, versions are retained permanently and cannot be deleted, providing a comprehensive project record.

 All versions published prior to the 24.3 release will not contain the Description and Source columns.

All versions are displayed in a simple, linear order, and you can restore any version regardless of its order in the list. While publishing a version, project assets will be locked. However, graph locks will be released when you view or create a version, ensuring that no graphs or Adaptors remain locked even after prior edit states.

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. In the admin panel, users can switch to the functional version to view the contents of the previously 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 published version in the list, or the current editable version. The active version is selected by clicking the radio button for the desired version in the list of versions.

Users will no longer have access to view connection details within currently selected versions.

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

Navigation items in the mapper and editor, and project page (and certain portions of the admin screen, like environments and connections), as well as deployments, will now show data from this locked version.

The screen will be greyed out, and the ability to edit graphs or projects will be disabled until setting active version is Current. The locked p’. The locked padlock will appear at the top of the screen, along with the version description.

Only valid graphs that contain a listener at the time of version publishing will be available for deployment or visual testing.

If a published version is the active version when deploying a graph from the admin screen, that version will be deployed and indicated in the 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.