Altium NEXUS Documentation

ShowHistory

Modified by Susan Riege on Feb 19, 2019
This documentation page references Altium Vault, which is no longer a supported product. Altium Vault and its component management features have migrated to Altium Concord Pro.

Parent page: VersionControl Commands

The following pre-packaged resource, derived from this base command, is available:


Applied Parameters: None

Summary

This command is used to access the Local History dialog. This dialog presents the local version history for the active document with the ability to quickly compare two selected versions. Altium NEXUS's internal history management system allows you to maintain history and track document changes locally without the need for a Version Control System (VCS).

The approach of the local history management system is to make a copy of a file each time you perform a save, keeping all the copies in a project History folder (the copy is the file prior to the save event). The project History folder is created within the folder that contains the project file. If a project includes documents stored in sub-folders, this sub-folder structure will be repeated within the History folder.

Local History files are saved in the compressed ZIP format with an added filename number suffix (for example, SheetZ.~(3).SchDoc.Zip) that indicates its sequential version. Tthe highest number represents the newest version.

Local document history management also works in harmony with an active VCS. Individual designers can manage their own changes using the local history system with the VCS providing a complete team-oriented document management system.

Access

This command can be accessed by:

  • Choosing the Project » Local History » Show Local History command from the main menus.
  • Right-clicking on the document of interest within the Projects panel and choosing the Local History » Show Local History command from the context menu.

Use

First, ensure that the command is launched for the document whose local history you want to view. From the main Project menu, this will be for the active document. From the Projects panel, this will be for the focused document.

After launching the command, the Local History dialog will open. The dialog presents a local history for the applicable design document. The history list can contain the following entries:

  • Open Document - the version of the document currently open in the workspace (if applicable). Modifications may have been made to this document and it has yet to be saved.
  • Last Saved Contents - the last saved version of the document.
  • Version n - a local (manual) back-up version of the document. When you save the document, the version that was listed as the Last Saved Contents will be backed-up as entry Version 1. Saving again will back up the Last Saved Contents as Version 2, and so on, creating a history for the document.
  • Version n [label] - local (manual) back-up version of the document that has a label applied to it.

The history is listed with the most recent version at the top, for example:

  • Open Document
  • Last Saved Contents
  • Version 3
  • Version 2
  • Version 1 [Original Draft]

Double-click on an entry to open that version of the document as the active document in the main design window.

Select two versions of the document in the list then click the Compare button to perform a comparison between the documents.

Tips

  1. The Local History list in the dialog is similar to that presented in the Local History region of the Storage Manager panel when configured in its Classic View. The Storage Manager panel provides superior management features including the ability to show auto backups (from the Auto Save feature), purge local history, delete selected versions, ability to apply a label to a version, and the ability to revert to a chosen historical version.
  2. Local History is configured on the Data Management - Local History page of the Preferences dialog. The number of days the file history is retained can be configured, where the history of a file save event will be held for the specified period (up to 10 days). Alternatively, you can specify a global storage location, which will hold the history of all projects under matching project folders.
Found an issue with this document? Highlight the area, then use Ctrl+Enter to report it.

Contact Us

Contact our corporate or local offices directly.

We're sorry to hear the article wasn't helpful to you.
Could you take a moment to tell us why?
You are reporting an issue with the following selected text
and/or image within the active document:
ALTIUM DESIGNER FREE TRIAL
Altium Designer Free Trial
Let’s get started. First off, are you or your organization already using Altium Designer?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

In that case, why do you need an evaluation license?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Got it. You actually don’t need an evaluation license for that.

Click the button below to download the latest Altium Designer installer.

Download Altium Designer Installer

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Please fill out the form below to get a quote for a new seat of Altium Designer.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

If you are on Altium Subscription, you don’t need an evaluation license.

If you are not an active Altium Subscription member, please fill out the form below to get your free trial.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Why are you looking to evaluate Altium Designer?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

You came to the right place! Please fill out the form below to get your free trial started.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Great News!

Valid students can get their very own 6-month Altium Designer Student License for FREE! Just fill out the form below to request your Student License today.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Got it. You can download a free Altium Designer Viewer license which is valid for a 6 months.

Please fill out the form below to request one.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

That’s great! Making things is awesome. We have the perfect program for you.

Upverter is a free community-driven platform designed specifically to meet the needs of makers like you.

Click here to give it a try!

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Got it. You can download a free Altium Designer Viewer license which is valid for a 6 months.

Please fill out the form below to request one.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.