Altium Designer 14.3, in conjunction with the latest Altium Vault, brings support for Managed Projects. In the past, the traditional use of an Altium Vault was to handle the release management stage of projects, with high integrity and security. Managed Projects target the development stage of the project lifecycle, simplifying the creation and ongoing workflow for version controlled projects. Centralized storage under the control of the Altium Vault also enables this feature to be a foundation for other collaborative services.
Some key benefits to using Managed Projects are:
- Simplified storage. No need to make decisions about storage locations. Backup and other basic services are taken care of.
- Foundation for collaborative features.
- Enforced version control.
- Beneficiary of a dedicated commenting system.
- Notifications and status. Document status including local modifications is visible to entire design teams.
- Concurrent PCB design works without any complex setup.
Technically a Managed Project is the combination of meta information stored on the server, along with tight integration with SVN. The typical work flow is as follows:
- A user creates a new managed project (via the New Project dialog, from the vault's browser-based interface, or by converting an existing project). During creation, that user defines the project's name, description and svn repository.
- In the browser-based interface, access to the project is defined and managed.
- All collaborators use the File » Open Managed Project command, and select the required project, after which it is automatically checked out.
Creating a new Managed Project through Altium Designer
From within Altium Designer, a new Managed Project can be created using the New Project dialog (File » New » Project):
- Select the project type, choosing from the applicable templates available as required.
- Give the project the desired name.
- Use the Location field to determine where, on your local drive, to initially store the project, prior to its commital to the centralized Design Repository.
- Enable the Managed Project option.
- The Repository field will list all Design Repositories managed through the Altium Vault's local SVN service, and which have been shared with you to use. Choose the repository in which to store the new project.
- Specify the name of the folder within the repository in which to accommodate the project and its associated files. By default, this will take the project's name.
Setting up to create a new Managed Project from within Altium Designer, courtesy of the New Project dialog. Note that only those central Design Repositories that are shared with you will be available for selection from the Repository field.
After clicking OK, the new project will be created locally, in accordance with the defined Location. The project will be opened in the Projects panel, which will show the project and files as being Scheduled for addition, denoted by a blue cross icon (). Right-click on the project in the Projects panel and choose Version Control » Commit Whole Project, or Save Managed Project. You will be presented with the Commit to Version Control dialog. Simply select the files you wish to commit to the Design Repository and click OK. Once added, the Projects panel will reflect the fully synchronized state that exists between the files in the repository and the local working copy.
Commit the newly created Managed Project to the target Design Repository.
In addition, an entry for the project will appear on the Projects page of the Altium Vault's browser-based interface.
The newly-created Managed Project, evident on the Projects page of the vault's browser interface.
Creating a New Managed Project from the Vault's Browser-Based Interface
A Managed Project can be created directly through the Altium Vault's browser interface. Simply sign in and access the Projects page of this interface. Any previously created projects will be listed here. To create a new project, click the Add Project button at the top-right of the page. The Add Project pop-up window will appear.
Add a new Managed Project directly through the vault's browser interface.
Use this pop-up to define the following properties for the project:
- Name - a meaningful name to reflect the purpose of the project.
- Description - an optional entry offering additional information about the project.
- Project Type - the type of project, from a list of all project types supported by Altium Designer.
- Repository - the target Design Repository in which the project and its files are to be stored. Only those repositories defined on the VCS page of the interface will appear here.
- Directory Name - a specific directory folder within the Design Repository, in which to store the project and its files. By default, this field will mimic the entry for Name.
Additional Managed Project, added to the list of centrally-managed projects.
Converting an Existing Non-Managed Project to a Managed Project
You can also create a Managed Project from an existing non-managed one, simply by converting the latter to the former. To do this, open the existing non-managed project as normal, then right-click on its entry in the Projects panel, and use the Convert to Managed Project command from the context menu.
The Convert to Managed Project command instigates the Convert to Managed Project dialog, which operates in two modes - Simple and Advanced. Click the button at the bottom-left to switch between these two modes accordingly.
- Simple Mode - requires the user to determine the project's name, and a description. By default, the name will be that of the original project.
- Advanced Mode - provides access to the managed Design Repository. Choose from all managed repositories shared with the current user signed in to the Altium Vault, as defined on the VCS page of the vault's browser interface. The repository path and directory therein are shown, the latter of which can be modified as required (by default a folder of the same name as the project will be created within the repository). The path to the local working copy of the project is also reflected.
Convert an existing project to a Managed Project.
With the properties for the Managed Project defined as required, click OK. The Add to Version Control dialog will subsequently open with all pertinent files selected for addition. Check all is as required and click OK. The project and files will be identified in the Projects panel as being Scheduled for addition, denoted by a blue cross icon (). Right-click on the project in the Projects panel and choose Version Control » Commit Whole Project. You will be presented with the Commit to Version Control dialog. Simply select the files you wish to commit to the Design Repository and click OK. Once added, the Projects panel will reflect the fully synchronized state that exists between the files in the repository and the local working copy.
Adding and commiting the project to the target managed Design Repository, reulting in the project becoming a true Managed Project.
The newly-converted Managed Project will subsequently be available from the Projects page of the vault's browser interface.
The converted project is added to the list of centrally-managed projects.
Sharing a Managed Project
Once a project is managed, you'll want to determine which users can actually access that project. This is done by sharing the project, or rather, by configuring its access permissions.
To share a Managed Project, click on the icon, associated to the project you wish to share. The Manage Permissions for Project pop-up window will appear. Use this to define specific users or roles with whom the project can be freely accessed.
Define permissions for the project - with whom the project can be shared.
Once shared, a user will be able to 'see' the project when they sign in to the browser interface and access the Projects page. They will also be able to open and work on that Managed Project, from within Altium Designer.
Opening a Managed Project
To work on a Managed Project - essentially checking out as a local working copy - use the File » Open Managed Project command. The Open Managed Project dialog will appear, from where you can choose which Managed Project to open. Only those Managed Projects that have been shared with you (you have permission to access) will be listed. The dialog operates in two modes - Simple and Advanced. Click the button at the bottom-left to switch between these two modes accordingly.
- Simple Mode - requires the user to simply choose the required project.
- Advanced Mode - the user can switch source Managed Design Repository, if multiple repositories are available to them. They can also change where the local working copy is checked out to.
Choose which Managed Project to open, from those currently shared with you. With the dialog in Advanced Mode, you can change Design Repository, and also working directory.