Altium NEXUS Documentation

Fail to Add Alternate Item

Modified by Susan Riege on Feb 28, 2019
All Contents

Parent category: Violations Associated with Others

Default report mode:

Summary

This violation occurs when an Alternate Part - chosen to be used for a component in a defined Variant of the active design project - cannot be added. This happens when a part with the same name, but resides in different libraries, is used across different Variants for the project. The .PrjPcbVariants file, which stores the information for the alternate parts chosen, cannot store multiple parts with the same name, and so references to the other instance(s), resident in different libraries, will not be added. For example, consider the situation where the following variants of a design project have been defined with an Alternate Part chosen for a placed capacitor:

  • Variant 1 - Alternate Part Cap chosen, that resides in library Lib1.SchLib.
  • Variant 2 - Alternate Part Cap chosen, that resides in library Lib2.SchLib.

On compilation, only the first instance is added to the .PrjPcbVariants file - Cap from Lib1.SchLib. Reference to the chosen Cap component to be used in Variant 2 will not be added and, therefore, the violation will be flagged.

Without resolution, the chosen part for the variant will be missing from a generated Bill of Materials!

Notification

If compiler errors and warnings are enabled for display on the schematic (enabled on the Schematic - Compiler page of the Preferences dialog), an offending object will display a colored squiggle beneath it. Hovering over the object will display a pop-up hint that summarizes the violation. A notification is also displayed in the Messages panel in the following format:

Fail to add alternate item for "Component <Designator> <AlternatePartName>" in variant "<VariantName>". Library "<LibraryName>" is not available. Please add missed library to project or try to select another alternate item from available libraries

where:

  • Designator is the designator of the component in violation.
  • AlternatePartName is the name of the chosen Alternate Part for the component.
  • VariantName is the name of the design variant for which the chosen Alternate Part cannot be added.
  • LibraryName is the name of the library in which the chosen Alternate Part resides.

Recommendation for Resolution

Use the Details region of the Messages panel to cross-probe to the component in question. There are two solutions available to resolve this type of violation:

  1. Add the library containing the part that cannot be added to the project - so while the Alternate Part cannot be added as a reference to the .PrjPcbVariants file, the software can still get at it by virtue of its library being made available to the project. Recompile the design project - the violation should now have been resolved and no longer appear (unless there are multiple components with this issue, in which case, repeat the process of making the required library(ies) available).
  2. Change the Alternate Part for the affected Variant to one that is in a library already available to the project. To do so:
    1. Make the relevant variant the current variant, from the Variants folder for the parent project in the Projects panel. Switch to the Compiled tab for the document, then right-click on the part in violation and choose Part Actions » Variants. This gives access to the Variant Management dialog with only the offending component in only that chosen variant, presented.
    2. Use the Component Variation field to access the Edit Component Variation dialog.
    3. With the Alternate Part option still selected, use the other options in the dialog to browse to and choose a more suitable replacement component to be used in that specific variant of the design and one that is resident in a library already available to the project.
    4. OK out of the dialogs and recompile the design project. The violation should now have been resolved and no longer appear (unless there are multiple components with this issue, in which case, repeat the previous steps).

Tip

  • Object hints will only appear provided the Enable Connectivity Insight option is enabled on the System - Design Insight page of the Preferences dialog. Use the controls associated with the Object Hints entry in the Connectivity Insight Options region of the page to determine the launch style for such hints (Mouse Hover and/or Alt+Double Click). 

 

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.

You are reporting an issue with the following selected text
and/or image within the active document:
ALTIUM DESIGNER FREE TRIAL
Altium Designer Free Trial
Let’s get started. First off, are you or your organization already using Altium Designer?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

In that case, why do you need an evaluation license?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Got it. You actually don’t need an evaluation license for that.

Click the button below to download the latest Altium Designer installer.

Download Altium Designer Installer

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Please fill out the form below to get a quote for a new seat of Altium Designer.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

If you are on Altium Subscription, you don’t need an evaluation license.

If you are not an active Altium Subscription member, please fill out the form below to get your free trial.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Why are you looking to evaluate Altium Designer?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

You came to the right place! Please fill out the form below to get your free trial started.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Great News!

Valid students can get their very own 6-month Altium Designer Student License for FREE! Just fill out the form below to request your Student License today.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Got it. You can download a free Altium Designer Viewer license which is valid for a 6 months.

Please fill out the form below to request one.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

That’s great! Making things is awesome. We have the perfect program for you.

Upverter is a free community-driven platform designed specifically to meet the needs of makers like you.

Click here to give it a try!

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Got it. You can download a free Altium Designer Viewer license which is valid for a 6 months.

Please fill out the form below to request one.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.