Altium Designer Documentation

Management of a Specific Project in an Altium 365 Workspace

Created: September 11, 2018 | Updated: October 15, 2021

Parent page: Managed Projects

The Workspace provides an advanced, manufacturing-oriented CAD-centric view of the project. This management interface offers Design, Supply, Releases, and History view options:

  • Design – display and navigate source project design documents, view design object properties and place review comments. This view uses the Web Viewer interface to present your design across four distinct data sub-views, to show the source schematic(s), board in 2D, board in 3D and Bill of Materials respectively. This view is for the latest version of the source project data, rather than a specified release from that project, and so could be considered to be a work-in-progress (WIP) view. You can review both the base design and any defined variant thereof.
  • Supply – allows you to interactively examine work-in-progress (WIP) BOM data extracted from the design documents, including entries for Manufacturer and Supplier parts data derived from a project's populated ActiveBOM document.
  • Releases – view the releases for the project. Access is provided for opening the full release data, or a specific assembly package, which will be presented on a separate tab through a Manufacturing Portal. From this portal you can view and navigate the released file data, inspect the BOM, and view and comment on the snapshot of the design itself; the source for that released data. From either the Releases view, or through the Manufacturing Portal for a specific release, you'll have access to controls for downloading manufacturing data at various levels of granularity (from full data set(s) to individual generated output files). A chosen release can also be sent – as a Manufacturing Package – directly to your manufacturer. You even have the ability to compare Gerber data between releases or against a locally-generated file set.
  • History – browse a progressive timeline of major events relating to the project, including its creation, commits, releases, clones and MCAD exchanges. Each time a supported event happens in association with the project, that event is added to the timeline as a dedicated tile with various actions supported where applicable. For release events, you even have the ability to compare Gerber data between releases or against a locally-generated file set.

The detailed management page for the project is opened by selecting that 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.

Also available in the graphical view of the Projects page by selecting the tile for the required project, then clicking the control and choosing the Open command from the context menu. Alternatively, click on the project's name within the tile. When the Projects page is presented in its list view, click the control at the far right of the entry for the required project and choose the Open command from the associated menu.

Accessing the detailed management page for a project.Accessing the detailed management page for a project.

The detailed management page for the project can also be accessed from within Altium Designer. For the active managed project, use the Project » Show in Web Browser command, from the main menus. Alternatively, right-click on the entry for the project in the Projects panel and choose the Show in Web Browser command from the context menu. When browsing the project through Altium Designer's Explorer panel – configured in its default Project View rather than Classic View – access to the detailed management page is made by clicking the button.

The following sections take a closer look at the four views into the project design and its data, presented on the detailed management page.

Design

Related page: Web Viewer

The Design view provides interactive visual access to the project's design documents, property data for objects within those documents, and the ability to collaboratively comment on definable document locations. This view is for the latest version of the source project data, rather than a specified release from that project, and so could be considered to be a work-in-progress (WIP) view. You can review both the base design and any defined variant thereof.

You'll be able to search, select, cross-probe, and inspect components and nets throughout the design and across the various sub-views as applicable. And when viewing the board in 2D, you can even take measurements.

The Design view utilizes Altium 365's Web Viewer functionality to provide an immersive and interactive experience for reviewing the source schematic and PCB documents in your design project. Shown here is a schematic – hover over the image to see the PCB in 3D.The Design view utilizes Altium 365's Web Viewer functionality to provide an immersive and interactive experience for reviewing the source schematic and PCB documents in your design project. Shown here is a schematic – hover over the image to see the PCB in 3D.

Based on an advanced web graphics engine and interface – Web Viewer – you are provided with all the features needed to locate and visually inspect the design and its objects. The view also includes fully rendered 2D and 3D PCB layout views, object search, selection and cross-probe capabilities, and tree-based design document navigation. It also provides an interface to the active Comments system – which dynamically interacts with the design space – and a comprehensive properties listing for any selected design object.

Support is provided for downloading a Zip archive containing a snapshot of the WIP design project (base design), as well as the ability to generate and download the following derived outputs, taking setup information directly from the applicable Output Job file (where one exists):

  • A Zip archive containing Gerber and NC Drill files (generated for the base design only).
If an Output Job file does not exist, a default set of Gerbers (Gerber X2) will be generated for the used layers only (no mechanical layers). For NC Drill, only the *.txt format file will be generated.
  • Either a PDF of the full Draftsman-sourced documentation, which requires the Draftsman document to be present in the project (generated for the base design only – not for variants), or a PDF of just the Assembly drawings (generated for the active variant).
  • A PDF of the schematic documents (generated for the active variant).
  • A Zip archive containing the PCB in STEP format (generated for the active variant).
  • A CSV-format BOM (generated for the active variant).
When generating the BOM, the setup in any Output Job file will be taken and a CSV-format BOM is generated only, as this format is supported by most operating systems without having to worry about configuration and templates. Where an Output Job file does not exist, default fields for the CSV are used as follows: line number (if a BomDoc is available), name, description, designator, quantity, manufacturer and part number.
See the Web Viewer page for more information on the Design view functions.

Supply

The Supply view allows you to interactively examine work-in-progress (WIP) BOM data extracted from the design documents. The main grid lists all unique BOM parts () in terms of the following information:

  • Item ID
  • Designator
  • Quantity
  • Name
  • Description

Select a BOM part entry to view its symbol, footprint and associated properties in the right-hand pane.

The Supply view enables you to examine the BOM data for the latest version of the source (WIP) project data.The Supply view enables you to examine the BOM data for the latest version of the source (WIP) project data.

When an ActiveBOM document (*.BomDoc) is part of the design project, each BOM part entry () will include the primary Manufacturer part () and Supplier part () information in a hierarchical view – select an entry to see further details in the side pane.

The Supply view contains hierarchical manufacturer and supplier part data, extracted when an ActiveBOM document is present in the design project. Shown here is the associated information for the selected manufacturer part. Hover over the image to see the information for the selected supplier part.The Supply view contains hierarchical manufacturer and supplier part data, extracted when an ActiveBOM document is present in the design project. Shown here is the associated information for the selected manufacturer part. Hover over the image to see the information for the selected supplier part.

Use the Search field at the top-left of the grid to quickly find an entry of interest. You can search by any of the data columns for the BOM parts, as well as by Manufacturer Name/Part Number and Supplier Name/Part Number. Search is dynamic, with the grid filtered as you type.

When the design uses managed components, an indicator is used (to the left of the component designator entry) to reflect the revision status of that component:

– Current (the latest revision of the component is being used).

– Historical (a previous revision of the component, and not the latest, is being used).

Remember that the BOM in this view is for the latest version of the source project data, rather than a specified release from that project.
Projects that do not include part Manufacturer and Supply data (such as when an ActiveBOM document is not available) show BOM entries and data only.

Releases

The Releases view presents all project release packages that have been generated from the design space (see Releasing a Design), where each package incorporates the released Source, Fabrication and Assembly data.

The Releases view gives you access to the released data packages, with the ability to open a package for closer inspection through a dedicated Manufacturing Portal, and also to send a release to your manufacturer as a Manufacturing Package.The Releases view gives you access to the released data packages, with the ability to open a package for closer inspection through a dedicated Manufacturing Portal, and also to send a release to your manufacturer as a Manufacturing Package.

From this view you can:

  • Download any and all of the data sets included in a release. 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 browser's default downloads folder.
  • Open a release, which will be presented on a separate tab through a Manufacturing Portal. From this portal you can view and navigate the released file data, inspect the BOM, and view and comment on the snapshot of the design itself; the source for that released data. You'll also have access to controls for downloading manufacturing data at various levels of granularity (from full data set(s) to individual generated output file(s)).
  • Send a chosen release – as a Manufacturing Package – directly to your manufacturer.
  • Compare fabrication data (Gerber Comparison) – either between two releases or between a release and a locally-generated file set.
  • Change the lifecycle state for any of the data sets in a release.
  • Toggle the display of releases that contain one or more data sets in an inapplicable revision state (using the Show hidden releases control).
Lifecycle management is not available with the Standard Subscription Plan. As such, revision states for the data sets and the Show hidden releases control will not be available when connected to an Altium 365 Workspace with this level of access to Altium 365.

The following sections take a closer look at these various features and functionality in closer detail.

Browsing a Release Package

To open the full release package for viewing, click on its associated button. Alternatively click the button and choose what to view – either the full release package (All Release) or a specific assembly (variant). An opened release package is presented in a new Manufacturing Portal browser tab.

Accessing the dedicated Manufacturing Portal tab, with which to more closely inspect a specific release of a managed project.Accessing the dedicated Manufacturing Portal tab, with which to more closely inspect a specific release of a managed project.

The Manufacturing Portal presents data for the release package across the following views:

The Files view presents an overview of the release package in terms of what data sets it contains (with an indication of their lifecycle states), server-side parameters and a preview of the board in 2D and 3D. The full release package can be downloaded from this page in a single Zip archive (click ).

Expand the tree on the left to view the data sets involved in this release and the data each contains. For the design source, this is the snapshot of the design with all source files used in the release of this particular package. For the fabrication and assembly data sets, this will be the output manufacturing data generated as 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, or select an entry and click the button within the main viewing area. For a data set or specific folder of output, a Zip archive will be downloaded to your browser's default downloads folder. For an individual file, that file (not zipped) will be downloaded.

The Design Snapshot view applies the Web Viewer interface to provide interactive visual access to the design documents, property data for objects within those documents, and the ability to collaboratively comment on definable document locations. Standard review features include layer visibility selection and comment markup, as well as the ability to search, select, and inspect components and nets. You can even take measurements. Remember that you are not viewing the latest version of the source design data but rather the snapshot of it, at the time when the design was released to create this specific release package.

See the Web Viewer page for more information on the Design Snapshot view functions.

The Supply view provides a grid style listing of parts included in the design snapshot used to generate this release package, which when selected populate the right-side information pane with property data for that part. BOM data is extracted from the design source data or an ActiveBOM document if included in the project. In the latter case, each BOM part entry () will include the primary Manufacturer part () and Supplier part () information in a hierarchical view, as available from the ActiveBOM document – select an entry to see further details in the side pane.

All components for the base (non-varied) design are listed.

Use the Search field at the top-left of the grid to quickly find an entry of interest. You can search by any of the data columns for the BOM parts, as well as by Manufacturer Name/Part Number and Supplier Name/Part Number. Search is dynamic, with the grid filtered as you type.

In any of the three views:

  • Click the button at the top-right of the view to access controls for changing the lifecycle state of the data sets contained in the release, and also the Gerber comparison feature. For the latter, use the associated sub-menu to choose to compare with the fabrication data of another release package, or with an uploaded Gerber file set. Results will be presented in a dedicated Gerber Compare view, which opens in a separate browser tab. See the section Gerber Comparison for more detail.
  • Click the button to send the release of the project to your manufacturer – as a Manufacturing Package. The Sending to Manufacturer window will be presented in which to configure the content of the package, and to whom it will be sent. For more detail, see the next section.

Sending Data to Your Manufacturer

While you can download manufacturing data for a particular release of a managed project, then pass that over to your manufacturer, wouldn't it be cool if you could share that package directly with the manufacturer, in a way that was far more collaborative and interactive? This is exactly what you can do, and is one of the powerful, enticing aspects of the Altium 365 infrastructure platform. You can nominate which release of a project to send, configure its data content and then send that package – then referred to as a Manufacturing Package – to the required manufacturer. In essence, the package is shared with that manufacturer, who then receives an email invite to view the package directly through the Altium 365 Platform Interface (https://365.altium.com), courtesy of a dedicated Manufacturing Package Viewer.

The Altium 365 platform provides a dedicated Manufacturing Package Viewer – an element of the platform's Global Sharing support – which allows others to view a manufacturing package from any web browser – anywhere in the world – but outside of your Workspace, so that your designs themselves, and other valuable IP, are kept off-limits. For more information, see Global Sharing and Manufacturing Package Viewer.

From within the Releases view of the detailed management page for the project you can send a specific release of the project to your manufacturer – as a Manufacturing Package – by clicking the button associated with that release's entry.

The Sending to Manufacturer window will be presented in which to configure the content of the package, and to whom it will be sent.

You can send (share) a specific release of a project directly with your manufacturer.You can send (share) a specific release of a project directly with your manufacturer.

A manufacturing package is defined by configuring the following:

  1. Data – you need to define the content of the manufacturing package, the release data included in it. By default, the fabrication and assembly data sets will be added to the package already. To configure the package further, click the Configure control. In the subsequent pop-up window, enable the data sets that you want included (source design snapshot, fabrication and assembly data sets). To quickly enable all data sets for inclusion, enable the entry at the top of the listing.
You will not be able to send a manufacturing package to a manufacturer until at least one data set has been defined within that package (the Send button will remain unavailable – ).

You need to define which sets of data are to be included in the manufacturing package.You need to define which sets of data are to be included in the manufacturing package.

After enabling the data sets as required click the button. Entries for those data sets will appear at the top of the Sending to Manufacturer window.

To quickly remove a data set, click the remove cross at the top-right of its tile.
  1. Package Name – this will initially be that of the PCB Assembly itself. You can modify this as required.
  2. Revision – this field provides a simple string-based attribute that can be used to differentiate various manufacturing packages created from the same release. Initially this will be prefilled with '1', but you can enter what you need here. Be aware that this field is not auto-incremented in any way.
  3. Description – enter a description of what the package gives. This can help the manufacturer understand what it is they are getting in the package.
  4. Manufacturer Email – use this field to enter the email of your manufacturer (clicking away from the field, or pressing Enter to add that email). Typically you might have a single manufacturing point of contact, who will run with the data supplied in the package to get your board fabricated and then assembled. However, you can add as many unique email addresses as required. To remove an added email click the cross at its right.

With the package defined, click the button. The package will be shared with you (as the author of the package) and the specified manufacturer(s) and an entry for it will appear in the Sent region of the Releases view. The package will be named in the format Name.Revision.

After sending a manufacturing package an entry will appear for it back in the Releases view, in the Sent region.After sending a manufacturing package an entry will appear for it back in the Releases view, in the Sent region.

Click the control at the top-right of a sent manufacturing package tile to access the following commands:

  • Open – use this command to open the package within Altium 365's Manufacturing Package Viewer. The Viewer opens in its own browser tab and provides a summary overview of the design, with key board data, along with the ability to browse the structure of the shared data (and to download any individual file thereof as needed). You can also download the full package from this view. Fabrication, Assembly and Bill of Materials data sub-pages of the viewer are also provided, with the Fabrication and Assembly views utilizing the Web Viewer interface, providing a powerful interactive experience and allowing for comments to be added by all users to which the package has been shared. The Fabrication view presents the Gerber data for the release.
  • Share – access a window with which to share the package with others, by email invite. Controls, accessed by clicking the Advanced Settings control in the Sharing window, allow you to determine whether the person you share the package with can share with others or not, and whether they are allowed to download the package or any derived data thereof.

You can obtain a direct link to share with your manufacturer by clicking the control. Anyone with whom the package has been shared will be able to use the link to view that package.
  • Download – use this command to download the package as a Zip archive.
  • Delete – use this command to delete the manufacturing package, moving it to the isolated Trash area of the Workspace. Click the button in the confirmation pop-up to effect the deletion. This is a 'soft delete', the package can be restored or permanently deleted from the Trash area by the creator of the package, or an administrator of the Workspace.
When you delete a manufacturing package, access to it will also be removed from the Shared with Me page of the Altium 365 Platform Interface, for all people with whom it has been shared.

Manufacturer Access to the Package

The manufacturer to whom you sent the package will receive an email invite to access that package through Altium 365. Once they click the button in the email they will be taken to the Altium 365 Sign In page (unless already signed in to the platform, or AltiumLive). Upon signing in, they will be taken to the Manufacturing Package Viewer, with the shared package loaded.

If the manufacturer does not have an AltiumLive account, they will need to register for one first – a link is provided on the Altium 365 Sign In page.

Accessing the shared manufacturing package from the email invite that is received by the manufacturer.Accessing the shared manufacturing package from the email invite that is received by the manufacturer.

Any manufacturing package that has been sent will also be available from the Shared with Me page of the Altium 365 Platform Interface. A manufacturing package is denoted by the icon within its tile.

Example manufacturing package readily available from a users' Shared with Me page, once they are signed in to the Altium 365 Platform Interface.Example manufacturing package readily available from a users' Shared with Me page, once they are signed in to the Altium 365 Platform Interface.

The manufacturer can also access the package using the direct link, if you have copied and sent it to them.

Selecting a manufacturing package tile will present various controls and commands, as illustrated in the following image and detailed thereafter.

Select a manufacturing package on your Shared with Me page to access controls associated to it.Select a manufacturing package on your Shared with Me page to access controls associated to it.

  • Open – open the package in the Manufacturing Package Viewer, which will open as a separate tab of the browser. Double-clicking on the package tile (or clicking on the name of the package) will also open it.
  • Share – access a window with which to share the package with others, by email invite. Alternatively, obtain a direct link to share with your manufacturer by clicking the control.

If a package has been shared with a person who has not yet registered with AltiumLive, an entry for them will appear as Waiting.
The ability to share with others will depend on whether the author of the package has enabled that setting for you or not.
  • Download – download the package as a Zip archive.
The ability to download the package will depend on whether the author of the package has enabled that setting for you or not.
  • Delete – delete the package from your Shared with Me page. A warning window will appear alerting you to the fact that you will lose access to the package, but other collaborators will continue to have access to it. Click the button to effect the deletion.

Gerber Comparison

Making a final check of your fabricated board data prior to sending out to the manufacturer is always a good thing. The Gerber comparison feature facilitates just that, with the ability to quickly check to ensure no differences in your fabrication output between released iterations of your design project. It provides a purely graphical, layer-by-layer comparison, highlighting areas with changes using a bounding box and a number.

Access

The Gerber comparison feature can be accessed by:

  • Clicking the button associated with a specific release of a project in the Releases view of the detailed management page for that project. Choose which other release's fabrication data to compare against, or compare against an uploaded file set.

  • Clicking the button at the top-right of the Manufacturing Portal tab, when viewing a specific release package for a design project. Choose which other release's fabrication data to compare against, or compare against an uploaded file set.

  • Clicking the control at the top-right of a Project Released event tile in the History view of the detailed management page for the project. Compare against the previous release's fabrication data, select from all possible releases, or compare against an uploaded file set.

Comparing with a File Set

You have the ability to compare the Gerber data in a release package against an uploaded Gerber file set. This enables you to compare against, for example, Gerber data that has been generated locally from the latest live design, prior to making the next formal release of the project to your Workspace.

As mentioned previously in the Access section, this comparison is performed by choosing the Gerber to » Files entry in the applicable menu. The Compare Gerber window will appear. Either click on an existing zip of Gerber files, or upload a fresh set.

The Compare Gerber window populates with Gerber file sets that have previously been uploaded to your Altium 365 Personal Space. If you drag and drop a fresh zip of locally-generated Gerber data to the window, that Zip simply gets uploaded to, and presents within, your Personal Space.
In terms of CAM manufacturing files, you can upload a full set of Gerber files plus NC Drill data (within a Zip archive). Ensure that there is only a single listing (or folder) of Gerbers inside the archive. Ensure that the drill files are in the same listing (or folder) as the Gerber files. If located in a separate folder, they will be ignored.

The Gerber Comparison feature supports the comparison of data in a release package against a locally generated file set.The Gerber Comparison feature supports the comparison of data in a release package against a locally generated file set.

With the existing Gerber file set chosen, or uploaded, the result of the comparison will be presented momentarily – see the next section.

Comparison Result

Once the comparison release or uploaded file set has been chosen, the results of the comparison are presented in the Gerber Compare view, which opens in a separate browser tab.

Depending on the number of differences that exist, it can take a while to generate the comparison data. You can either wait, or close the Gerber Compare view – an email will be sent to you once the data is ready to view. Click the button in the email to access the Gerber Compare view again.

Example comparison of the generated Gerber data between a release package and a locally-generated (and uploaded) file set.Example comparison of the generated Gerber data between a release package and a locally-generated (and uploaded) file set.

By default, the Compare tab of the view is presented, to instantly view the differences between the two sets of Gerber data. Color coding is used to distinguish the older Gerber data (Red) from the new Gerber data (Green). Switch to view the Gerber data for either of the compared sets as required – the view switches to standard Gerber viewing mode, keeping the location and zoom-level the same.

Each detected difference is numbered and outlined. Click on an entry in the left-hand pane to focus on that specific difference in the main viewing area.

If you click on a layer that has no differences, you will be alerted to that fact in the main viewing window.

Browsing controls for the main viewing area are as follows:

  • Mouse wheel forwards/backwards to zoom in/out.
  • Click & hold (or right-click & hold), then drag to pan document.
  • Press R to reset the view of the document (to show entire document).

You can freely measure between any two points within the view, without any snapping guidance whatsoever. To do so click the button. The Measurements pane opens, the cursor changes to a cross-hair, and you will enter measurement mode.

Measurement is performed as follows:

  1. Position the cursor to where you wish to start measuring (Point 1) and click. The point is marked using a small white cross.
  2. Move the cursor to the required end point (Point 2) and click again. As you move the cursor, a measuring line is displayed as an aide, showing the current XY distance (from Point 1 to the end of the line).
Right-click before defining Point 2 to start afresh – ready to define Point 1 again.
  1. The Measurements pane reports the XY distance measured, the X (horizontal) distance, and the Y (vertical) distance.
Measurement units will initially be those used for the design itself, but can be switched between metric (mm) and imperial (mil) from the Info pane of the interface (accessed by clicking in the top-right control cluster).
  1. Continue measuring the distance between other points, or click the button again (or Esc) to exit measurement mode.

Example measurement taken on the Compare view of the Gerber data.Example measurement taken on the Compare view of the Gerber data.

The last five measurements are listed in the Previous Measurements region of the Measurements pane. The most recent is at the top of the list. Click on an entry to retrieve that measurement – both in the pane and graphically in the main viewing area.
Measurements are available during the current session of the web page only. If you refresh the browser tab, the previous measurements will be cleared.

Changing Lifecycle State

Lifecycle management features are not available with the Standard Subscription Plan.

For a release of a project you can change the lifecycle state for each of the data sets (items released to the Workspace) in that release, directly from within the Releases view. This is performed from the Change Lifecycle State window, accessed by clicking the button associated with the release and choosing Change Lifecycle State from the menu.

Change the lifecycle state for the data sets within a release package, directly from within the Releases view.Change the lifecycle state for the data sets within a release package, directly from within the Releases view.

Each data set is listed by name, along with its current lifecycle state and the next. Click within the Next State cell to access a list of possible states, in accordance with the lifecycle definition employed for that item. To exclude a data set from the list – so that its state will not be changed – click the control at the far right.

All possible transition states will be presented in the drop-down listing for the Next State cell. These are based on the Current State (two examples shown here) and are defined as part of the parent lifecycle definition.All possible transition states will be presented in the drop-down listing for the Next State cell. These are based on the Current State (two examples shown here) and are defined as part of the parent lifecycle definition.

After configuring the state changes as required, click . The lifecycle state information for each affected data set will be updated for that release, back in the main Releases view.

Example of having changed the lifecycle state twice for all data sets in a release – taking them from New From Design, through In Prototype, and ultimately to In Production.Example of having changed the lifecycle state twice for all data sets in a release – taking them from New From Design, through In Prototype, and ultimately to In Production.

In Altium Designer 21 and later, this ability to change lifecycle states for the various data sets in a release is available from the Explorer panel, when viewing the project in its Project View (not the Classic View).

Hiding Inapplicable Releases

The Releases view provides the ability to toggle the display of releases that are considered to be no longer 'for consumption'. This allows you to hide away any release package that contains one or more data sets in an inapplicable lifecycle state (e.g. Deprecated, Obsolete, Abandoned). This is determined by the applied Lifecycle definition itself, which can set those states as not to be used in designs.

The process to do this is as follows:

  1. Consider the following image showing two releases for a project, both of which have their constituent data sets sitting in the In Production state. The earlier release is considered to be obsolete (not to be used) and should be hidden – leaving just the latest release displayed.

A subsequent release of a design has gone into production, and the earlier release should be made obsolete and hidden from the Releases view.A subsequent release of a design has gone into production, and the earlier release should be made obsolete and hidden from the Releases view.

  1. The visibility of a release in the list is based on whether a data item, when it enters a particular lifecycle state, is permitted to be used in a design. In the applicable Lifecycle definition (Admin – Lifecycle Definitions) this is controlled by the state property Allowed to be used in designs. With this property disabled a release will be hidden, by default, when one of its data items enters that lifecycle state. In this example, we just need to check that the Obsolete state within the lifecycle definition that applies to released design items, has this property disabled – double-click on the state's graphic to open its State Properties window.

Checking that the Obsolete state has its Allowed to be used in designs property disabled – the key to being able to hide releases back in the Releases view.Checking that the Obsolete state has its Allowed to be used in designs property disabled – the key to being able to hide releases back in the Releases view.

  1. Now we just need to change the lifecycle state for the data items in the earlier release – setting them to be in the Obsolete state. This is achieved using the Change Lifecycle State window (click the button associated with the release and choose Change Lifecycle State from the menu), as described in the previous section. In this way, a design release that is obsolete and should not be used is unavailable to users.

Upon changing its data items to a lifecycle state that is not permitted for use, the release is hidden from the Releases view.Upon changing its data items to a lifecycle state that is not permitted for use, the release is hidden from the Releases view.

  1. Use the Show hidden releases control at the top-right of the Releases view to toggle the display of these hidden releases.

Use the Show hidden releases control to reveal/hide those releases that are not for consumption. Shown here is the default state of the control, showing only applicable releases – hover over the image to see the control enabled and the inapplicable release also shown.Use the Show hidden releases control to reveal/hide those releases that are not for consumption. Shown here is the default state of the control, showing only applicable releases – hover over the image to see the control enabled and the inapplicable release also shown.

In Altium Designer 21 and later, this ability to toggle the display of hidden releases is available from the Explorer panel, when viewing the project in its Project View (not the Classic View).

History

Related page: Project History

The History view provides a progressive timeline of major events relating to the project – its creation, commits, releases, clones and MCAD exchanges – with various actions supported where applicable.

To get the most out of this feature requires your project to be fully managed, by adding the project under the Workspace's own built-in VCS (Git). From the Workspace's browser interface, a new project is always created under this native VCS. From within Altium Designer, this is done using the Version Control option – when creating a new managed project, or making an existing unmanaged project available online (and where that project is not already under external version control). By doing so you will have access to the maximum functionality offered through, and by, the Workspace and the Altium 365 platform.

If your project is under external version control, you can migrate it to be a fully-managed project in the Workspace that hosts the design files in the server's own Git repository (effectively switching to the Workspace's native VCS). Altium Designer's Make Available Online dialog offers a Migrate to <server> Versioned Storage option that enables the VCS migration process in place of simply mirroring the project structure in the Workspace. If the external VCS project is already managed in the Workspace as a mirrored project (Simple Sync), its VCS files can be migrated to the Workspace's native Git repository using the Migrate to Versioned Storage command available from the Project History view, the General tab of the Project Options dialog, and the Projects panel's Version Control right-click context menu. For detailed information on how to do this, see Moving from External VCS to Workspace Native VCS.

The History view presents a timeline of basic events that have occurred during the project's evolution.The History view presents a timeline of basic events that have occurred during the project's evolution.

The view can essentially be broken down into three key sections:

  1. Main trunk of the timeline. The direction of event chronology is from the bottom up. The first event – the creation of the project – will appear at the bottom of the timeline. Subsequent events appear above, with the latest (the most current event) appearing at the top of the timeline.
  2. Events. Each time a supported event happens in association with the project, that event is added to the timeline as a dedicated tile. Each type of event will have a different colored tile and will either be linked directly to the main trunk of the timeline, or have some additional icon next to it (as is the case for MCAD Exchange events). For Commit events design diffing is supported, showing basic information on what has changed between the current and previous commits (including files, components, nets, PCB structure, variants). For the following two event types, additional operations are accessible from the event tile:
    1. Commit event – ability to create a clone of the project using that version of the design, and also the ability to download a snapshot of that version of the design.
    2. Release event – the ability to open that release package for viewing through a manufacturing portal and the ability to download either the full release package or the snapshot of the version of the design that was used to create that release package. You can also access the Gerber comparison feature. Use the associated sub-menu to compare the Gerber data of the release with that of the previous release, select from all releases that have been made for the project, or compare with a chosen locally-generated (and uploaded) file set.
  3. Search. Click the control at the top-right of the view to access a search field that facilitates basic searching of the project history. As you type your search string, filtering will be applied to the timeline to present only the events relevant to that search.
Whenever a supported event happens in relation to the project, that event will be detected and made available to the History view automatically. Notification will appear at the bottom of the view shortly after the event takes place – click the control to update the timeline with the new event. A manual refresh is also provided, performed by clicking the control at the top-right of the view.
Found an issue with this document? Highlight the area, then use Ctrl+Enter to report it.

Contact Us

Contact our corporate or local offices directly.

We're sorry to hear the article wasn't helpful to you.
Could you take a moment to tell us why?
200 characters remaining
You are reporting an issue with the following selected text
and/or image within the active document: