Altium Designer Documentation

Validating Component Status in Altium Designer

Modified by Jason Howie on Sep 22, 2020

Parent page: Working with the Project Releaser

Managed components offer the designer a formal collection of high-quality, high-integrity, design building-blocks. Revision-controlled and lifecycle-managed, a company can authorize the 'set' of components that can be formally used by their designers, in each new design project embarked upon within that company. However, while Component Items may be authorized for design reuse, there also needs to be automated checking at the release validation stage, to verify that they are indeed in the right state to be used.

Altium Designer, in conjunction with your managed content server, provides an elegant solution to this, in the form of Component State Checking. A validation-based outputter is available for addition to an Output Job file - Components states. This can be configured to check for components that are in restricted states. As part of configuration, you determine the action to be taken for each currently defined state, of each currently defined Lifecycle Definition in the server - no action, a warning, or generate an error. The latter will prevent release of the design. In addition, running the check will generate a handy HTML-based report, allowing you to see at-a-glance which design components are not in valid states.

Definition and use of lifecycle definition schemes is not supported in Altium 365 Standard. As such, the ability to configure a Component State Checking validation outputter will not be available when connected to an Altium 365 Workspace with this level of access to Altium 365.
Issues with using design items in restricted states can also be detected much earlier in the design cycle, by the Compiler, as part of project validation. This concerns an Item Revision's applicability based on its current state, and whether it is allowed to be used in designs while in that state. This is controlled through use of a dedicated attribute at the individual state level. A project compiler violation can be configured to detect and flag any server items being used in a design, whose revisions are in non-applicable states - catching and averting issues prior to release. For more detail, see Controlling Item Revision Visibility and Applicability.

Add an output generator of this type from the Validation Outputs section of the OutJob file. Configuration is performed in the Server objects State validation dialog.

To access this configuration dialog, either double-click on the entry for the outputter, right-click on its entry and choose Configure from the context menu, or select its entry and use the Alt+Enter keyboard shortcut.

Add and configure a component state check as part of your overall validation regimen during board design release.

The dialog presents all lifecycle definitions defined for the managed content server to which you are actively signed in. For each definition, each uniquely-defined state is listed, along with its description. For each state associated with a lifecycle definition you employ for components in your designs, simply specify the checking action to be taken. Click within a state's Check Action field and select the required action from the associated drop-down menu. Available checking options are None, Warning, and Error.

Click the  button to refresh the dialog with the latest lifecycle definition information, directly from the server.

Revisions of Component Items used in the design that are in a restricted state (one whose Check Action has been set to Error) will prevent the release of the board from happening. The generated report file will list all warnings and errors.

Example board release failing at the validation stage while checking component states. Hover over the image to see the generated report. Here, the design is found to contain four components that are in a restricted lifecycle state, and the release process is terminated in failure.

If you are using managed output job configurations, ensure the component state check is added to the relevant source Output Job file and configured BEFORE releasing that OutJob to the managed content server. Once managed, the OutJob file - specifically the configuration of an output generator - can not be changed. You would need to make changes and re-release into the next planned revision of the target Item. For more information, see Managed Output Job Files.


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:
Altium Concord Pro Free Trial

Please Complete the form below to get Free Trial of Altium Concord Pro