Parent page: Designing with a Connected Server
Data can be extracted from your Workspace in the following ways:
- Batch download of components and models. For components, they are essentially exported to IntLib format. Components can also be acquired into an IntLib through use of the Content Cart.
- Checking out designs (if fully managed in the Workspace and you don't have a local working copy already).
- Stopping synchronization for unmanaged designs that have been made available (registered with) your Workspace.
- Downloading release packages.
The following sections take a look at how these various actions are performed.
Batch Download of Items
Altium Designer's Explorer panel supports the ability to select multiple Items in a managed content server, and have the source entities for those Items downloaded, en masse, into a newly created single source library or folder, as applicable. The following Item types are supported by this feature:
- Component Items - with the selected Component Items downloaded into a Zip archive file containing source symbol and model libraries, and a source Integrated Library Package (*.LibPkg).
- Symbol Items - with the symbols for the selected Items downloaded into a Schematic Library (
*.SchLib).
- Footprint Items - with the 2D/3D component models for the selected Items downloaded into a PCB Library (
*.PcbLib).
- Simulation Model Items - with the released data applicable to each Item in the selection (
*.SimModel, *.mdl, *.ckt) downloaded to a separate sub-folder.
Batch Download of Component Items
To download multiple Component Items:
- Browse to the server folder containing the Component Items you want to download.
- Select the revision of the Component Item(s) you want to include in the download. You can only choose one revision of a particular Component Item (typically the latest revision), but can include as many different Component Items in the download as required.
- Right-click on an entry in the selection and choose the Operations » Download selected component to zip command from the context menu.
- In the Save As dialog, specify the name, and location, for the generated Zip file. By default, the file will be named in the format Components - <Date> - <Time>.zip.
- Once ready, click the Save button to proceed with the download, and generation of the Zip file. An Integrated Library Package (*.LibPkg) will be created, with source SchLib (with symbols, parameters and model links) and PcbLib (with footprint models) files generated and added. This is then compressed into the Zip file, which is generated in the specified folder. An information dialog will confirm successful generation of the file.
Example download of multiple selected Component Items into a ZIP archive.
Use the source in the Zip archive to quickly generate an integrated library containing your chosen component(s).
Resulting Zip archive with the source for the downloaded components.
Batch Download of Symbol Items
To download multiple Symbol Items:
- Browse to the server folder containing the Symbol Items of interest.
- Select the Items required for download, using standard multi-select controls (Ctrl+click, Shift+click).
- Right-click on the selection and choose the Operations » Download selected symbol in library command.
- Use the Choose destination file dialog to determine where, and with what name, the new Schematic Library file is to be generated.
- Click Save - the SchLib will be created, with progress displayed in a dedicated Downloading dialog.
Once the download is complete, the Downloading dialog provides the ability to explore the downloaded content within Windows Explorer (click Explore), or to open the library within Altium Designer (click Open).
Example download of multiple selected Symbol Items into a Schematic Library document.
Each symbol is named using the source Item's Name field.
Resulting Schematic Library document with the downloaded symbols.
Batch Download of Simulation Model Items
To download multiple Simulation Model Items:
- Browse to the server folder containing the Simulation Model Items of interest.
- Select the Items required for download, using standard multi-select controls (Ctrl+click, Shift+click).
- Right-click on the selection and choose the Operations » Download selected sim model to folder command.
- Use the Browse For Folder dialog to determine the parent download folder for the models.
- Click OK - the download will proceed, with progress displayed in a dedicated Downloading dialog.
Once the download is complete, the Downloading dialog provides the ability to explore the downloaded content within Windows Explorer (click Explore).
Example download of multiple selected Simulation Model Items into a designated folder.
Within the destination folder, a sub-folder for each Item in the selection will be created, named using the Item-Revision ID. The release data can be found in the Released sub-folder therein.
Accessing the data for a Simulation Model Item included in a batch download.
Component Extraction using the Content Cart
You also have the ability to acquire components from your Workspace into an Integrated Library (*.IntLib). The vehicle through which this is done - your interface to the Workspace's Data Acquisition Service - is the Content Cart. Access to the Content Cart dialog is made from within the Explorer panel. While browsing your Workspace from which you wish to obtain data, right-click on an Item Revision that you wish to acquire, and choose the Add to Content Cart command from the context menu.
From the Content Cart dialog, the process to acquire into an IntLib is as follows:
- Click on the Select target server link and choose IntLib file from the menu.
Set the target of the Content Cart to be an IntLib file.
- Specify the name, and location, for the generated IntLib file. By default, the file will be named in the format Integrated_Library - <Date> - <Time>.IntLib, and generated in the location \Users\Public\Documents\Altium\AD<Version>\Library\ExportCmpLib. Modify this as required through the Save As dialog - accessed by clicking the Change link.
Accept the default target folder and filename, or change as required.
- If you need to acquire additional components into the same IntLib, click the Add More Items link, and choose the Select entry to access the Choose Item dialog. From here you can browse the source server for more Items. Alternatively, choose the Add manually entry to access the Add new items dialog. This dialog allows you to paste an external list of items that you require (one item per line), and which can then be searched for within the source server, using a chosen search criteria (GUID, Item ID, Name, or MPN).
- Once ready, click the
button to proceed with generation of the IntLib. A temporary Integrated Library Package (*.LibPkg) will be created, with source SchLib (with symbols, parameters and model links) and PcbLib (with footprint models) files generated and added. This is then compiled to produce the IntLib file, which is generated in the specified folder. An information dialog will confirm successful generation of the file.
Deliver the cart to the target folder, which will contain the required Integrated Library file.
After generation, the IntLib can be added as part of the available file-based libraries for the software (through the Installed tab of the Available File-based Libraries dialog). It will then be available for use from the Components panel. Place components from the IntLib into your design as required.
Checking Out Fully Managed Designs
For a fully managed design project - created and stored within the Workspace's Versioned Storage Git design repository - extraction from your Workspace is simply a case of checking out the design as a local working copy. This is performed directly from within Altium Designer using the File » Open Project command. The Open Project dialog will appear, from where you can choose which managed project to open from your Workspace - when connected to a Workspace, that Workspace will appear in the Locations region of the dialog, distinguished by the 
icon, and appearing with the name given to the Workspace.
Only those managed projects that have been shared with you (you have permission to access) will be listed.
You have the option to open the project to the default checkout path, or use the
drop-down menu to specify a custom path. The default checkout path is defined as a property of the design repository in which the project resides. For a Git repository (e.g. the
Versioned Storage repository that is native to the Workspace), this is the
Local Path field found in the
Git Repository dialog. For an SVN repository, this is the
Default Checkout Path field found in the
SVN Design Repository dialog. Access the properties dialog by selecting the entry for the repository - on the
Data Management - Design Repositories page of the
Preferences dialog - and clicking the
button.
Once opened, the project will appear under an entry for your Workspace, in Altium Designer's Projects panel.
Obtain a local copy of a managed project by opening it (essentially checking it out of your Workspace). Shown here is an example of opening a project from a connected Workspace.
Stopping Synchronization for Registered Designs
If you have simply 'registered' an unmanaged project (regular project, or a project currently under external version control) with your Workspace through use of the Make Project Available Online feature, then you already have the project. The version in the Workspace is a 'mirror' of it - a synchronized copy that allowed you to enjoy the collaborative features available through the Altium 365 platform, while keeping your original project intact in its original location.
While not required, you can stop the synchronization between your local project, and the managed incarnation of it that was made available in the Workspace - therefore removing all linkage to the Workspace - by clicking the 
button, provided on the General tab of the Project Options dialog. The Turn off project synchronization window will appear. Click on the Unlink option, then click OK back in the Project Options dialog. The local project will no longer be associated with the project in the Workspace, reflected in the Projects panel by the local project being presented under the active Project Group (*.DsnWrk), rather than as an entry under the active Workspace.
You can sever the connection between your local project and the incarnation of it made available in the Workspace.
Downloading Release Packages
Extraction of any and all releases of design projects - released into your Workspace using Altium Designer's Project Releaser - is simply a case of downloading those release packages from within the Workspace's browser interface.
Release packages are presented in the Manufacture view, when browsing a specific design project through the Projects Management page - an advanced, manufacturing orientated CAD-centric view of the project.
The
Projects Management page is opened by selecting the required project, clicking the
control above the listing of projects, and choosing the
Open entry on the associated menu. Alternatively, double-click directly on the required project entry in the list. The page will open in a new browser tab.
Any and all of the data sets included in a release can be downloaded. Click the 
button associated to the release to access a window in which to define which of that release's data sets to download. After clicking the 
button a single Zip archive containing a folder for each included data set will be downloaded to your Web browser's default downloads folder.
Click the Show Files control to browse the files involved with each data set that is part of the release. Download is supported at all levels of granularity - from the whole data set, to a particular folder/type of output, down to the individual file level. Hover over an entry and click the 
button to start the download. For a data set or specific folder of output, a Zip archive will be downloaded. For an individual file, that file (not zipped) will be downloaded.
The Manufacture view gives you access to the released data packages, with the ability to download released data at varying levels of granularity.
Data can also be downloaded when viewing a release package. To open a release package for viewing click on its associated
button to open the full release package. Alternatively click the
button and choose what to view - either the full release package (
All Release) or a specific assembly (variant). An opened project release is presented in a new
Manufacturing Portal browser tab.
