Altium NEXUS Documentation

WorkspaceManager_Cmd-CurrentProjectVariantCurrentProjectVariant_AD

Created: July 7, 2022 | Updated: July 7, 2022
Applies to Altium NEXUS Client version: 5
This documentation page references Altium NEXUS/NEXUS Client (part of the deployed NEXUS solution), which has been discontinued. All your PCB design, data management and collaboration needs can now be delivered by Altium Designer (with Altium Designer Enterprise Subscription) and a connected Altium 365 Workspace. Check out the FAQs page for more information.

Parent page: WorkspaceManager Commands

The following pre-packaged resource, derived from this base command, is available:


Applied Parameters: Index=n (where n is in the range 0 to 20)

Summary

This command allows you to quickly change the active variant for the design project, or to choose the base design. The ability to create variations of the same base design is a real strength of Altium NEXUS, and a tremendous productivity booster for designers. Using variants, you can define any number of variations of the base design, configuring each component to be:

  • Fitted
  • Not fitted
  • Fitted with modified component parameters, such as the component's value.
  • Alternate Part - completely replacing one component, with another.

Variants that use any of these types of variations are all referred to as Assembly Variants, as they only impact on the assembly process - all variants share the same fabricated bare board. There is also support for variations to component overlay information on the PCB, for example changing a components' comment. This type of variation requires two overlay screens to be produced, resulting in two different bare boards. This type of variant is referred to as a Fabrication Variant.

For a high-level look at working with variants in Altium NEXUS, see Design Variants.

Access

The related indexed commands are available from the Projects panel, from the right-click context menu associated to the Variants folder. The folder contains entries for the base design ([No Variations]), as well as all variants you have defined.

The Variants folder will be presented for a project in the Projects panel - and directly below that project's entry - provided at least one variant has been defined for that project.

Use

Use the menu to change the current variant to another defined variant for the design, or back to the base design ([No Variations]).

Tips

  1. The current variant is displayed in bold, white text.
  2. To make any listed variant the current variant, you can either double-click the desired variant in the panel, or right-click the desired variant and choose the Set as current command from the context menu. This approach also applies to switching to the base design, using the [No Variations] entry.
  3. To examine variant detail on a schematic you need to:
    1. Compile the project if it is not already compiled.
    2. Select the compiled tab down the bottom of the schematic sheet.
    3. Switch to the required variant.
    4. Components varied on this sheet will then be displayed, as configured in the Variant Options dialog.


Applied Parameters: Action=SetAsCurrent|Index=n (where n is in the range 0 to 20)

Summary

This command allows you to quickly set the focused variant to the active variant for the design project. The ability to create variations of the same base design is a real strength of Altium NEXUS, and a tremendous productivity booster for designers. Using variants, you can define any number of variations of the base design, configuring each component to be:

  • Fitted
  • Not fitted
  • Fitted with modified component parameters, such as the component's value.
  • Alternate Part - completely replacing one component, with another.

Variants that use any of these types of variations are all referred to as Assembly Variants, as they only impact on the assembly process - all variants share the same fabricated bare board. There is also support for variations to component overlay information on the PCB, for example changing a components' comment. This type of variation requires two overlay screens to be produced, resulting in two different bare boards. This type of variant is referred to as a Fabrication Variant.

For a high-level look at working with variants in Altium NEXUS, see Design Variants.

Access

This command is available from the Projects panel, by right-clicking on a variant entry within the Variants folder, and choosing the Set as current command from the context menu. The folder contains entries for the base design ([No Variations]), as well as all variants you have defined.

The Variants folder will be presented for a project in the Projects panel - and directly below that project's entry - provided at least one variant has been defined for that project.

Use

First, ensure that the entry for the variant that you wish to make the current variant, is focused in the Projects panel (or that the cursor is directly over its entry). If you want to make the base design the current variant, ensure that the [No Variations] entry has the focus.

After launching the command, the chosen variant will become the current variant.

Tips

  1. The current variant is displayed in bold, white text.
  2. Double-clicking directly on a variant's entry in the Projects panel will also make it the current variant.
  3. Any variant can also be made the current variant by choosing its entry from the right-click context menu associated to the Variants folder.
  4. To examine variant detail on a schematic you need to:
    1. Compile the project if it is not already compiled.
    2. Select the compiled tab down the bottom of the schematic sheet.
    3. Switch to the required variant.
    4. Components varied on this sheet will then be displayed, as configured in the Variant Options dialog.

 

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: