Contact our corporate or local offices directly.
Along with the Fabrication, Assembly and Source information that is generated and packaged by Altium Designer’s Project Release process, there can also be a need to include information files that have not been generated by Altium Designer. Such files are not directly part of the electronic design process, are not necessarily ‘native’ to Altium Designer, but offer value when included in the released project package.
Like all files that are to be included in a Project Release, non-native files need to be referenced by an Output Job (commonly known as an OutJob) that will drive the release process. One of the primary functions of OutJobs is to facilitate this collected release of output data, including a snapshot of the design files, to a specified location such as a local folder or the Altium Vault. A Project Release will generally include all the physical and engineering data required to manufacture the project in its current form, and any information contributed by optional non-native files.
In essence, an Altium Designer OutJob is a highly configurable mechanism for defining the output files that will be generated from PCB projects. Saved as part of a project, an OutJob maps generated outputs to individual ‘Containers’ that relate to the file format and function.
To include non-native files, or in fact any file, OutJobs provide a specific PostProcess Outputs category that maps to Folder Structure type Output Container. A PostProcess Output behaves as a file copy mechanism and can be configured to locate and map files to the Container for eventual inclusion in the Project Release process.
Multiple files, or groups of files, are added to the Output in the Copy Files List Setup dialog, which is opened from the Configure option in the Output name’s right click context menu.
Select the dialog’s Add button to create a file list entry in the Build Macro Path dialog. The dialog's source files location and type field provides options for the source path, a subfolder and a file type filter mask.
The macro path options are:
Use the options to create a unique mapping path to the desired files, and then dismiss the dialog (OK) to add the path and filter as an entry in the Copy Files List Setup dialog. Any number of Files and Folders entries can be added to the dialog, which will all be gathered under the current PostProcess Outputs entry name in the OutJob – in this case:
To check that the Copy Files type Output generator has included the desired files and folders, ensure that its mapping to the Folder Structure container is Enabled (via its associated checkbox), and then view the container Properties via its right click menu, or by selecting the Change link.
Under some circumstances it may be desirable to include a native Altium Designer file in a specific Output job category, for example adding the project PCB file (
*.PcbDoc) as a reference to the Fabrication Outputs. The method adding a native file (or multiple files) to the Copy Files list is identical to that when including non-native files, except that the Project source path is selected rather than the Project Dir option.
OutJob documents drive the Altium Designer Design Release process, and this will include any PostProcess Output files added to an OutJob used by the release process.
Read about the Project Releaser
The Project Releaser is accessed from the Project » Project Releaser menu command, and will access all OutJobs in the currently active project. It can release the current project to a local target folder as an archived package, or perform an automated release to Item revisions in the Altium Vault.
Open the Project Release Options dialog () to set which OutJobs apply to the release data categories (Source, Fabrication and Assembly) and nominate a Release Target (Folder or Vault) in the Project Release Options dialog.
Select the button to instigate the Release process, which will generate and list all files included in the Release within their assigned categories. Note that the Fabrication Data category includes a Copied PCB document file, as added to the Fabrication OutJob document (
Fab.OutJob) in the example above. Select associated View link to open the file (in this case in the PCB Editor), and select the Details link in the Category section (Fabrication Data) to see a full list of the included files and status of each.
Select the button to complete the Release process – see Releasing a Design with the Project Releaser for more detail.
To release the project to the Vault, select the Altium Vault option from the Release Target drop down menu in the Project Release Options dialog (), and then proceed as described above. A Confirm Release dialog follows the Prepare then Release actions, where the release structure hierarchy is shown and Release Notes can be entered.
When the Project Releaser has completed all stages of the release, a summary page details the target Item Vault Navigation Links and a tree-based list of the released files (Data Reports) – any files released through an OutJob PostProcess inclusion are shown under the Copy Files branch.
The released project can be viewed in the Vaults panel, which in the Item Preview mode, will show the files included in each released Item Revision – the Source, Fabrication and Assembly Items. Note here that the files released into the Fabrication Item Revision (
FAB-EMX26-F) include a Copy Files entry for the PCB document file (
Contact our corporate or local offices directly.