Contact our corporate or local offices directly.
Altium Designer 17, in conjunction with the Altium Vault (3.0 or later) offers the ability to apply Vault-based document files to Altium Designer’s New Document Default preferences, and in turn, Preferences file can be released to the Vault and reloaded at will.
In addition, the Vault based Preferences can be added to an Environment Configuration, which will assign those preferences to Altium Designer User groups (Roles) to constrain their design environment to the specified Preference settings.
To define the default files used for all new Altium Designer documents, documents links are added to the System – New Document Defaults page of the Preferences dialog (DXP » Preferences). The saved Preferences, and the defined default documents, will be applied whenever new design documents are created.
In Altium Designer, the documents applied to the default Preferences entries can be sourced from a local or network-based folder, or as version controlled and lifecycle managed Binary type Item revisions from the Altium Vault.
Within the Preferences dialog, individual document files are added to the File Templates list in the New Document Defaults page by selecting a document kind (type), and then the browse icon () at the right of the document field. Selecting the From Vault option will open the Choose item dialog, where an existing Binary file revision can be selected, or the target Binary Item for a new document created.
To add a Schematic document for example, select a suitable Vault folder (or create one) in the Choose item revision for template dialog, and then create a new
Binary type Item using the Add an Item link, or the right-click menu, in the Item area. When Binary File Items already exist, use the right-click Create Item » Binary File command.
Add relevant Comment and/or Description entries before closing the Create Item dialog. The new Binary File Item, in a
Planned state, will be added to the Vault. To add the desired document to the new Item revision, select the Upload option from its right-click context menu to open the Release File dialog.
Use the button to browse for and select the file to upload (in this example case, a Schematic document), or simply drag and drop a local file onto the dialog's Sources area. Dismiss the dialog (OK) to upload (release) the selected file to the target revision, which will changed to a
Released state – you may need to refresh the Choose Item revision dialog to see that change.
Close the dialog (OK) to register the Binary File document as the new default Schematic document in Altium Designer's Preferences dialog – note that the new default is shown as a path to the Vault Item. Close the Preferences dialog to save the new default document entry.
The new Schematic document released to the Vault Binary File revision will be used as the default document for new Schematics in Altium Designer, as now defined in the Preferences.
The released Schematic document is also accessible through the Vaults panel.
As an alternative to creating Vault Binary Items and uploading documents via the New Document Defaults page of the Preferences dialog, the Vaults panel can be used to perform those actions in advance. Once a set of default documents (of multiple types) have been released to the vault, the New Document Defaults preferences page in Altium Designer can be used to simply choose the appropriate Item revisions from the Vault.
To release a series of local documents to the vault – say, Schematic, PCB, OutJob, and Draftsman documents – use the Vaults panel to create a sequence of Binary File Items, and upload the files.
Create a target Item by right clicking in the Item space and selecting Create Item » Other Item Type, and then choose the
Binary File option in the Content Type menu. Add a Description/Comment and upload a suitable document file, in the same way as outlined above.
The assembled collection of default documents stored in the Vault are then available for addition to Altium Designer's New Default Documents settings, when and where they are needed.
The New Document Defaults page of the Preferences dialog allows file or Vault sourced files to be loaded for all types of Altium Designer documents. The current Preferences can be saved and loaded at will, and importantly, released to the Altium Vault as Managed Preferences for reuse by others. The range of preference settings (beyond the New Document Defaults) that are included when the Preferences released to the Vault depends on the options selected during the release process.
Preferences released to the Vault are version controlled and lifecycle managed by the Vault infrastructure, and can be manually loaded in to Altium Designer or automatically applied through the Vault’s Environment Configuration service.
The current Altium Designer Preferences, including the New Document Defaults settings, can be released to a target Item in the Vault via the Release To Vault option in the Preferences dialog’s Save drop down menu. Select the Choose option in the following Link Preferences to Vault Item dialog to navigate to and select an Altium Designer Preferences target Item in the Vault.
In the subsequent Choose Item dialog, select an existing preferences Item as the target, or use the Add an Item link or the right-click context menu to create a new
Altium Designer Preferences Item as the target – the release must target an Item in its initial
Planned state. When the dialog is closed (OK), the selected Item will then populate the Link Preferences to Vault Item dialog.
The way in which the range of Altium Designer Preferences are released to the Vault Item is managed through the following Release preferences dialog, which offers three applicable modes for how preferences option groups (pages in the Preferences dialog) will be applied to Altium Designer when a User signs in to the Vault:
The preferences modes can be set for individual option groups (pages) or entire preferences sections (for example, the PCB Editor section). The Apply options will set all preference groups to a nominated mode.
The released Preferences are subsequently available, as an Item revision in a
Released state, in the Altium Vault as reusable Managed Preferences.
To load a Managed Preferences revision from the Vault to Altium Designer, select the Load From Vault option from the Load drop down menu in the Preferences dialog, and then choose the desired Preferences Revision in the Vault Choose Item dialog.
In a suitably licensed Altium Vault, the Vault-based Team Configuration Center allows Managed Preferences to be included as part of an Environment Configuration profile, which when applied to Altium Designer on a User Role basis, will constrain Altium Designer’s environment to those Preferences.
Applied Managed Preferences that include New Document Defaults for example, will automatically load those preference options when an Altium Designer User signs in to the Vault as a member of the assigned Configuration Role. Ultimately, the User’s New Document Defaults are centrally determined by an Administrator of the Altium Vault, through an Environment Configuration defined in the Team Configuration Center.
To add a Managed Preferences revision to an Environment Configuration, first open the Vault browser interface and navigate to the Team Configuration Center page (ADMIN » CONFIGURATIONS). Select a Configuration Name to edit that profile, or use the button to create a new Configuration.
In the selected Environment Configuration page (see above), configuration Items are added to the available categories through their associated button, which for the Preferences category will open a Vault Explorer dialog for choosing a suitable Managed Preferences revision. Navigate to and select the desired Preferences revision by activating its checkbox.
The selected Preferences revision will be added to the Configuration. You can view its included Preferences options groups by selecting the Show details info link, and delete the entry with the Remove link. Finally, save the Configuration to confirm new new addition.
When an Altium Designer User, who is a member of a Role assigned to the Environment Configuration, signs in to the Vault, the Managed Preferences will be loaded in to Altium Designer.
Altium Designer’s existing Preferences settings will be replaced by those enabled in the Managed Preferences, as determined by the Preferences release options – those that were set Apply First Time or the read-only Apply and Lock option. Preferences that were set to Do Not Apply during release are unaltered in Altium Designer when the Configuration is loaded.
When Altium Designer’s Preferences are currently defined by Managed Preferences loaded through an Environment Configuration, the Preferences dialog (DXP » Preferences) will indicate this with a configuration icon () and a reference to the loaded Configuration Name. Note that the Preferences management menus (at the bottom of the dialog) are disabled, with the exception of the Save commands.
Contact our corporate or local offices directly.