Versioning

Connection versioning means storing the history of connection configuration changes through versions. A list of versions is available to users with the minimum edit permission for the connection.

To go to the list of versions, click at the top of the screen and select Change history.

To select a version from the list, click it. The version number will be displayed in the revId parameter in the connection address string. Click a link with the version number in the revId parameter to open the relevant version of the connection.

Version typesVersion types

All versions fall into the following types:

1. Actual: This is the most recently saved version of a connection. It is displayed for all users that open the connection for viewing in the workbook or from the navigation panel. A connection can only have one current version.

2. Outdated: Version that is no longer current.
   When you open an outdated version, you see a panel at the top stating the version type, creation date and time, and the version author's username. There are buttons in the right-hand panel:

   • Make actual: Turns an outdated version into the current one. The version actual at the time will become outdated.
   • Open actual: Opens the current version.
   Outdated version

   

Creating a new versionCreating a new version

A new version is automatically created when you click Save in connection edit mode. Any connection configuration changes available in the edit interface automatically create a new version.

Editing versionsEditing versions

You can edit any version of a connection.

Editing an outdated versionEditing an outdated version

To edit an outdated version, select it from the list of versions. To save your changes to an outdated version, click Save at the top right. This will create a new current version, and all others will become outdated.

LimitsLimits

• Versioning is not available for the following connections: Files, Yandex Documents, and Google Sheets.

• Sensitive connection data, such as passwords and tokens, is not versioned.

• You can only switch to versions created starting December 1, 2024. Therefore, if your connection was created before this date, editing it now and saving your changes will permanently delete the previous version.

• You can only get the change history for the last three months.

• The change history only contains a list of connection versions and indicates the version type, save date and time, and user who made the change.

• Connection versions do not include:

  • Access permission changes (this operation is performed separately from connection edits).
  • Changes to the source data (rows added, updated, or deleted in the data source).

• Versions do not display the list of changes. You can only view the saved status of the connection configuration.