Versioning

We have included an Interactive Training to provide a more engaging and visual learning experience. End users are required to complete their training through the CSG University.

Xponent includes project version control that allows snapshots to be created anytime. 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 Publish New Version button. You will be prompted for a Name and Description of 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 (e.g., "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 (Create 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 no graphs or Adaptors remain locked despite 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. Via the admin panel, user can change 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 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.

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

When the version is chosen, the Active Version will update to show 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 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 padlock will appear at the top of the screen, along with the version description.

Only graphs that are valid and 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 of the graph will be deployed and will be 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.

Restore Version

It is possible to revert to a previous version and make it the current version. If you would like to save any changes before restoring an old version, you must publish a new version first. When a version is restored, the current source version will be updated to the version you restored.

Restoring Version With Missing Connection

Connection details are now decoupled from the graph definition, so the user will no longer be able to lookup connection details that existed in a previous version.

All versions utilize the current details. While restoring a version, if any connections are deleted or missing in your current version, a pop-up will prompt to notify you that application will create a blank connection for you. These blank parameters you must fill in before deployment.

• Click Restore to proceed the restoration.

Blank connectors will still be generated even if the user chooses to cancel restoring the version now.

If canceled, subsequent attempts to restore the version will find the blank connectors already in place, and the prompt will not appear again.

Viewing Connection Details In Versions

Now, version restoration will no longer overwrite any connection credentials.

The connection details are no longer part of the definition of the graph; therefore, they are not included in the version. Instead, all versions will use the connection details that are in the current version, if they exist.

Missing Connections

When a user selects a version of a graph from the versions tab and navigates to the connections tab to view the associated connections, user will be alerted if any of the connectors have been deleted.

Remember, at this stage, the application has not yet created blank connectors for that version, as no attempt to restore it has been made.

After restoring a version or deploying a graph that is being referencing connection details which are no longer exist (have been deleted). The application will create blank connection. Users will need to manually enter the connection and credential details for those, providing them with more control over the re-establishment of deleted connections.