Linking to Supply Chain Data for Database and File-based Component Libraries

Altium Designer facilitates the linking of your design components to real-world parts, enabling you to have access to live supplier data as you design. Through a direct connection to Altium's component data web services, you are able to search for manufacturer parts and select from the supported suppliers that offer those parts. This 'live' supplier data can then be integrated within the design process – at the library design level, during the design, and at design release time. In short, this feature allows supplier databases to be accessed from within Altium Designer by searching for and selecting manufacturer design components.

For any given manufacturer part and linked Supplier data found through a search, its parameters, datasheet links, pricing, and stock information can also be imported as parameters of a target library component (SchLib, DbLib, SVNDbLib), or placed component on a schematic sheet. In addition, the data for new components can be created in a target library directly from a selected manufacturer component.

The linked part and supplier data will also be included or can be added at design release time in a Bill of Materials – especially useful from a project costing and procurement perspective.

Supplier Preferences

The Data Management – Parts Providers page of the Preferences dialog is command-central for configuring which Suppliers will be available when searching for parts data, along with other options relating to linking to Supplier data.

Configure options relating to the feature to link to Supplier data, as part of your Altium Designer preferences.

Use the Altium Parts Options section of the page to configure the service to suit your needs.

Options include the following:

• Location – enable which geographical regions the parts service will collate parts data from. While many suppliers are multi-regional, if a part is uniquely available in a specific location, it will only be listed if that region is enabled. Drag and drop location entries in the list to set their ordered priority of use.
• Currency – enable which international currencies will be available for selection when searching for parts and examining results. Drag and drop currency icons in the list to set their ordered priority of use.
• Supplier – enable which Suppliers to include when performing a supplier data search. Only part results from those Suppliers will be returned. By including more Suppliers for use with the feature, you are able to compare and shop for the best deals on the components required by your design. A Supplier associated with a symbol in the Verified column indicates that the Altium Parts Provider receives data directly from that supplier.

Note that if you are signed in to a server, the Altium Parts Options region becomes read-only and adopts those settings defined by the server. This is indicated by the presence of the icon next to the page name in the navigation tree.

Searching for Component Supplier Data

The primary interface to available manufacturer parts and their associated live supplier data is the Manufacturer Part Search panel. Featuring sophisticated part search and location features based on categories and parametric filtering, the panel also functions as a direct portal to real-world parts offered by the various Suppliers you have enabled for the feature. Access this panel by selecting select View » Panels » Manufacturer Part Search from the main menu, or the Manufacturer Part Search option from the button menu at the lower right of the main screen.

Search for real-world Supplier items through the Manufacturer Part Search panel.

As illustrated, the panel is essentially divided into three functional sections:

• Component Search, Type and Filtering:
  • In the upper Search field, enter one or more keywords that relate to the component part. The returned results include Supplier Links for each listed manufacturer part.
  • Use the Categories drop-down list () to constrain the results to the selected type of component.
  • Check relevant parameter options in the Filters pane on the left (enabled with the icon) to filter the results to components that comply with those parameter values.

• Search Results:
  • This central region of the panel populates with all manufacturer parts that match the current search, category and filter criteria. The Supply Info column provides a summary of the supply data for each entry, based on its unit Price, minimum order quantity (MOQ) and available supply Stock for the most suitable vendor. The color strip associated with each manufacturer part provides a quick estimate of its Lifecycle status – for example, green indicates that the part is suitable for volume production, whereas a red strip flags a part considered as obsolete.
  • A selected part entry includes supplier data link in the Manufacturer Part column (for example, 9 SPNs) that opens a horizontal list of supplier choice Tiles for that manufacturer part. Each Tile in that list applies to a particular vendor and provides a snapshot of the current (live) stock level, pricing and supplier part number. See Linking to a Supplier Item below for information on how these are applied to design components.
  • The panel's Option settings, available from the  button at the top-right of the panel, configure how the search results data are displayed:

    • Currency menu – The currency used in the panel's pricing information is determined by the currency priority setting in the Data Management – Parts Providers page. To quickly change the panel's current setting, select a different currency from this drop-down menu.

    • Exclude Invalid SPNs option – Enable this option to remove the supplier data link in the Manufacturer Part column for entries where the supplier data for that part is unsuitable for use (invalid) – such as when Pricing or Stock information is not available.

    • Part Providers Preferences link – Provides direct access to the Data Management – Parts Providers Preferences page. Only those Suppliers that are enabled on the preferences page will be included in the list of suppliers/vendors for a manufacturer part.

• Component Details:
  • The panel's Details pane (opened with the button at the top right) shows all available data for the selected component, including its parameters, models, datasheets, and links to web-based supplier information.
  • The pane also includes download options to view/save the manufacturer part specifications (), or to locally save the component itself () by:
    • Saving the component to the currently connected Altium Workspace, or
    • Downloading the component as a zipped File Library, or 
    • Placing the component on the active schematic sheet.

► See the Manufacturer Part Search page for detailed information on its features and application.

Linking to a Supplier Item

At the heart of the Altium Designer feature to link to Supplier data, is the Supplier Link. This fundamental entity provides the live link between an Altium Designer component and an item sold by an enabled Supplier.

Creation of a Supplier Link involves the automatic addition of two parameters to the target Altium Designer component involved:

• Supplier n
• Supplier Part Number n

...where n is an integer suffix, used to distinguish between Supplier Items when multiple links are added to the same component.

Creating a link between a design component and supplier data – a Supplier Link – can be achieved by dragging and dropping a supplier entry from the Manufacturer Part Search panel on to a target component, or by using an available Add Supplier Link command. The potential linking options will depend on the type of component, as outlined in the below sections.

Schematic Library Component (SchLib)

With the source Schematic Library document open as the active document, there are three areas on which to 'drop' the Supplier Item from the Manufacturer Part Search panel to create the link:

• Anywhere within the main editing area of the Schematic Library Editor (ensuring the recipient component is focused).
• Onto the required component's name, in the Components region of the SCH Library panel.

As alternatives to the drag and drop method, the link also can be added by choosing the Add Supplier Link To <part> option from a Supplier Tile's right-click context menu in the Manufacturer Part Search panel, where <part> applies to the currently selected component in the SCH Library panel.

Database/SVN Database Library Component (DbLib, SVNDbLib)

With the DbLib/SVNDbLib document open as the active document, a Supplier Link can be added to a database component by:

• Dropping a Supplier Item from the Manufacturer Part Search panel on to the required component record on the Table Browser tab.
• Selecting a target component entry in the table and then choosing the Add Supplier Link To <part> option from a Supplier Tile's right-click context menu in the Manufacturer Part Search panel.
• Selecting a component entry in the Table Browser, then choosing the Edit Supplier Links option from its right-click context menu, then adding a new entry () in the Supplier Links for <component> dialog. In the same way as a Schematic library, this accesses the Add Supplier Links dialog, where Supplier information can be searched for and selected for addition.

In all cases, the required Supplier n and Supplier Part Number n parameters are added to the database table.

Demonstrating the addition of a Supplier Link to a component record in a database linked by a DbLib file.

Placed component on a Schematic Sheet

With the source schematic document open as the active document, a Supplier Link can be added to a placed component by:

• Dropping a Supplier Item from the Manufacturer Part Search panel on to the schematic symbol of a placed component.
• Right-clicking on a component, choosing the Supplier Links option from the context menu, then adding a new entry () in the Supplier Links for <component> dialog. This opens the Add Supplier Links dialog – which automatically adopts the selected component's Comment parameter as a search term – where a Supplier data Tile is then selected for addition. See Search Keywords below for more information on automated searches.

Options and Controls of the Add Supplier Links Dialog

• Search - enter the desired search terms in the text box and press Enter. The Manufacturer Part results will be listed in the main region of the dialog. 
• Main Results Listing - this shows the resulting Manufacturer Parts returned based on the search criteria entered. For each manufacturer part, the Description, Category, and Supply Info are listed by default. Additional parametric information can be displayed by right-clicking on a column header and choosing the Select Columns command from the context menu. This provides access to the Select Columns dialog. 
• For each manufacturer part, the suppliers that vend that part can be accessed by clicking on the SPNs (Supplier Part Numbers) drop-down. Each SPN Tile includes a colored banner, which indicates the risk associated with choosing that SPN. The order of the SPN Tiles can change based on the availability and the price data from the Altium Parts Provider. An SPN Tile contains the following information:

1. Tile banner, including supplier name, where the banner color indicates:
   • Green = Best
   • Orange = Acceptable
   • Red = Risky
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 by clicking the  button in the dialog)
7. Packaging of supplied parts; hover for details.
8. Available price breaks, with Minimum Order Quantities

For the dialog's OK button to become available, you must select an SPN for the desired Manufacturer Part.

Component entries listed with an associated green  icon have symbols and footprints and are therefore ready to be placed in a design. To restrict the listing to those components that have associated model data, select the Yes option for the Has Model parameter in the Filters pane (accessed by clicking the  button at the top left of the dialog).

• Choosing the Add Supplier Link To Part option from a Supplier Tile's right-click context menu in the Manufacturer Part Search panel, and then using the target crosshairs in the schematic editor to select a placed component (or a sequence of components).

In all cases the required Supplier n and Supplier Part Number n parameters are added to the component.

Demonstrating the addition of a Supplier Link to a placed component on a schematic sheet.

Tailoring the Search Process – Suggested Keywords

Where the Add Supplier Links dialog is used for locating and selecting suitable component supplier data, the software automatically performs a manufacturer part search based on parameter data extracted from the target component. This is shown in the examples above, where the component's Comment value is automatically applied as a search keyword expression.

The search entry used by the software is defined in the Suggested Keywords region on the Data Management – Parts Providers page of the Preferences dialog, which allows the applied search expression to be configured to suit your component library structure. You have full control over which parameters of parts are used as search keywords, and in what order.

Default suggested keywords that are used when automatically searching for parts in Supplier databases.

In the dialog's Suggested Keywords region, default priority assignments (with the highest priority at the top of the list) mean that, by default, the Comment value will be used as the search criteria first. If the source component has no comment, then the next attempt uses its Description value. If this is also blank, the component's Name will be used.

You can include your own keyword parameters as required by clicking the Add button. This will add a new parameter entry (with default name Parameter Name) to the bottom of the list (and therefore assigning it the lowest priority), with the new parameter automatically focused and ready for a name change. To modify the name of an existing parameter, click once on its name field to focus it, then enter the new name as required. Alternatively, select a parameter by clicking on its associated priority field, then click the Edit button.

Use the Move Up or Move Down buttons to shift the currently selected parameter up or down in the list respectively – increasing, or decreasing its assigned Priority accordingly.

An example user-defined suggested keyword parameter, added and given the top priority.

Importing Data from a Supplier Item

For any given Manufacturer Part and Supplier Item found through a search in the Manufacturer Part Search panel, its parameters, datasheet links, pricing, and stock information, can be imported as parameters to a target library component (SchLib, DbLib, SVNDbLib), or a placed component on a schematic sheet. The information is imported through the Add Supplier Link and Parameters to Part option (or ..to <part> when a library component is the target) available from Manufacturer Part and Supplier items in the panel, or on a piecemeal basis, from the Parameters listing in the panel's Details pane.

Parameter Import Options

Prior to importing any component parameters, pricing, or stock information from Supplier Items, you have the opportunity to define name mappings. This is particularly useful where, for example, certain parameters have already been defined for library components, and those existing parameters have different names to those used by a Supplier in their published data for an item. Rather than importing data into a new/separate parameter, the data can be imported into the existing parameter – provided the name mapping has been set up to do so. Mapping a supplier Resistance parameter to a target Value parameter is one example.

Parameter name mappings are defined as part of the Parameter Import Options, on the Data Management – Parts Providers page of the Preferences dialog.

Define options for imported parameters on the Data Management – Parts Providers page of your Altium Designer preferences.

When importing a parameter, the software will look to these options to see if that parameter has a defined mapping, as specified by the Imported Parameter Name field. If this field is blank, or the parameter is not listed, it will be imported using the parameter name used by the Supplier. If this field has a value, then data will be imported into a new or existing parameter with that name. In the case of the latter, the data will overwrite any existing data – the parameter's value will be updated. No existing parameter will be removed/deleted.

The Supplier Link options apply when creating a new library component from a Supplier Item, or when adding a Supplier Link and parameters simultaneously. For each listed parameter, the designer can choose to exclude it from import and also define whether a number suffix is to be used, which is useful if importing parameters from multiple Supplier Items to the same Altium Designer component. The suffix identifies a parameter as belonging to a particular Supplier Link – say, the imported parameter Stock 1 would have been sourced from Supplier 1. Use the Visible option to specify whether or not the imported parameter is displayed in the design workspace.

Importing All Part and Supplier Data

The easiest and most comprehensive way to import data from a manufacturer part and supplier source to a local component is through the Manufacturer Part Search panel's Add Supplier Link and Parameters To feature.

The command is applied in the same manner as the Add Supplier Link To command outlined above, but will add all available parameters, datasheet links, pricing, and stock information from a Manufacturer Part and Supplier Item, along with a Supplier Link to that item, all in the one step.

The example images below demonstrate the function for a Schematic Library component, where the command will add component and supplier data to the entry selected in the SCH Library panel. In this case, the library component has no initial parameter entries, as shown in the Properties panel.

To import all data to the selected component, locate a suitable component entry in the Manufacturer Part Search panel and select the Add Supplier Link And Parameters To <part> option from a Supplier Tile's right-click menu. As shown in the Properties panel, the target component is then populated with all Manufacturer Part and Supplier parameters, including the current Pricing and Stock information. Available datasheets are imported also, as found in the Properties panel Links region under the General tab.

Adding Supplier Link and parameter data to a database component or a placed component involves the same essential process – selecting the target component and invoking the Add Supplier Link And Parameters To command in the Manufacturer Part Search panel.

• For a database component, the target component entry is selected in the Table Browser of an opened DbLib or SVNDbLib.
• For a placed component, where the command is Add Supplier Link And Parameters To Part, use the resulting target crosshairs to select a component (or a sequence of components) in an open Schematic document.

Importing Specific Parameters

Specified manufacturer/supplier Parameters can be imported from the Manufacturer Part Search panel to a library or placed component using the Add Parameter(s) To command, which is available from the panel's Details pane – opened from the button.

To do so, select a Manufacturer part or one of its Supplier sub-entries in the panel's search results list, and then the desired Parameter entries in the panel's Details pane. Right-click on a selected (highlighted) Parameter entry, and choose the Add Parameter(s) To command option to propagate the parameters to the target component.

• For a library component, the target is the entry selected in the SCH Library panel or (for a database library) the DBLib Table Browser.
• For placed component, the target is selected in the Schematic Editor using cursor crosshairs.

Notable points regarding the propagation of parameter-value pairs are:

• If the parameter already exists in the target component, its value will be updated – see Voltage Rating in the above example images.
• If the parameter does not already exist, the imported parameter-value pair will be added to the target component – Tolerance and Material in the above image.
• The process will comply with the settings in the Parameter Import Options region of the Data Management – Parts Providers page of the Preferences dialog. For example, if Capacitance is mapped to Value, then the latter parameter will be added as a capacitance value to the target component – Value 1nF.
• Supplier parameters, such as Stock and Pricing, are available in the Details pane of the Manufacturer Part Search panel only when a Supplier Tile (rather than the Manufacturer part) is selected as the source.

• In the same way as other parameters, added Supplier data will update existing Supplier parameters in the target component. The supplier data suffix remains at 1 and subsequent additions do not increment the suffix value, unlike when using the Add Supplier Link And Parameters To options from the component/supplier source entry, where data from multiple suppliers can be added (as outlined in the above sections).

Creating a New Library Item from a Part-Supplier Item

Along with the features covered above for adding supplier and parameter data to existing library items, you can also create a new library item by importing data from the Manufacturer Part Search panel to a target library. The process adds all available data to the new component, which adopts the source Manufacturer Part Number (MPN) as the value for its component Name. The new component will require the addition of component Symbol and Footprint models to become a fully usable library component.

To perform the import, open the target Schematic or database library, select the desired Manufacturer part or one of its Supplier entries in the Manufacturer Part Search panel then the Import Into command from its right-click context menu:

• For a Schematic Library target, the newly added component entry will be listed in the SCH Library panel.
• For a Database Library target (DbLib, SVNDbLib), the newly added component entry will be listed in the library's Table Browser.

Being able to create a new component directly from a Part or Supplier Item enables you to quickly build design libraries that are tightly linked to real-world components, from the outset.

Viewing and Editing Supplier Links

The Supplier Links currently defined for a library component, or placed component on a schematic sheet, can be viewed and edited using the Supplier Links for dialog. To access this dialog:

• For a schematic library component – right-click anywhere within the design space and choose the Supplier Links command from the context menu.
• For a Database library / SVN Database Library component – right-click on a component entry under the Table Browser tab of the relevant DbLib/SVNDbLib file and choose the Edit Supplier Links command from the context menu.
• For a placed component on a schematic sheet – right-click on the component and choose the Supplier Links command from the context menu.

After launching the command, the Supplier Links for dialog will open. The dialog lists all of the currently defined links for the component. 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. The Manufacturer Part is shown on the left with the selected available supplier detailed on the right.

The Supplier Links for dialog

All currently defined Supplier Links for a schematic library component also can be viewed and edited directly from the selected component's Properties panel. The defined Supplier Links for the selected component are shown in the panel's Part Choices region. Detailed data for the selected Supplier Link is available via the clickable link in the Supplier Tile (as shown below), or by searching by that Supplier Part Number 1 parameter value of that component, in the Manufacturer Part Search panel.

To add an additional Supplier Link, click the button at the bottom of the Part Choices region. The Supplier Links for dialog will open, click the  button to open the  Add Supplier Links dialog, which can be used to search for and add additional links to the required item. Use the button in the Add Supplier Links dialog to remove the selected Supplier Link from the library component.

Quantity and Pricing

Suppliers will typically have different pricing based on the quantity of an item to be purchased from them. The quantity levels required to access increasingly reduced unit price points differ not only between different suppliers but also from item to item for the same supplier. When selecting Manufacturer part Supplier data in the Manufacturer Part Search panel, a summary of this information is available in a part Supplier Tile by selecting the Show more link. This allows you to make an informed pricing (and stock) decision when choosing a Supplier Link, based on the current data.

Supplier prices and stock levels vary. Bear in mind that there is a delay in updating the information from Suppliers into the database of the aggregator service delivered by the Altium Parts Provider. Hover the mouse over the symbol in a Supplier Tile to see when the information was last updated.

Supplier links added to a library component also offer detailed pricing-quantity information in the Part Choices region of the Properties panel, for the currently selected library component. 

Example of displayed Unit Price based on the specified Order Quantity when ordering 100 units reduces the price from 0.1USD to 0.018USD per capacitor.

Currency Conversion

Different Suppliers operate in different, often multiple, regions of the world and as such, it is common to see product pricing reported in different currencies. Altium Designer provides the capability to convert the display of such pricing information into one of a number of supported currencies.

To quickly display all pricing information in a single currency in the Manufacturer Part Search panel, select the required currency from the Currency drop-down menu available from the panel's button. To have pricing displayed in the default currency used by a Supplier, choose the menu's None entry.

To set the currency usage preferences in Altium Designer, enable/disable currencies and set their priority on the Data Management – Parts Providers page of the Preferences dialog.

► See Supplier Preferences above for more information.

Including Supplier Data in a Bill of Materials

Supplier data links added to components in a design, or the links inherent in a component placed from a library, are saved with the design and available for inclusion in a Bill of Materials (BOM).

BOM Report

At the simplest level, component supplier links are available in a BOM Report generated from the project source. Select Reports » Bill of Materials to open the Bill of Materials for Project dialog, which can be configured for your needs and generated in a variety of formats (Excel, PDF, HTML, etc.). The BOM Report is also available for inclusion as a Report Output in a project Output Job.

► See BOM Configuration in the Report Manager for detailed information.

A simple BOM Report will show supplier data parameters for components that include Supplier Links.

ActiveBOM Document

The far more advanced, and recommended, approach to managing manufacturer and supplier links in a project Bill of Materials is to include an ActiveBOM document in your project – File » New » ActiveBOM Document. Note that the full benefits of this approach are realized when using Workspace Library Components.

► See BOM Management with ActiveBOM for detailed information.

ActiveBOM uses component data Solutions to add a comprehensive set of live parts information, such as manufacturer part details (including Lifecycle status), supplier pricing and stock level.

The next step up from BOM Solutions derived from existing Supplier Links added to the components in the library or on the schematic, is to add new component Solutions within the ActiveBOM interface.

If your design does not use Workspace components, use the Create/Edit Manufacturer Links option from the button menu to add an ActiveBOM Solution to the currently selected component entry. Select the button in the following Edit Manufacturer Links dialog, and then a suitable manufacturer component entry in the Add Part Choices dialog. When confirmed (OK), this part link is added as a new entry in the Edit Manufacturer Links dialog.

After confirming the addition in the dialog () the ActiveBOM Solution is added to the BOM component entry. Note that the Solution, in this case, includes the full list of Supplier options, where the selected option (colored green) is designated as the 'Best' Supplier Solution for the manufacturer part.

Use the associated Properties panel to configure the ActiveBOM features, such as the applied Currency, Manufacturer link data source, visible data columns, BOM Item groupings, BOM check warnings, etc.

► See BOM Management with ActiveBOM for more information.