Versioning
Chart versioning means storing the history of chart configuration changes through versions. A list of versions is available to users with the lowest level of Read access to the chart.
To go to the list of versions, click the
To select a version from the list, click it. The version number will be displayed in the revId
parameter in the chart address string. Clicking a link with the version number in the revId
parameter will open the relevant version of the chart.
When editing within the current version, you can undo/redo any change you have made. To do this, click:
in the top-right corner of the screen or press Ctrl (Cmd) + Z to undo changes. in the top-right corner of the screen or press Ctrl (Cmd) + Shift + Z to redo changes.
Unsaved changes in the current version are reset:
- When refreshing the page.
- When saving a chart.
- When switching to another version.
Version types
All versions fall into the following types:
-
Current: This is the most recently saved version of a chart.
The current version is displayed:
- To all users on dashboards.
- When navigating to a chart.
- When opening a chart in a workbook.
- When using the dashboard context menu to open a chart for editing.
Only one chart version can be current.
A user with Write permissions can make any chart version current.
Warning
When updating any version, except a draft, a new chart version is created.
-
Draft: This is a version with unsaved chart changes. Common users do not see changes being made to a draft. This enables you to hide chart edits until you release a new version. A chart can only have one draft.
When you open a draft, a panel appears at the top indicating the version type, creation date and time, and login of the version author. There are buttons in the right-hand panel:- Make current: Turns the draft into the current version. The version current at the time will become outdated.
- Open current: Opens the current version.
Draft
To create a draft after editing a chart, click the down arrow in the top-right corner and select Save as draft.
You can display a draft version of your chart on the dashboard. To do this, add the
unreleased
parameter set to1
to the widget parameters on the dashboard for this chart. -
Outdated: This is a version that is neither current nor a draft.
When you open an outdated version, a panel appears at the top indicating the version type, creation date and time, and login of the version author. There are buttons in the right-hand panel:- Make current: Turns the currently outdated version into the current one. The current version and draft (if any) will become outdated.
- Open current: Opens the current version.
Outdated version
Tip
You can share any chart version by adding the revId
parameter to the chart link, e.g., ?revId=zac5m4edoaqqr
.
Creating a new version
A new version is automatically created:
- In the current chart version edit mode, after you click Save (which creates a new current version) or
→ Save as draft (which creates a new draft version). - In the draft edit mode or non-current chart version edit mode, after you click Save as draft (which creates a new draft version) or
→ Save and make current (which creates a new current version). - In draft or non-current chart version view mode, after you click Make current.
You will also get a new version if you change chart configuration as follows:
- Edit the chart settings you can access by clicking
at the top of the screen. - Add, rename, or delete chart fields.
- Add or delete fields in chart sections.
Editing versions
You can edit any version of a chart.
Editing a current version
If a chart has a draft, when you open its current version for editing, you will see a message in the top panel informing there is a draft in the change history.
Click the following:
- Open draft: To navigate to the draft.
- Show in history: To display the list of versions.
Editing a draft
To edit a draft, select it in the list of versions. To save the changes you make to the draft, at the top right, click:
- Save as draft to create a new draft. The current draft will become an outdated version.
- Click
→ Save as copy to create a new chart. → Save and make current to create a new current version and make all other versions outdated.
Editing an outdated version
To edit an outdated version, select it from the list of versions. To save the changes you make to an outdated version, at the top right, click:
- Save as draft to create a draft from the version you are editing. The current draft will become an outdated version.
- Click
→ Save as copy to create a new chart. → Save and make current to create a new current version and make all other versions, including the draft, outdated.
Limitations
- The change history only contains a list of chart versions and includes the version type, save date and time, and the author of the edits.
- Chart versions do not include changes to access permissions; this operation is performed separately from chart edits.
- Versions do not display a list of changes. You can only view the saved status of the chart configuration.