Managing Your ActiveBOM Solutions in Altium Designer

Parent page: BOM Management with ActiveBOM

Manufacturer-centric Solutions for Both Workspace and Non-Workspace Library Components

Design components that are stored in a Workspace are referred to as Workspace Library components. As well as delivering full revision history and lifecycle management, another strength of using a Workspace is that it allows the design component to be coupled to the supply chain, in real time. This mapping from the design part to the manufactured part is done in a Part Choice. From the manufacturer and part number details stored in the Part Choice, the software can use the Altium Cloud Services to access detailed and up-to-date supply chain information for that part.

Components not placed from a Workspace are referred to as non-Workspace Library components. While these parts do not have Part Choices defined, they are still supported by ActiveBOM. Since non-Workspace Library components do not come with links through to the supply chain, those links can be defined in ActiveBOM instead. ActiveBOM can search the parts for suitable manufacturer details in the existing component parameters. If a design part does not include sufficient manufacturer details, then the designer can define manufacturer links directly in the BomDoc.

Creating Solutions

ActiveBOM manages the mapping from the design component (part) to the part that is purchased. For each part used in the project, the linkage between:

• the design component,
• and the manufacturer of the part to be fitted to the board,
• and the available suppliers of that part,

is presented as a Solution in the lower region of the ActiveBOM interface.

Your objective is to have a Solution for each unique part used in your design. This Solution information is transferred into the BOM, providing the information needed to purchase the components.

In a Workspace Library component, each Part Choice becomes a Solution - coupling the design component to the manufacturer part, and the available suppliers.

Solutions for Workspace Library Components

For a Workspace Library component, the linkage between the design component and the real-world part is defined as a Part Choice. The advantage of using a Part Choice to couple the design component to the manufacturer part is that it means the design component does not need to have manufacturer or supplier details embedded in its parameters. The Part Choice can be defined independently and updated as needed, and multiple Part Choices can be defined when required.

In ActiveBOM, each Part Choice defined for a component automatically presents as a unique Solution. As well as detecting existing Part Choices, new Part Choices can be added directly in ActiveBOM, and Part Choices can also be ranked in ActiveBOM's Edit Part Choices dialog. For Workspace Library components, these Part Choice updates are stored back in the Workspace.

Part Choices can be ranked and additional Part Choices can be added in ActiveBOM, these Part Choice updates are stored in the Workspace.

Solutions for Non-Workspace Library Components

ActiveBOM also supports creating Solutions for non-Workspace Library components, that is, components placed from a company database or file-based library (for example; *.SchLib, *.IntLib, *.DbLib, *.SVNDbLib).

Since non-Workspace Library components do not support Part Choices, ActiveBOM offers the following mechanisms to connect them to the supply chain:

1. Firstly, ActiveBOM can be configured to detect manufacturer part details embedded in the component parameters and create a Solution using that information. Click the Manufacturer Link  button in the ActiveBOM Properties panel to configure the parameters that are used for this.
2. ActiveBOM also supports Supplier Links, a feature where supplier name and supplier part number details are added to the schematic component. ActiveBOM creates a Solution for the manufacturer part identified from the specified supplier details. The downside to Supplier Links is that the supply chain is limited to the specified supplier, and other suppliers of that part are not included. Be aware of this limitation if you choose to use Supplier Links.
3. The third level of support for a non-Workspace Library component is to add a Solution directly in ActiveBOM. In previous versions of ActiveBOM, Solutions for non-Workspace Library components were added as Supplier Links, limiting the supply chain data to the specified supplier. Now when a Solution is added to a non-Workspace Library component in ActiveBOM, it is added as a Manufacturer Link (manufacturer name and part number). This gives the Solution full supply chain support, the software can use the Altium Parts Provider to access detailed and up-to-date supply chain information for all current suppliers of that part - just like a Part Choice defined for a Workspace Library component.
4. The fourth level of support is for a BOM Item that is not returned by the Altium Parts Provider. This type of item is referred to as a Manual Solution, these require the designer to enter all of the required details, such as the manufacturer, the manufacturer part number, supplier details, and so on.

Manufacturer Links defined in ActiveBOM have full access to the supply chain.

Working with Components in Altium Designer

Components are the foundation of every electronic design. When you're creating a design you can divide the components into two groups - the components you already have, and the components you still need to get. Altium Designer includes a panel for working with each of these component groups.

Both panels include powerful search capabilities. Enter a query in the main Search field to perform a string search, or progressively refine the search criteria using component type Categories and smart Filters – or use both capabilities together.

The Components Panel

The Components panel is used to access your own collection of components, both Workspace and non-Workspace Library. Non-Workspace Library components can be stored in any of the available database and file-based library types (SchLib, IntLib, DbLib, etc.,), and Workspace Library components can be stored in a Workspace.

Your Workspace (1) and non-Workspace (2) Library components are accessed through the Components panel.

► Learn more about working in the Components panel

► Learn more about the various component storage options

The Manufacturer Part Search Panel

There are millions of electronic components available today, through thousands of suppliers, from hundreds and hundreds of manufacturers. Altium appreciates how time-consuming it is for the designer to research the components they need in their designs, checking not only the performance characteristics but also the price and availability, of the many components they need in their design.

To help with this the Manufacturing Part Search panel has been developed - providing a designer's window into the component world. Harnessing the power of the Altium Parts Provider, the panel gives instant access to a vast array of components from a broad range of manufacturers.

Use the Category list and Filters to quickly locate the required component, then check the stock levels and price breaks for the various suppliers.
The icon indicates that there are Altium Designer models available for this component.

► Learn more about working in the Manufacturing Part Search panel

Managing the Solutions

Through a tightly coupled set of services and teams, Altium maintains a vast catalog of components and component supply chain data. This data is delivered as part of the Altium Cloud Services.

As well as supporting non-Workspace Library components that already include supply chain information, such as those placed from an Altium Workspace, ActiveBOM is also able to search for supply chain data for other components.

To summarize, the components you use in your design can access supply chain data in the following ways:

1. Parts placed from the Manufacturer Part Search panel or a company Workspace (Workspace Library parts) - parts placed from the Manufacturer Part Search panel or a company Workspace are already linked to comprehensive supply chain data, via their Parts Choice List. Additional Part Choices can be added in ActiveBOM, click the  button then select Edit PCL in Library from the menu. Click Add in the Edit Part Choices dialog to create a new link and the Add Part Choices dialog will open - refer to the Adding a New Solution section to learn more.
2. Parts placed from local libraries that include manufacturer part information (non-Workspace Library parts) - for parts that already include the manufacturer name and part number, for example, parts placed from a company database library which include this information, ActiveBOM can search for that part through the Altium Parts Provider. To do this, ActiveBOM needs to know which component parameters hold those manufacturer details, these are defined by clicking the Manufacturer Link  button in the ActiveBOM Properties panel. Refer to the Configuring the Manufacturer Link Fields section for more information.
3. Parts placed from local libraries that have no supply chain information (non-Workspace Library parts) - these parts can have supply chain information added:
   1. Directly in ActiveBOM - by adding a Manufacturer Link. Click the  button and select Create/Edit Manufacturer Links from the menu. Click Add in the Edit Manufacturer Links dialog to create a new link and the Add Part Choices dialog will open - refer to the Adding a New Solution section to learn more.
   2. During design capture - using the Supplier Links feature. Supplier Links can be added to an existing schematic component by right-clicking on the component on the schematic and selecting Supplier Links from the context menu, then locating the required part in the Add Supplier Links dialog and selecting the required supplier of that part; or by locating the part in the Manufacturer Part Search panel and right-clicking on the required supplier and selecting the Add Supplier Link command, then clicking on the schematic symbol on the schematic sheet. Note that Supplier Links are locked to that supplier, ActiveBOM cannot source that MPN from other suppliers.
   3. Directly in ActiveBOM - by creating a manual solution. Use this approach to add supply chain information for special items such as glue, fasteners or other mechanical items.

Configuring the Available Suppliers

Supply chain data is delivered through the Altium Parts Provider. The Altium Parts Provider can access details for a vast number of component suppliers, distributed all over the globe. The set of available suppliers is configured at two levels:

• For this software installation - configure the suppliers in the Data Management - Parts Provider page of the Preferences dialog.

• For the current project - click the Favorite Suppliers List  button in the ActiveBOM Properties panel to define the suppliers (including the Custom Parts Provider) you want to be available in this project using the Project Part Providers Preferences dialog.

  

Configuring the Manufacturer Link Fields

If you have non-Workspace Library parts (parts that have not been placed from a Workspace or the Manufacturer Part Search panel), ActiveBOM can search for suitable suppliers automatically if the components include the manufacturer and part number details somewhere in their parameters. For ActiveBOM to be able to query the Altium Parts Provider for suitable supply chain details for these non-Workspace Library parts, it needs to know which of the part's parameters hold the Manufacturer Name and the Manufacturer Part Number. These are configured in the Define Manufacturer Link Fields dialog, click the Manufacturer Link  button to open the dialog. Multiple Name / Part Number parameter pairs can be defined.

Configuring the Number of Solutions and Suppliers

To ensure a smooth passage through the assembly process, many companies require all parts in the BOM to include multiple suppliers, and may also require that alternative parts are detailed. These requirements are configured by the options in the Supply Chain section of the Properties panel.

The Supply Chain options control how many Solutions to include, and how many Suppliers per Solution. Included supplier tiles have a solid color in their banner.

• The number of Solutions per Item option is used to control how many Solutions are to be included for each BOM Item. Each additional Solution is an alternate part. As this value is increased an additional group of columns labeled Secondary Solution n (detailing the manufacturer and the specified number of suppliers), is automatically added to the BOM Items grid. In the image above, the BomDoc is configured to include 2 Solutions for each BOM Item (light blue highlighting).
• The number of Suppliers per Solution option is used to control how many suppliers are detailed in the BOM Items grid for each part. As this value is changed the specified number of supplier columns is updated to suit. In the image above the BomDoc is configured to include 2 suppliers per Solution (green highlighting).
• The colored banner of each Supplier tile is used to indicate if that supplier is included - a solid banner color indicates that the Supplier is included in the BOM Items grid; a checkered banner indicates that Supplier is not included.

Adding a New Solution

Adding and editing Solutions uses essentially the same process for both Workspace and non-Workspace Library components. Regardless of whether you are adding a Manufacturer Link to add a Solution to a non-Workspace Library component, or adding a new Part Choice to add a Solution to a Workspace Library component, search for the part in the Add Part Choices dialog.

To add a new Solution:

• Click the Add Solution button below the BOM Items list in ActiveBOM then select either Create/Edit Manufacturer Link (for a non-Workspace Library component) or Edit PCL in Library (for a Workspace Library component).
• If you are adding a Manufacturer Link to a non-Workspace Library component, the Edit Manufacturer Links dialog will open. To add a new link click the Add button; the Add Part Choices dialog will open.
• If you are adding a new Part Choice to a Workspace Library component, the Edit Part Choices dialog will open. To add a new Part Choice click the Add button; the Add Part Choices dialog will open.

A Manufacturer Link being added to a non-Workspace Library component. If the selected part was a Workspace Library component, the Edit PCL in Library command would be used.

Searching for a Part

Utilizing Altium Designer's advanced component search engine, the Add Part Choices dialog can be used in a straightforward search mode by entering a query in the main Search field, or in its advanced faceted mode by progressively refining the search criteria using the Categories and Filters choices – or by using both capabilities together (referred to as a faceted search).

Use the Search field at the top of the dialog to locate suitable parts based on a search description.

For example: LED green clear 0603 SMD

Or use the Categories and Filters when you want to explore potential parts by toggling criteria on and off.

For example:

1. First select a Category, such as LEDs,
2. Then Filter the LEDs category by the Manufacturer, Mount, Case/Package, and so on.

• Categories are accessed using the dropdown, as shown in the image above.
• Filters are accessed by clicking the button to display the dialog's Filters list. The contents of the Filters list change to suit the category of component being searched. Hover the cursor over the image above remove the Categories list and show the Filters list.
• Click on a column heading to sort the results by that column.
• Some of the Filter fields include text boxes to enter numeric values, press Enter on the keyboard to apply the value.
• If the results list does not update, click in the Search field and press Enter on the keyboard.
• The current search criteria defined by the chosen Category and enabled Filters list are detailed just below the search bar, click the small x icon to remove any of the existing search criteria.
  
• Hover the cursor over the vertical colored bar to display the current manufacturer's Lifecycle status; for example, Volume Production, EOL, etc.
  ► Learn more about Interpreting the Lifecycle State.

Checking Supplier Data

Each manufacturer part that is returned in the search results includes two hyperlinks next to the image of the part.

Clicking:

• The upper link opens detailed component information about that part on the Octopart website.
• The lower link opens detailed information about suppliers that carry that part, ordered by availability and price.

Click the link to reveal detailed SPN information, sorted by availability and price.

The SPN tile in the Add Part Choices dialog includes detailed information about the part and its availability.

SPN Tile Information

The tiles include various icons, hover the cursor over an icon for detailed information.

1. Tile banner, including locking pin, supplier name, tile sequence dropdown, where the banner color indicates:
   • Green = Best choice
   • Orange = Acceptable
   • Red = Risky
     (solid banner indicates a used solution/supplier, configured in the Supply Chain section of the Properties panel)
2. Supplier part number (links to that part on the Octopart website).
3. Country code for the Supplier location (ISO alpha 2).
4. Source of the part information (hover for details). Color indicates:
   • Light Gray = Default, updated less than one week ago
   • Orange = 1 week < last update < month ago
   • Red = last update > 1 month ago
5. Stock quantity; red if available stock < order quantity.
6. Unit price is red if no price is available. Unit price is shown in the currency configured in the Properties panel.
7. Packaging of supplied parts; hover for details.
8. Available price breaks, with Minimum Order Quantities.

Creating a Manual Solution

Your design may require additional items, such as glue or screws, that will not be sourced from your preferred part suppliers. For items such as these, you can Add new » Custom Item and then create a manual solution for that item.

To create a manual solution, click the  button and select the Create Manual Solution command. The Create Manual Solution dialog will open, where you can manually enter the manufacturer and supplier details for the part. 

Additional SPNs can be added to the same solution, by creating another manual solution and entering the same manufacturer and manufacturer part number, as shown in the image below.

Manual solutions are indicated by the Manual solution string in the MPN region, and also by the icon on each SPN tile.

Editing or Deleting a Manual Solution

To edit or delete an existing manual solution, click the dropdown next to the manufacturer part number in the solution tile, and select the required command.

An existing manual solution can be deleted or edited.

When the Delete command is selected the supplier details are removed (the colored SPN tile disappears), but the manufacturer details remain. To remove the solution completely, first, remove the supplier(s). Once all suppliers have been removed a drop-down will appear just below the Manual Solution text in the Manufacturer details region of the solution. Use the Delete command in this menu to delete the solution completely.

Including an Alternative Part

To ensure the design can be built, most designers choose components that can be replaced by an alternative, if required. In ActiveBOM, this is achieved by adding additional Solutions (as just discussed), and then configuring the BomDoc to use multiple solutions using the Solutions per Item feature, as discussed earlier.

There may also be situations where an identical alternative is not available, but a functionally equivalent part can be used instead. For example, if there is a shortage of 6.3V capacitors, a 10V or a 16V capacitor of the same value could be used for this production run, instead.

Right-click to add an Alternative Item. Note the control on the left that is used to hide/display the alternative item. Hover the cursor over the image to display the BOM generation dialog, configured to include Alternative Items.

To select a functionally equivalent alternative part, right-click on the part then select Operations » Add Alternative Item from the context menu. The Add Alternative Item dialog will open, where you can search the connected Workspace for a suitable alternative. Faceted searching is supported, refer to the Searching for a Part section to learn more about performing a faceted search in a dialog that supports it.

Creating Groups of Alternatives

Another situation where it might be necessary to define alternatives is when there are multiple instances of the same part, but you do not want to source all of those parts from the same supplier.

For example, you have a large number of 10K resistors, and a large production run. To ensure supply, you would like to break this down and source the 10K resistors from four different suppliers when the BOM is processed. This can be done by splitting that part into four groups, with each group assigned a different Manufacturer/Supplier using the Rank feature.

Another situation where you might want to split a component into groups is when your design includes a component that requires a specific component from a specific manufacturer, but there are also other components that do not require the same restriction to a specific manufacturer. This can be achieved by creating a group for the special-case component to lock it to its specific manufacturer, then assigning the remaining components to the other group.

To split a component into groups, right-click on the part in the BomDoc then select the Operations » Split Item (Add Alternatives Group) command from the context menu. The Edit Alternative Group dialog will open (provided the BomDoc is in its Base View mode). Name the Alternative Group and enable the checkbox for each component you want in that group. The new group will appear as a separate line Item next to the BOM Item that was split, sharing the same Line #. The Alternative Group Name column will also appear, displaying the user-defined group name.

Line Item 3 has been split into 3 Alternative Groups, and each group has been assigned a different MPN by applying a suitable user ranking to the preferred Solution.

Understanding the Solution Details

Component selection is often a process of juggling availability, unit price, and manufacturing volume. One of the great strengths of ActiveBOM is its ability to bring detailed, up-to-date supply chain information right into the design environment. Having access to this information means the designer can easily monitor their component choices and adapt these as required.

The Manufacturer Details

If a design component includes a recognized manufacturer and manufacturer's part number (referred to as the MPN), ActiveBOM will present this as a Solution in the lower region of the ActiveBOM interface (each row is a solution). For each Solution, ActiveBOM will automatically access the Altium Cloud Services and attempt to locate supply chain information about that part. A key feature of the cloud services is the Altium Parts Provider, which aggregates live parts information from an extensive list of external suppliers, funneling back key information such as supplier, price, stock levels, and minimum order quantities, into ActiveBOM. 

Each of the rows displayed below the BOM Items list is referred to as a Solution, with the manufacturer part detailed on the left, with each of the available suppliers returned by the Altium Parts Provider detailed on a separate color-coded tile.

Each row represents a Solution - a manufacturer part and the available suppliers of that part.

Refer to the Managing the Solutions section to learn more.

MPN Information

1. Manufacturer details:
   • Part image
   • Manufacturer name
   • Manufacturer Part Number (linked to the part on the Manufacturer's website)
   • Description
2. Priority of solution (Primary, Secondary 1, Secondary 2, etc.,)
3. Stock total: sum of the stock available from the favorite suppliers (global availability). Red if stock < order quantity.
4. Minimum unit price. Red if no prices or price = 0
5. Manufacturer Lifecycle: data from Altium cloud services, where:
   • Gray = Default, unknown or no information
   • Green = New or Volume production states
   • Orange = Not Recommended For New Designs
   • Red = Obsolete or EOL
6. Link to datasheet (Octopart)
7. Quantity of available favorite Suppliers
8. User Rank, click to set

Interpreting the Lifecycle State

Use the lifecycle status to help select the most suitable part.

The current lifecycle status is displayed for each solution (as shown in the image above).

The lifecycle status is designed to be used as an indicator, for a number of reasons:

1. Altium maintains a database of many millions of components, produced by thousands of component manufacturers. Since there is no single, consistent method used by those manufacturers to reflect a component's lifecycle state, the status is based on information aggregated from manufacturers, global distributors, and global sales analysis.
2. A part is only reported as EOL or Obsolete when at least one authorized distributor or manufacturer has confirmed this status.
3. Determining the Not Recommended for New Design (NRND) status is more complex. Manufacturers sometimes just report if a part is active or not, and may not give advance warning that a part is to be discontinued or replaced. Therefore this lifecycle status does not always concur with the status provided by the manufacturer. The status algorithm uses various information, including real-time and historical stock availability from all distributors, to try to determine the availability of the part. Parts that have consistently poor availability (when they have been generally available in the past), or cannot be sourced over a period of time after having previously had good availability, will eventually be flagged as NRND (if they are not already EOL or Obsolete).
4. The idea of the lifecycle status indicator is to provide simple-to-understand information that helps you to make more informed decisions about a part, by highlighting those parts which may be problematic. However, due to the sheer volume of data and number of components that form a Workspace Library, there is always a chance that the Altium status lags behind the instantaneous manufacturer status, and is therefore not up-to-date. It is not possible for Altium to guarantee the accuracy of the lifecycle status, it is recommended that if there is any doubt that you double-check with the manufacturer for authorized lifecycle information.

Ranking the Solutions

If multiple manufacturer parts are available - meaning there are multiple solutions - the solutions are automatically ranked from highest to lowest based on the part's availability, price and manufacturer lifecycle state.

If you prefer to use a lower-ranked solution, for example, to use a specific manufacturer, you can override the automatic ranking by defining a User Rank, using the star feature, as shown in the image below.

Click on a star to define a user ranking for a solution.

Import Supply Chain Rankings from another ActiveBOM Document

Ranking defined in another BomDoc (created in any version of Altium Designer) can also be applied in the current BomDoc, run the Tools » Import Ranks command then select the required BomDoc. The parts in the chosen BomDoc will be compared against the parts in the current BomDoc, and supply chain rankings imported for BOM Items whose DesignItemIDs match. When DesignItemIDs match the ranking of existing MPNs in the solutions will be updated, and additional MPNs that are detected in the imported BomDoc will be added as additional solutions. Note that only SPNs that were pinned in the imported BomDoc will automatically appear after importing. Click the Refresh button to force an update of all SPNs.

Versions of Altium Designer prior to 18.0 used a different implementation of ActiveBOM, and a different approach to supply chain rankings. If importing from an ActiveBOM document that was created in Altium Designer 17.1 or earlier, the mapping of rankings - from old world to new - is as follows:

• 1 star from the old ActiveBOM document becomes 3 custom stars in the current ActiveBOM document.
• 2 stars from the old ActiveBOM document become 4 custom stars in the current ActiveBOM document.
• 3 stars from the old ActiveBOM document become 5 custom stars in the current ActiveBOM document.

The Suppliers

To the right of the manufacturer part details are the available suppliers that have been returned by the Altium Parts Provider, with each supplier detailed on a separate tile. These tiles are also referred to as the SPNs (Supplier Part Numbers).

The SPNs are automatically ranked by availability and price. Each SPN tile includes a colored banner, the color reflects the risk associated with choosing that SPN (detailed below). Because the availability and price data can be refreshed at any time from the Altium Parts Provider, the order of the SPN tiles can change.

The SPN tile includes detailed information about the part and its availability.

SPN Tile Information

1. Tile banner, including locking pin, supplier name, tile sequence dropdown, where the banner color indicates:
   • Green = Best
   • Orange = Acceptable
   • Red = Risky
     (solid banner indicates a used solution/supplier, configured in the Supply Chain section of the Properties panel)
2. Supplier part number (linked to the part on the Supplier's website)
3. Country code for the Supplier location (ISO alpha 2).
4. Source of the part information (hover for details). Color indicates:
   • Gray = Default, updated less than one week ago
   • Orange = 1 week < last update < month ago
   • Red = last update > 1 month ago
5. Stock, red if available stock < order quantity
6. Unit price: red if no price available or price = 0 (currency is set in the ActiveBOM Properties panel)
7. Packaging of supplied parts; hover for details.
8. Order quantity, orange if Minimum Order Quantity (MOQ) > order quantity, information on any surplus displayed in the tooltip
9. Order price (Unit Price * Order Quantity), red if 0 (meaning no stock or no unit price)
10. Available price breaks, with Minimum Order Quantities

Ranking the Suppliers

The default state for a new BOM Item is that the Suppliers are ranked automatically. Note that this ranking can change over time, as the price and availability of a particular part change. If required, you can lock an SPN tile to a specific position by clicking the pin icon on the left of the SPN tile banner. The automatic ordering of the SPNs can also be manually overridden, use the drop-down on the right of the tile banner to set the required position. If you use the dropdown to manually set the position of an SPN tile, the locking pin is automatically applied.

To learn how to apply supplier priority to the ranking, refer to the Configuring the Available Suppliers section.