Vaults

Old Content - visit altium.com/documentation

Parent page: Panels

The Vaults panel gives access to your valuable company data stored in your Altium Vault.

Summary

The Vaults panel is the primary interface between Altium Designer and a connected Altium Vault, making it an integral part of the Design Data Management System. An Altium Vault stores your valuable company design data, including components, managed sheets and templates, and completed designs. From the Vaults panel you create and manage the organizational structure used in the vault and also create any number of Items, each representative of a design-side object. From the Vaults panel you also access detailed Item information, where you manage the revision and lifecycle settings for the Item. The Vaults panel also gives access to Where Used and Supply Chain detail.

Panel Access

To display the Vaults panel, click the System button down the bottom-right of Altium Designer, and select the Vaults entry. Alternatively, you can access the panel through the View » Workspace Panels » System sub-menu.

Use the System button to open the Vaults panel.

In addition, you will come across various areas of the Design Data Management System that offer the ability to access the Vaults panel directly for a given Item, through an associated Show in Explorer command.

Choosing the Working Vault

The Vaults panel can only interface to one vault at a time. The field at the top-left of the panel indicates the currently open vault – the vault whose content you will be able to browse and modify. To refresh the content display for the active vault, click the  Icon at the right-hand end of the Address Bar, or right-click and select Refresh Vault.

To select a different vault, to refresh the displayed data for all vaults, or to access the Data Management – Vaults page of the Preferences dialog, click the  icon to the left of the vault name (or on the vault name itself) to access a menu of top-level vault management controls, controls that enable you not only to choose the vault you wish to work with, but also to manage the connections to vaults – both existing and new.

Top-level vault management controls.

The menu provides the following controls:

  • Connected Vaults – all currently connected (and enabled) vaults are listed at the top of the menu. To interface with a different vault, simply click on its entry in the list. The name of that vault will be displayed at the top-left of the panel and the panel refreshed to show the current content of that vault.
  • Refresh All – use this command to refresh the connections with all currently connected vaults.
  • Vault Administration – use this command to access the Data Management – Vaults page of the Preferences dialog, where you manage vault connections and other vault properties. You can also define new connections to additional vaults from here. Newly connected vaults will appear, by name, in the top region of the menu.

Organizing the Vault

You maintain order within your vault by creating a tree of folders for the various Items stored in the vault. A number of folder types are available, use these to categorize the vault content. Right-click in the Vault Folders region of the Vaults panel to add folders and define a storage structure of folders and sub-folders that suits your organization.

The right-click menu includes commands for defining a folder hierarchy.
Note that the options change depending where you click.

When adding a sub-folder, the Add Subfolder sub-menu will change to display those folder types most applicable, based on the parent top-level folder type.

The following sections take a closer look at working with folders.

Defining Zones within the Vault

Within a vault's folder hierarchy, different folders can be used to store different types of Items. To declare the intended purpose of any given folder – that is the type of content it will be used to contain – the folder's type can be specified. This is done using the Folder Type property, which can be set when creating the folder, or later by editing the folder properties.

A folder's Folder Type property has no bearing on the content of the folder. It simply provides a visual 'clue' as to what is stored in a folder and can be beneficial when browsing a vault for particular content.

At the highest level, the vault can be divided, conceptually, into three distinct areas, or zones of content:

  • Component Management Zone – an area of a vault dedicated to the management of released Component Items, and also the domain models (Schematic Symbol Items, PCB Component Items, Signal Integrity Model Items, Simulation Model Items) used in those Component Items.
  • Design Content Management Zone – an area of a vault dedicated to the management of released, reusable design content (Managed Sheet Items, Template Items, Reference Design Items).
  • Production Release Zone – an area of a vault dedicated to the management of released datasets used to produce the physical boards (both blank and assembled Board Items).

Each of these zones are simply the highest-level folders of a particular folder type. Typically they will then contain sub-folders of differing types to further categorize their content.

Vault Folder Types

The following table summarizes the different folder-types available for use in a vault. You have full control over the folder-type, it can be changed at any time by right-clicking on a folder and selecting Properties.

Folder Type

Code

Intended Purpose

altium-component-library

CMPL

Used to contain released Component Items.

altium-component-management-zone

CMZ

High-level folder under which sub-folders of Component Items and their related domain model Items are stored.

altium-design-content-zone

DCMZ

High-level folder under which sub-folders of reusable design content Items – schematic sheets, templates, reference designs – are stored.

altium-design-template-catalog

DTC

Used to contain released Design Template Items.

altium-designer-plugin-zone

ADPZ

High-level folder under which sub-folders of Altium Designer Plugins are stored.

altium-managed-sheet-catalog

SSC

Used to contain released Schematic Sheet Items.

altium-part-choice-list

PCLT

Used to contain released Part Choice List Items.

altium-pcb3d-library

PCB3DML

Used to contain released PCB3D Model Items.

altium-pcb-component-library

PCBCL

Used to contain released PCB Component Model Items.

altium-production-release-zone

PRZ

High-level folder under which sub-folders of PCB production data Items – Blank Board and Assembled Board – are stored.

altium-schematic-template-catalog

STC

Used to contain released Schematic Template Items.

altium-si-library

SIML

Used to contain released Signal Integrity Model Items.

altium-simulation-library

SML

Used to contain released Simulation Model Items.

altium-symbol-library

SSL

Used to contain released Schematic Symbol Items.

generic-folder

GEN

Used to contain content of any description – a sort of generic 'bucket' of released Items if you will.

morfik-plugin-zone

MPZ

High-level folder under which sub-folders of Morfik Packages are stored.

morfik-web-content-library

WCL

Used to contain released Morfik web-content.

morfik-web-deployment-zone

WADZ

High-level folder under which sub-folders of generated Morfik deployable XApp Images are stored.

Vault Folder Properties

When you add or edit a folder a dialog will appear, where you define the properties of the folder. The content of the dialog is the same, irrespective of whether a top-level folder or sub-folder is being added.

Define the properties of the folder being added.

The dialog presents the following folder-related properties:

  • Folder Name – enter a meaningful name for the folder, perhaps an umbrella term that reflects the relationship of the Items that will be stored within it.
  • Folder Type – this is already set to the folder type selected on adding the folder, either through a menu entry or through the Choose Folder Type dialog. If you need to change the type, simply click the arrow at the far right of the field and choose the required type from the drop-down listing.
  • Description – enter any description for the folder here, perhaps describing the content it is to hold.
  • Item Naming Scheme – this field provides a set of default naming schemes that can be used to quickly define the unique ID for any Item subsequently created within the folder. Using a default naming scheme, the software will automatically assign the next available unique ID, based on that scheme, having scanned the entire Vault and identifiers of existing Items. The following naming schemes are available, based on content or folder type, each resulting in a 3-stage identifier:
     

    Naming Scheme

    Description

    Example

    $CONTENT_TYPE_CODE-001-{0000}

    First stage of identifier is the code for the content type of the Item being created.
    Second stage is a 3-digit numerical value.
    Third stage is a 4-digit numerical value.

    SYM-001-0001

    $CONTENT_TYPE_CODE-001-{A00}

    First stage of identifier is the code for the content type of the Item being created.
    Second stage is a 3-digit numerical value.
    Third stage is a 4-digit alpha-numerical value, with a single letter being the left-most digit.

    SYM-001-A001

    $FOLDER_TYPE_CODE-001-{0000}

    First stage of identifier is the code for the folder type of the parent folder housing the Item being created.
    Second stage is a 3-digit numerical value.
    Third stage is a 4-digit numerical value.

    SSL-001-0001

    $FOLDER_TYPE_CODE-001-{A000}

    First stage of identifier is the code for the folder type of the parent folder housing the Item being created.
    Second stage is a 3-digit numerical value.
    Third stage is a 4-digit alpha-numerical value, with a single letter being the left-most digit.

    SSL-001-A001

     
    You can of course create your own scheme for a folder, simply by typing it within the field, ensuring that the variable portion is enclosed in curly braces (e.g. SYMBOL-001-{J000}). Of course, should you wish to have full control over the naming of an Item, simply select the [NO ITEM NAMING SCHEME] entry. You will then need to define a unique Identifier for an Item as part of its creation. In this case, you will need to be wary of the existence of other Items and their identifiers. The system will not allow creation of an Item with a duplicated identifier, but manually assigning an identifier still requires good knowledge of what identifiers have been used!
     

  • Sharing – click this link to access the Permissions For Folder dialog, from where you can specify the visibility of the folder, in terms of who can 'see' and access it.

When releasing source domain models or component definitions, to create model and component Items in the vault respectively, an Item Naming scheme is set as part of the release preparation and options. This is especially the case when Items are being created automatically 'on-the-fly', rather than releasing to existing Items that have been manually created directly within the target vault.

Navigating the Vault

You can navigate the content in a vault in several ways:

  • By clicking on a folder whose contents you wish to peruse.
  • Using the Address Bar at the top of the panel. The Address Bar reflects the current folder being browsed, along with the hierarchical path to that folder. Click on any entry in the path to jump directly to that folder, making it the current folder being browsed. Alternatively, click on a icon in the path to display a menu of possible folders to navigate to. Selecting a folder in that menu will jump to that folder, making it the current folder being browsed. The Address Bar will update accordingly.
  • Using the vault's search feature. Simply enter a keyword based on an Items comment or description and press Enter or click the magnifying glass icon. As you type, a predictive list of possible entries will appear – click on an entry to use it as the foundation for the search. The entire vault will be scanned and results of the search listed, in terms of matching Items.

The entire folder structure can be expanded or collapsed using corresponding commands (Expand All, Collapse All) available on the panel's right-click menu. To expand fully a particular folder and all its descendant sub-folders, right-click on that folder and use the Expand Subtree command.

Moving a Vault Folder

There are 2 ways to move a folder to a different location within the vault's folder structure:

  • Graphically, by clicking and dragging the folder entry to the desired position within the overall folder hierarchy.
     

     
  • By right-clicking on the folder entry and choosing the Move Folder command. The Move Folder dialog will appear – select which of the existing folders your chosen folder should be moved under. You can also move the folder to be a top-level folder in the vault.
     

Deleting a Folder

A folder can only be deleted if it is empty, that is it contains no sub-folders or Items. To delete a folder right-click and select the Delete Folder command.

Controlling the Content Displayed in the Vaults Panel

To configure the amount of detail displayed in the Vaults panel, use the icons located at the right-hand end of the Address Bar.

 - click to Hide/Display the Vault Folders region of the panel.
- click to Hide/Display the Item Details regions of the panel.

Vault Items

Each entity that is stored in the vault is called an Item. To support the need to be able to update an Item over time, what is actually stored in the vault is a series of Item Revisions, that is specific revisions of that Item, whose name is based on the chosen Revision Naming Scheme. Each new Item is created in a folder, once you have defined the required folders within the vault you can create new Items in the selected folder, in the Item region of the panel.

Right-click to create a new Item in the vault.

The following sections take a closer look at working with Items.

Item Types

Different Items are used to store and represent different types of release data. One Item could represent a schematic symbol, another a PCB component model, while another could contain the generated data from a released board design configuration, along with source design snapshot. To declare the type of content an Item (or rather its revisions) will be used to contain, its Content Type property needs to be specified when creating or editing that Item. To put this another way, you are in essence specifying the Item Type.

Creating an Item

To create an Item, right-click in the Item region of the Vaults panel and select one of the commands in the Create Item sub-menu. The sub-menu will change to display the most applicable content type, based on the type of folder in which the Item is being created.

When you select an Item type from the sub-menu the Create Item dialog will open, ready to define the Item properties. Note that the Content Type property of the Item will have been automatically selected, based on the menu entry you used to create the Item. As with folders, you always have full control over the type of Item you wish to create. To support this, when you right-click to create an Item an additional menu entry is available – Other Item Type. This command also opens the Create Item dialog, the difference is that you must now select the required type of Item from the Content Type list.

Use the Create Item dialog to specify the properties for a new Item.

Once the Item type is selected you can define the other properties of the Item and finalize its creation.

Items can be created manually and directly in a vault, as described. In some cases, a release process will create Items automatically – on-the-fly as it were.

Browsing Items

For each Item revision in a vault, the Vaults panel allows you to browse different aspects of that revision, where applicable. This is done using one or more views for that revision. At the top-level of this browsing functionality is a Summary view. From here, and depending on the type of Item being browsed, you can change to another view to explore where that revision of that Item is used (Where-Used), its child Items (Children or Preview), its current state (Lifecycle) and, for a Component Item, supply chain information (Supply Chain).

Browse different aspects of an Item revision using its associated views.

Right-Click Menus

Various commands are available from right-click context menus in the panel. The exact listing of commands will ultimately depend on the region of the panel in which you right-click, and the object currently in focus within that region. The following sections cover the commands available.

Commands for the Vault Folders Region

  • Add Top Level Folder – use this entry to add a new top-level folder into the vault folder structure. A sub-menu offers folder types for the three most used management zones (Component Management, Design Content, Production Release) as well as the Generic folder type. To browse and choose a different folder type, click on the Other Folder Type entry. The Add Top Level Folder dialog will appear in which to define folder properties.
  • Add Subfolder – use this entry to add a new sub-folder below the currently selected folder in the vault folder structure. A sub-menu offers those folder types most applicable, based on the parent top-level folder type. To browse and choose a different folder type, click on the Other Folder Type entry. The Add Subfolder dialog will appear in which to define folder properties.
  • Move Folder – use this command to access the Move Folder dialog, which can be used to change the currently selected folder's location within the overall vault folder structure.
  • Delete Folder – use this command to delete the currently selected folder. Deletion can only be made provided the folder is empty (contains no sub-folders or Items).
  • Expand Subtree – use this command to fully expand the currently selected folder and all of its sub-folders.
  • Expand All – use this command to fully expand all folders in the vault folder structure.
  • Collapse All – use this command to fully collapse all folders in the vault folder structure.
  • Refresh Vault – use this command to refresh the connection with the vault currently being browsed.
  • Properties – use this command to access the Edit Folder dialog, from where related properties for the currently selected folder can be view and modified.

Commands for the Items Region

  • Full Item Details – use this command to access a detailed view for the currently selected Item, opened as a new tabbed view within Altium Designer. The Item View provides a highly detailed view of the Revision and Lifecycle history of a specific Item, as well as showing all of the elements that make up that Item. The view also includes a Timeline. Use the Timeline to examine the exact time and date of any change made to the Revision level or Lifecycle State of that Item, and whom the change was made by.
  • Download Item-Revision – use this command to download released documentation associated to the currently selected Item-Revision. For example, a Blank Board Item will have design snapshot and released generated output. A Schematic Symbol Item will have an associated SchLib file, and so on.
  • Place Item-Revision – use this command to place an instance of the currently selected Item-Revision, where such placement is supported. For example, placement of a revision of a Component Item or Managed Sheet Item onto an active schematic sheet. The symbol for the component, or the managed sheet symbol, will appear floating on the cursor, ready for placement.
  • Create Item – use this entry to create a new Item within the currently selected folder. A sub-menu offers those content types most applicable, based on the type of folder in which the Item is being created. To browse and choose a different Item type, click on the Other Item Type entry. The Create Item dialog will appear, providing all controls necessary to fully define the Item.
  • Move Item – use this command to access the Move Item dialog, which can be used to change the folder of residence for the currently selected Item.
  • Delete Item – use this command to delete the currently selected Item. An Item can only be deleted if you are an Administrator of the vault in which that Item resides. In addition, you must delete Items from the 'top-down'. That is, you can't delete a child Item which is used by a parent Item, you need to delete the parent Item first.
  • Properties – use this command to access the Item Properties dialog. Here you can view the properties for the currently selected Item. If no revisions for that Item have yet been released, the properties can be modified.

Commands for the Lifecycle View

  • Place Revision – use this command to place an instance of the currently selected Item Revision, where such placement is supported. For example, placement of a revision of a Component Item or Managed Sheet Item onto an active schematic sheet. The symbol for the component, or the managed sheet symbol, will appear floating on the cursor, ready for placement.
  • View Revision Properties – use this command to access the Properties for Item Revision dialog, which provides a listing of properties associated to the parent Item, the selected Revision. Other properties are also listed, such as parameters for a component Item, or the parent design and configuration for a released board design Item.
  • Edit Revision – use this command to access the Edit Revision dialog, from where the properties for the selected Item Revision can be modified. This command is available only when the Item Revision is in the Planned state.
  • Delete Revision – use this command to delete the selected Item Revision. The Item Revision can only be deleted if you are an Administrator of the vault in which that Item resides. In addition, you must delete Items from the 'top-down'. That is, you can't delete a child Item Revision which is used by a parent Item, you need to delete the parent Item first.
  • Lifecycle State Transition commands – the menu will change to reflect the different state transitions that can be made, with respect to the Item Revision's lifecycle, and dependent on the current state reached within that lifecycle, and the lifecycle definition in-force for that Item. For example, for a newly released board design, sitting in the New From Design state and adhering to the default Structured Lifecycle With Approvals lifecycle definition, two commands will appear, Set Ready for Prototype Approval, and Abandon Design.
  • Establish Planned Revision – use this command to establish the next planned revision for the Item, corresponding to a change at the lowest level in a 3-level revision naming scheme (e.g. if 01.A.1 is the current Item Revision, then the next Item Revision to be established using this command will be 01.A.2).
  • Establish Planned Prototype – use this command to establish the next planned prototype for the Item, corresponding to a change at the second level in a 3-level revision naming scheme (e.g. if 01.A.1 is the current Item Revision, then the next Item Revision to be established using this command will be 01.B.1).
  • Establish Planned Model – use this command to establish the next planned model for the Item, corresponding to a change at the highest level in a 3-level revision naming scheme (e.g. if 01.A.1 is the current Item Revision, then the next Item Revision to be established using this command will be 02.A.1).
  • Establish Planned Item – use this command to create a new Item within the same folder as the currently selected Item Revision. The Create Item dialog will appear, providing all controls necessary to fully define the Item.

Notes

  1. The Vaults panel may be docked horizontally and/or vertically. Right-click on the panel's name and configure docking as required from the Allow Dock sub-menu.
  2. To learn more about Design Data Management using Altium Vaults, see the Vault-Driven Electronics Design section.
     
You are reporting an issue with the following selected text and/or image within the active document: