Home >

AX2004

Viewing document history

Axiom Software automatically creates document versions when a file is modified, and stores those versions in the database for a configured amount of time. These historical versions can be viewed using Axiom Explorer, and can be restored as the current version if needed.

New document versions are automatically created when a document is modified within a user's lockout session, once per lockout. For example, if a user opens a plan file as read/write and then saves that document, the new version becomes the current version of the document, and the prior version is "archived" in the audit database. Whether the user saves the document once or multiple times within the lockout session, only one version is created. However, if the user closes the document and then re-opens it, creating a new lockout session, another version will be created if the user saves the document.

Administrators have access to an additional means of creating document versions of Axiom spreadsheet files, using the Create Restore Point feature on the Axiom Designer tab. Using this feature saves the file and creates a new document version, within the same lockout session.

The available document history at any particular time depends on how your System Data Purge Scheduler job is configured. This task purges audit history as of a specified number of days. For example, if the task is configured to purge audit data older than 30 days, then you cannot view or restore any document versions older than 30 days.

NOTE: If you need to restore plan files, you can use the Restore Plan Files feature instead. This feature can be used to restore any number of plan files as of a specified point in time. For more information, see Restoring plan files from restore points.

Viewing available document versions

You can view the list of available document versions using Axiom Explorer, and open these versions.

To view the history for a document:

1. On the Axiom tab, in the Administration group, click Manage > Axiom Explorer.

   You can also view document history using the Explorer task pane.

2. Navigate to the desired document, then right-click it and select Document History.

The Document History dialog opens, listing all of the available versions of the selected document (including the current version). The version numbering starts at 1 and increments by +1 for each subsequent version, so that the version with the greatest number is the most recent version.

If you want to view a prior document version, select the version and then do either of the following:

• Click Open to open the version in Axiom Software. This opens the selected version as an unmanaged copy of the document. The name of the unmanaged file is Filename - version #. (Note that if you open the current version of the document from the Document History dialog, it opens normally, just as if you had opened it from Axiom menus. The version behavior only applies when opening a historical version.)

  If you want to save a copy of this version, you must use Save As to save the file locally or back to the Axiom Software file system as a new name. If you just click Save, then the file is saved within the Axiom temporary folder and will not be retained.

• Click Export to export a copy of the selected version. This is equivalent to using Export Without Refresh—meaning, protection will not be applied, and "refresh on open" Axiom queries will not be run. You can save the exported copy to your local computer or a network file share.

This process assumes that you just want to view the document or save a copy of it, not replace the currently active version with it. If you want to restore a prior version over the currently active version, see the next section.

Restoring document versions

The easiest way to restore a document version is by using the Restore Prior Version button on the Axiom Designer ribbon tab. By default this feature is only available to administrators, but it can be used by any user with read/write access to the document if it is included on a custom ribbon tab that they have access to. This feature is only available to Axiom spreadsheet files.

To restore a prior document version:

1. Open the document, then go to the Axiom Designer tab.
2. Click Restore Prior Version to view a drop-down list of available versions, then click the prior version that you want to restore.

3. Axiom Software prompts you to confirm that you want to open the selected prior version in place of the current version. Click Yes to continue.

4. If the currently open version of the file has unsaved changes, then Axiom Software prompts you to save those changes before the prior version is opened. Click Yes or No depending on whether those changes need to be saved.

   The current document is closed and the prior version of the document is opened as the current file.

5. To save this prior version as the current version, click Save.

If it is not possible to use Restore Prior Version, then you can:

• Open the prior version, then use Save As to save the file over the current version.

  OR

• Export the prior version, then use Import Files to import the file over the current version.