View, compare and restore document versions

Version history is available in dataspaces with versioning enabled — see the setup instructions.

Open the history

The History dialog on a Northwind order, versions with agent attribution

Click the document's last-modified timestamp in the action bar. The History dialog opens with the document's versions listed newest first, each showing its datetime and the agent who authored it. A document no write has reached since versioning was enabled, such as imported data, has no versions yet: the dialog says so, and the document's next change makes the first one. The version you are currently viewing is marked.

Click a version to view the document as it was at that point. A notice banner reminds you that you are viewing a historical version and links back to the current one. Historical versions are read-only.

Compare versions

A version diff on an order document — added/removed/changed borders and the color legend

In the History dialog, select a From and a To version to compare. The diff renders on the document page:

  • added, removed and changed parts are marked with distinct borders, explained by a color legend
  • changed property values are marked individually
  • a changed XHTML block stacks its old content above the new

The diff is encoded in the URL, so browser back and forward re-render it. Reloading the page shows the plain historical version instead.

Restore a version

In the History dialog, click Restore on the version you want to bring back and confirm. The version's content is written to the live document as a new version. Nothing is rewritten: the versions in between stay in the history.

Restoring requires write access to the document; the button is not offered on the version you are currently viewing.

Read more about versioning and the Memento protocol.