Contact our corporate or local offices directly.
Altium Designer, in conjunction with Altium Vault (3.0 or later), provides an improved approach to creating and working with Altium Designer Managed Projects and the release of their manufacturing output data.
Managed Projects are an advanced project construct that harnesses the capabilities of the Altium Vault’s version control, lifecycle management and user access control to create a sophisticated project storage and management foundation. Within the Vault, a Managed Project is inherently associated with its released production data, with both the design source and manufacturing output available from a single unified location.
Altium Designer works with Managed Projects by providing simplified, direct access to the Vault-based project data, while offering a host of advanced management features through its Vault interfaces. The approach to using Managed Projects parallels that of using local file based projects, yet is far more intuitive than the methodology required for traditional version control and storage systems – and as a bonus, it is fully integrated with the advanced features of Altium Designer and the Altium Vault.
A Managed Project can be created through Altium Designer’s standard New Project dialog (File » New » Project) by selecting the Managed option from the Project Kind drop down menu, and then (optionally) defining suitable target names. The automated settings are derived from the nominated project Name entry.
The preselected Repository target is the Vault’s own associated data repository – the DefaultRepository, which is created during the Vault installation – while the Repository and Vault folder names will match that of the project Name.
The default target settings will suit most circumstances, but can be edited in their respective dialog fields:
TCP/IP. Click the associated button to configure Altium Designer’s connections to Vault server repositories.
Instigating the create Managed Project process establishes the project structure in the Vault and opens the new project in Altium Designer. At this point the project can be edited and new documents added (Schematic, PCB etc), or the project simply saved (committed) to the Vault for later editing.
Commit the project, and any edits, to the Vault using the Save Managed Project command, available from the right-click context menu of the project name. In the following Commit to Version Control dialog, select the documents you would like to include in the Managed Project and add an optional Comment.
The saved and committed Managed Project is accessible by Altium Designer or through the Vault browser interface, where its properties (including access permissions and group assignments) can be managed.
An existing Altium Designer project, including one already under external version control, can be converted to a Vault-based Managed Project.
To convert the active project, right-click on its project name and select Convert to Managed Project from the context menu. In a similar way to creating a new Managed Project, the convert process first creates the structure in a Vault Repository and the project is then committed (saved) to the Vault.
In the initial Convert to managed project dialog, change the settings and entries as required, including the target Repository. The Repository drop down menu will offer the list of Repositories that are hosted by the Vault server.
Alternatively, for an Altium Designer project that is under version control in an ‘external’ Repository – one not hosted by the Vault server – the conversion process will default to using this Repository for version controlled file storage. The Managed Project added to the Vault is ultimately accessed and managed like any other.
In the initial Convert to managed project dialog, the target Repository can be changed from the external source Repository to one hosted by the Vault server (such as the
DefaultRepository), through the Design Repositories Preferences page, accessed via the dialog’s Design Repositories button ( ).
Once the convert step has been completed (for either type of project) it can be committed to the Vault. In the same way as when a new project is committed to the Vault (see above), select Save Managed Project from the project name right-click context menu to complete the process.
A Managed Project can be opened in Altium Designer from the Vaults panel, directly from the main menu, or through the Vault web interface.
The simplest approach is via the Open Managed Project dialog (File » Open Managed Project), which provides a simple interface to the available Managed Projects in the Vault. Select and Open a project to load (check out) a copy in Altium Designer.
The dialog includes an incremental (filter as you type) Search field, and the project listings offer a configurable range of information parameters for each entry – drag and drop the column headings to rearrange their order. To add or remove parameter columns, right click on a heading to open the Select Columns dialog with the Select Columns context command.
The dialog also provides the option of opening a Managed Project in a local directory other than the default, as defined by the connection properties for the Design Repository that is hosting that project. The properties for connected repositories can be accessed through the Data Management – Design Repositories page of the Preferences dialog (DXP » Preferences).
To select an alternative local directory when opening a managed project, choose the Open to custom path option in the Open Managed Project dialog, and navigate to the desired target folder.
A Managed Project that is selected in the Vaults panel (DXP » Vault Explorer) can be opened in Altium Designer from the panel’s Open button, when in the Project View mode. Similarly, in the Vault browser interface, select the project under the Projects tab, and then use the Open button to load the project in Altium Designer.
Both the Vault web (browser) interface and Altium Designer’s Vaults panel offer a dedicated Project view, which provides information on the state of a Managed Project and included several project management functions.
The Project view (rather than the Classic View, in the Vaults panel) provides information on the selected project through a series of selectable tabs.
The tab options are:
In the Structure view, the Item Revision entries in each box (Project, Sources etc) link to their released revisions – shown in the Classic view in the Vaults panel, or under the VAULT view in the browser interface.
The Project view in the Vaults panel (or the PROJECT tab in the browser interface) also offers project functions that apply to the overall Managed Project.
The function buttons are:
- Copy. Rename these to suit during the process, in the Clone Project dialog.
Contact our corporate or local offices directly.