Altium Designer Documentation

WorkspaceManager_Err-FailtoaddalternateitemFail to Add Alternate Item_AD

Modified by Susan Riege on Aug 4, 2021
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.

联系我们

联系原厂或当地办公室

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 Designer 免费试用
Altium Designer Free Trial
我们开始吧!首先,您或者您的公司已经在使用Altium Designer了吗?

如果您有任何需求,请点击这里联系获取当地办公室销售代表联系方式。.
Copyright © 2019 Altium Limited

既然您在使用Altium Designer,为何仍需要试用?

如果您有任何需求,请点击这里联系获取当地办公室销售代表联系方式。.
Copyright © 2019 Altium Limited

好的,实际上您无需下载一个试用版本。

点击下方按钮下载最新版本的Altium Designer安装包

下载Altium Designer 安装包

如果您有任何需求,请点击这里联系获取当地办公室销售代表联系方式。.
Copyright © 2019 Altium Limited

填写下方表格,获取Altium Designer最新报价。

点击[获取免费试用],并同意我们的隐私政策。您会接收到来自Altium的资讯,并允许其改变您的通知首选项。

如果您是Altium维保期内客户,您不需要下载试用版本。

如果您不是Altium维保客户,请填写下方表格免费试用。

点击[获取免费试用],并同意我们的隐私政策。您会接收到来自Altium的资讯,并允许其改变您的通知首选项。

您为何想要试用Altium Designer?

如果您有任何需求,请点击这里联系获取当地办公室销售代表联系方式。.
Copyright © 2019 Altium Limited

那您来对地方了!请填写下方表格申请试用吧。

点击[获取免费试用],并同意我们的隐私政策。您会接收到来自Altium的资讯,并允许其改变您的通知首选项。

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.

点击[获取免费试用],并同意我们的隐私政策。您会接收到来自Altium的资讯,并允许其改变您的通知首选项。

好的,您可以下载免费的Altium Designer Viewer查看文档,有效期6个月。

请填写下方表格申请。

点击[获取免费试用],并同意我们的隐私政策。您会接收到来自Altium的资讯,并允许其改变您的通知首选项。

好棒!创作是一件超酷的事情,我们可以为您提供完美的设计软件。

Upverter是一个社区导向的交流平台,专为您这样的创客量身定做。

点击这里看看吧!

如果您有任何需求,请点击这里联系获取当地办公室销售代表联系方式。.
Copyright © 2019 Altium Limited

好的,您可以下载免费的Altium Designer Viewer查看文档,有效期6个月。

请填写下方表格申请。

点击[获取免费试用],并同意我们的隐私政策。您会接收到来自Altium的资讯,并允许其改变您的通知首选项。