Altium NEXUS Documentation

Violations Associated with Components when Validating a Component in Altium NEXUS

Created: January 26, 2022 | Updated: March 17, 2022

Parent page: Verifying a Component

The Violations Associated with Components region on the Data Management – Component Rule Checks page of the Preferences dialog
The Violations Associated with Components region on the Data Management – Component Rule Checks page of the Preferences dialog

The Component Validator tests for an array of potential issues with component(s) and their defined models during component rule checking according to rules defined as part of software preferences – on the Data Management – Component Rule Checks page of the Preferences dialog.

For a detailed overview of verifying your component, see Verifying a Component.

The Violations Associated with Components region on the Data Management – Component Rule Checks page of the Preferences dialog allows specifying the severity level associated with check of component-related violations that can exist in the component(s) when validating them in the Component Editor. Use the following collapsible sections to access information on each violation available in this region.

Default report mode:

Summary

This violation occurs when the name of a component being defined in the Component Editor is the same as the name of a component in the connected Workspace.

Notification

A notification is displayed in the Messages panel in the following format:

Duplicate component by Name

Recommendation for Resolution

Assign different and unique name(s) to the component(s) as required.

  • In the Component Editor in its Single Component Editing mode, use the Name field in the Component region to specify another name which is unique for the components in the connected Workspace.
  • In the Component Editor in its Batch Component Editing mode, use the Item ID field in the Component column group of the component definition region to specify another name which is unique for the components in the connected Workspace.

Default report mode:

Summary

This violation occurs when a component being defined in the Component Editor has a Part Choice that is used by another component in the connected Workspace.

Notification

A notification is displayed in the Messages panel in the following format:

Duplicate component by Part Choice list

Recommendation for Resolution

Assign different and unique Part Choice(s) to the component(s) as required.

  • In the Component Editor in its Single Component Editing mode, use the Part Choices region to change the list of component Part Choices to which is unique for the components in the connected Workspace.
  • In the Component Editor in its Batch Component Editing mode, use the Part Choice n column group of the component definition region to change the list of component Part Choices to which is unique for the components in the connected Workspace.

Default report mode:

Summary

This violation occurs when a component being defined in the Component Editor has an ambiguous mapping between component symbol and footprint(s). For example, the violation occurs if the symbol has pins defined in their Designator fields as 1, 2, 3, while the footprint has pads defined in their Designator fields as B, C, E, or when the number of symbol pins is larger than the number of footprint pads.

Notification

A notification is displayed in the Messages panel in the following format:

Pin <PinDesignator> of the symbol <SymbolName> (<SymbolRevisionID>) does not have corresponding pad <PadDesignator> in footprint <FootprintName> (<FootprintRevisionID>)

where:

  • PinDesignator is the symbol pin's Designator.
  • SymbolName is the name of the symbol.
  • SymbolRevisionID is the Item-Revision ID of the symbol.
  • PadDesignator is the footprint pad's Designator.
  • FootprintName is the name of the footprint.
  • FootprintRevisionID is the Item-Revision ID of the footprint.

Recommendation for Resolution

Edit currently added or select another model to make sure that symbol pins have one-to-one matching to footprint pads.

  • In the Component Editor in its Single Component Editing mode:
    • click the  control at the top-right of model's preview to modify the model that is currently being used (referenced) by the component in the corresponding temporary editor for that model type;
    • click the  control at the top-right of model's preview and choose the Select Model entry from the menu to browse for and choose, a different model, or a different revision of that same model;
    • click the  control at the top-right of symbol's preview to access the Pins panel and change the mapped pad/pin targets directly by clicking on a cell of the model and entering the required value.
  • In the Component Editor in its Batch Component Editing mode:
    • right-click on the model entry in the Model Links region and choose the Edit command from the context menu to modify the model that is currently being used (referenced) by the component in the corresponding temporary editor for that model type;
    • click on the model's Item ID field in the Model Links region then click on the  button to browse for and choose, a different model, or a different revision of that same model.

Default report mode:

Summary

This violation occurs when the description of a component being defined in the Component Editor is not specified.

Notification

A notification is displayed in the Messages panel in the following format:

Component Description is not specified

Recommendation for Resolution

Specify a description for the offending component(s) as required.

  • In the Component Editor in its Single Component Editing mode, use the Description field in the Component region to specify a description.
  • In the Component Editor in its Batch Component Editing mode, use the Description field in the Component column group of the component definition region to specify a description for the offending component(s).

Default report mode:

Summary

This violation occurs when the name of a component being defined in the Component Editor is not specified.

Notification

A notification is displayed in the Messages panel in the following format:

Component Name is not specified

Recommendation for Resolution

Specify a name for the offending component(s) as required.

  • In the Component Editor in its Single Component Editing mode, use the Name field in the Component region to specify a name.
  • In the Component Editor in its Batch Component Editing mode, use the Name field in the Component column group of the component definition region to specify a name for the offending component(s).

Default report mode:

Summary

This violation occurs when the type of component being defined in the Component Editor is not specified.

Notification

A notification is displayed in the Messages panel in the following format:

Component Type is not specified

Recommendation for Resolution

Specify a type for the offending component(s) as required.

  • In the Component Editor in its Single Component Editing mode, use the Type field in the Component region to specify a type.
  • In the Component Editor in its Batch Component Editing mode, use the Type field in the Component column group of the component definition region to specify a type for the offending component(s).

Default report mode:

Summary

This violation occurs when a linked model that is being used (referenced) by a component definition is detected to be in an inapplicable state. For example, the model is currently Obsolete and should therefore not be used. Applicability is determined through the Allowed to be used in designs option in the State Properties dialog. From within the Edit Lifecycle Definitions dialog, access this dialog for the required state, either by double-clicking on the state's entry within the parent lifecycle definition or by selecting its entry and clicking the edit icon that appears (). When this option is enabled, a model in this state is permitted to be used in a component. It is deemed to be Applicable. If this option is disabled, a model in this state cannot be validly used and is deemed Inapplicable (or non-applicable).

The Edit Lifecycle Definitions dialog is itself accessed from the Data Management – Servers page of the Preferences dialog, by clicking the Properties button for the Workspace to which you are actively connected, then selecting Lifecycles from the drop-down menu.

Notification

A notification is displayed in the Messages panel in the following format:

<ModeName> (<ModelRevisionID>) revision is in inapplicable state

where:

  • ModelName is the name of the model.
  • ModelRevisionID is the Item-Revision ID of the model.

Recommendation for Resolution

Choose a replacement model or revision of the same model that is valid for use in the component.

  • In the Component Editor in its Single Component Editing mode, click the  control at the top-right of model's preview and choose the Select Model entry from the menu to browse for and choose, a different model, or a different revision of that same model.
  • In the Component Editor in its Batch Component Editing mode, click on the model's Item ID field in the Model Links region then click on the  button to browse for and choose, a different model, or a different revision of that same model.

Default report mode:

Summary

This violation occurs when a linked model that is being used (referenced) by a component definition is detected to be out of date. If there is a later revision of the model available, the Revision State field will reflect this using the text Out of date, to the right of the current revision's lifecycle state under the model's preview (in the Component Editor in its Single Component Editing mode), or the Revision Status field in the Model Links region will be flagged by the text Out of date, shown in bold font (in the Component Editor in its Batch Component Editing mode).

Notification

A notification is displayed in the Messages panel in the following format:

<ModeName> (ModelRevisionID) revision is Out of Date

where:

  • ModelName is the name of the model.
  • ModelRevisionID is the Item-Revision ID of the model.

Recommendation for Resolution

Update the component model links that are out-of-date to use the latest revision of the models.

  • In the Component Editor in its Single Component Editing mode, click the  control at the top-right of the model's preview and choose the Update to Latest entry from the menu.
  • In the Component Editor in its Batch Component Editing mode, right-click anywhere on the model's entry in the Model Links region and choose Update to Latest Revision from the menu.

Default report mode:

Summary

This violation occurs when the component revision being edited in the Component Editor in its Single Component Editing mode is not the latest revision available in the connected Workspace.

Notification

A notification is displayed in the Messages panel in the following format:

<ComponentName> (<ComponentRevisionID>) revision is Out of Date

where:

  • ComponentName is the component's Name.
  • ComponentRevisionID is the Item-Revision ID of the component.

Recommendation for Resolution

Select the latest component revision for editing. To do this, browse for the component in the Components panel, right-click its entry in the panel and choose Edit.

Default report mode:

Summary

This violation occurs when an incorrect entry for a component's part choice is added, and the part can not be retrieved by the Workspace.

Notification

A notification is displayed in the Messages panel in the following format:

Manufacturer+Part Number combination was not found in the available Part Sources ("Part Choice <n>")

where:

  • n is the sequential number of the offending part choice.

Recommendation for Resolution

Specify valid part choice for the offending component(s).

  • In the Component Editor in its Single Component Editing mode, remove invalid part choices from the Part Choices region and add new, correct part choices.
  • In the Component Editor in its Batch Component Editing mode, enter correct values to the Part Choice n fields in the component definition region. Note that while a part choice field value has an incorrect entry, the text will appear greyed and in italics. Once both entries are correct, the text will appear as normal, white text.
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: