Parent page: Working with Panels
The Components panel provides direct access to available Workspace components, and database and file-based library components in Altium NEXUS.
The panel sources components from a connected Workspace and any open or installed libraries. The panel offers full details of the selected component (Parameters, Models, Part Choices, Supplier data, etc.), component comparison, and for Workspace components, a filter-based parametric search capability for specifying target component parameters.
The Components panel uses the basic search engine functionality and view that is applied in the Manufacturer Part Search panel. While the Manufacturer Part Search panel harnesses the Altium Parts Provider service and focuses on the component manufacturer and supplier data searches, the Components panel is populated with ready-to-place components from your connected Workspace and database and file-based library sources.
Panel Access
To open the Components panel, select View » Panels » Components from the main menus or the Components option from the button menu at the lower right of the main screen. Using a responsive design configuration, the panel layout will dynamically adapt between full-screen normal mode () and its compact mode () where the Categories/Filters options collapse to menus.
From within a schematic document, use the P, P keyboard shortcut to open the Components panel. From within a PCB document, use the P, C keyboard shortcut.
The Components panel in its normal mode. Hover the cursor over the image to see the panel in compact mode.
The panel’s Categories pane (or the drop-down menu in compact mode) lists all available Workspace components under the All category entry and any available libraries. When the panel is in its normal mode, click the Categories list icon or the « icon to collapse or expand the display of the column and use the button (top right) to toggle the visibility of the component Details pane. When sifting through the Categories pane, the Up/Down and PgUp/PgDn keyboard shortcuts may be used to walk through the list. The Left/Right keyboard shortcuts may be used to open and close the individual branches.
The Categories grouping for Workspace components is derived from the ComponentType
parameters associated with each component. To specify or change a component's type on-the-fly, right-click on its entry then select the Operations » Change Component Type option from the context menu to open the Choose component type dialog.
Components that have been Acquired from the Manufacturer Part Search panel to your connected Workspace will be assigned a Component Type as part of the acquisition process.
Generic Components
The panel also provides access to standard, basic Generic Components, which can quickly be placed in a design without the need to find and choose a specific manufacturer part from the available component sources. Generic components are intended as placeholders that are easily replaced by a suitable component later in the design process – serving as virtual or parametric components.
The Generic Components functionality is not supported when connected to a NEXUS Server Workspace.
When Altium NEXUS is connected to a Workspace, the available Generic Components can be accessed from the panel where they are displayed when the All option is selected in the Categories pane. Click on the button within a Generic Component tile to attach the component to the cursor for placement in the active Schematic document. Selecting the Generic Component tile itself opens the list of all available components of that category type in the panel.
Placing a Generic Component from the Components panel
The operations menu options provide you the ability to set file-based libraries preferences, perform searches, and specify if component models collection is visible. To access these options, select the operations menu button at the top right of the panel.
Access to file-based and database libraries is disabled by default in Altium NEXUS. To enable these libraries in the
Components panel and access the
File-based Libraries Preferences and
File-based Library Search options from the operations menu, check the
Legacy.UnManagedLibraries
option in the
Advanced Settings dialog, which is accessed by clicking the
Advanced button in the
System – General page of the
Preferences dialog. If any changes are made in the
Advanced Settings dialog, the software must be restarted in order for the changes to take effect.
Components List
Within the component listing grid itself, the content that is included in the list is managed by:
- Setting the component listing sort order – click a column heading to sort the component listing by that column data. Click the heading again to reverse the sort order.
- Setting the order of the displayed columns – drag and drop a column heading to a new position.
- Specifying which parameter columns are shown – right-click in a column header and choose Select Columns to open the Select Columns dialog then toggle a parameter column’s visibility and move its positional order with the Up/Down buttons.
-
Grouping the list by column data – right-click in a column header, select the Enable Columns Grouping option then drag a column header (e.g., Footprint
) into the grouping space at the top of the list. The list entries will be collected under each unique parameter (e.g., type of footprint) from the specified grouping column.
When using Grouping to collate components in the listing, there is a limit of 10,000 entries that can be accommodated.
- Filtering the listing by a specific column entry – select in a column header to display a list of its unique parameter entries then select an entry to constrain the listed components to those that include the specified parameter (e.g., a footprint type code). Select the All option to reset the filter. Select (Custom) to open the Filter Editor dialog in order to further refine the filtering in the selected column.
Displaying Columns
There are various manners in which you may display the contents within the Components panel. When right-clicking on the names of each column (Name, Description, Footprint) you may select from the following options, depending on how you wish to display the components:
- Best Fit – merges the contents from the Name and Descriptions columns together so they are closely placed, with no excess room between each column.
- Best Fit All Columns – merges the contents from all columns together so they are closely placed, with no excess room between each column.
- Clear Sorting – used to undo the sorting of columns.
- Enable Columns Grouping – allows you to drag column headers by a specific column, allowing you to change the order of the Name, Description, and Footprint columns.
- Select Columns – opens the Select Columns dialog, which allows you to select other columns you would like visible in this section.
- Apply Column Visibility to Child Categories – in cases when the selected category has a child category, use this command to ensure the possibility of pushing column visibility settings from parent categories to child categories. This command is available only when a child category exists.
Component Search and Functions
Searching for components
To search for available components in the Components panel, enter a phrase in the Search field and/or use the panel's Categories and Filters selections to narrow the component listing to your specific needs. Filters are supported for Workspace components only, and as in the Manufacturer Part Search panel, the Components panel supports unit-aware (text to number) search filters. The search functionality prioritizes results according to the entered search criteria.
The Search function allows you to select then edit or add to an active Search string. Click the 'active' search string to enter it into the Search field. You can reuse or edit that search from the Search field.
The Search field also supports searching with wildcards, denoted by an asterisk (*) in the string.
The Find Similar Components dialog provides the possibility to define search preferences based on the selected component.
The Find Similar Components dialog is used to define your search preferences based on the selected component. The final search results will depend on the selected component type, be it Workspace or non-Workspace components, and your Workspace connection status. For example, Workspace components will often display more parameters than a non-Workspace component. To specifically gather components and parameters that are the same or different from the one selected, the drop-downs may be utilized to select Same, Any, or Different choices.
The dialog can be accessed by right-clicking on a listed component, then selecting Find Similar Components.
Placing Components
A selected component is placed on a schematic by dragging and dropping, by selecting Place from its right-click context menu, by using the button in the Details pane, or by using the Enter hotkey.
Filtering Through Components
When viewing Workspace components, the Filters pane is populated by selected filter options based on the current search and available parameters. Parametric filtering of the listed components provides further options for locating a specific component or type of component. Open the Filters pane from the button above the Categories pane.
Note that filters are only supported for Workspace components. Use the Filter Search field within the pane to find a specific parameter filter, and in the panel's narrow/docked mode, click the button to pop out the Filters as a panel extension.
The parametric search capability of the panel's
Filters relies on suitable component parameter data being passed from the Workspace that hosts the Workspace components. As a result, the Filter functionality may be disabled when the software is connected to an older Altium server product. To enable the Filter for previous server versions, check the
ComponentSearch.LegacyAFS.Filters
option in the
Advanced Settings dialog, which is accessed by clicking the
Advanced button in the
System – General page of the
Preferences dialog.
The panel Filters options can be tailored to your needs by selecting particular parameter types as Favorites, which then shift to the top of the list for the current component Category. Hover to the right of a parameter filter’s name and click the icon to set the filter as a Favorite. Favorite filter settings apply to and are saved for individual component Categories.
To reset your favorites to the five default parameters, right-click then choose Reset Favorite Parameters.
For Workspace components, the right-click menu offers options to edit the component through the Single Component Editor (Edit) and perform component management functions such as component creation and cloning, or editing the selected component's Part Choices and Type (Operations).
Additional information options in the component Details pane include: viewing a model image, viewing online datasheets (References), live Supplier information (Part Choices), seeing where the part has been used in Workspace projects and Managed Sheets (Where Used), and through the right-click menu, the ability to copy selected or all component parameter data (technical details) in a tab-delimited format, and resetting favorites.
When browsing the components in a connected Altium 365 Workspace and if any issues regarding the health of the selected component are found, an indication of it will be presented by the (for errors) or (for fatal errors) icon in the Component issues line above the component parameter list. The number at the right of the icon indicates the number of found issues. Click the down arrow at the right of the number to see the short descriptions of the issues.
An example of library health issues found.
Your Workspace library health can be explored in more detail through the Library Health dashboard page accessible from the Altium 365 Workspace browser interface. See
Library Health Dashboard to learn more.
You may use the custom filtering feature to further refine filtering in the Components panel. The feature is available by clicking the filter () icon in the header, then selecting (Custom)
. This will open the Filter Editor dialog, which allows you to define the condition, operator, value, operator type, etc., for which you want to filter results.
Where Used
The Where Used drop-down tracks where a particular component is located. You may select the Project, Managed Sheets, or All buttons to view the particular project, managed sheet, or both, in which the given component has been used. Information regarding the date and time of placement is available, as well as information regarding the soft delete feature, in the case that the component has been deleted.
Operating as a 'soft delete', the removal process provides increased options and information as you proceed, including relevant links to source items for review purposes. Items can be deleted by users who have editing rights to those items and can be restored from within the Workspace's browser interface. In the Workspace, deleted items are moved to a dedicated Trash location where they can be retrieved (Restore) by users who have editing rights to the deleted items, or completely removed (Permanently Delete) by Workspace administrators or the owner of those items.
Component Data Caching
When using the Components panel, the data for Workspace components are cached to the local machine from the Workspace. This provides an offline access mode for Workspace components when Altium NEXUS is not connected to the Workspace, and therefore allows normal component browsing and placement, etc. Note that Filters are not enabled in this mode.
This condition is indicated by the 'Offline mode – cached data is being used' warning text in the lower bar of the panel’s component list pane. The cache builds up component data over time and may be cleared (for all Workspaces) using the Clear Cache option that is available under Known Servers in the Data Management – Servers page of the Preferences dialog.
Caching behavior will only present cached components from the currently connected Workspace(s), such as
Altium 365 Workspace, meaning certain cached data may be disabled. This behavior may be managed from the
Data Management – Servers page of the
Preferences dialog.
Part Choices List
Edit the Part Choices List associated with a Workspace component by selecting the Operations » Create/Edit PCL option from the entry’s right-click menu.
Use the following Edit Part Choices dialog’s button to open the Add Part Choices dialog, which will automatically search for part manufacturers by the selected component's Name
parameter. Deselect the predefined search term to manually search for alternatives – functionally, the dialog is a modal version of the Manufacturer Part Search panel.
Part Choice entries in the list can be ranked by selecting an appropriate star icon level, where the list will automatically be reordered with the highest-ranked manufacturer choice at the top.
A Part Choices List is carried with the component wherever its data is applied, such as in a Schematic design, BOM document, Output Report, and so on.
The right-click pop-up menu for the panel provides the following commands:
- Place [ComponentName/FootprintName/SimulationModelName] – use to place the currently selected component or simulation model onto the active schematic document or currently selected footprint onto the active PCB document.
- Find Similar Components – use to open the Find Similar Components dialog to set up search criteria to find components similar to the selected component.
- Edit – click to edit the selected Workspace component through the Single Component Editor or selected domain model (symbol, footprint, or simulation model) in its editor. For a component, if the current component type is different from the template that is currently being used, the Change component type dialog will open. Use the dialog to change the component type of the selected component.
- Navigate to [ComponentName] – use to open the chosen Workspace component in the Explorer panel, where you may access detailed Item information and manage the revision and lifecycle settings for the Items well as where-used and supply chain detail, amongst other options.
- Operations – use to access a drop-down menu of additional functions for Workspace components as described below.
-
Submit Request – use to access the active part request process definitions. If no active process definitions are available for the Part Requests process theme, the Submit Request button will be grayed out (not available). You may need to sign out of the Workspace and back in again or restart Altium NEXUS to refresh.
- Create – click to open the Create new component dialog to select the type of component when adding a new component.
- Download – click to download the selected component(s) to a zipped Integrated Library Package.
- Clone – click to clone (copy) the selected component. The component editor opens in the Single Component Editor mode.
- Delete – click to delete the selected component(s) from your connected Workspace.
- Change Component Type – use to open the Choose component type dialog, where you may alter the component's type, add a subtype, or merge component types, amongst other options.
- Change State – use to change the revision state of the selected component(s). After using the command, the Batch state change dialog opens, which allows you to change the revision state of the component(s).
- Create/Edit PCL – use to access the Edit Part Choices dialog, where you may create or edit the part choices list associated with the Workspace component.
- Full Item History – use to access a detailed view for the currently selected component, opened as a new tabbed view within Altium NEXUS. The Item View provides a highly detailed view of the Revision and Lifecycle history of a specific Item, as well as showing all of the elements that make up that Item. The view also includes a Timeline. Use the Timeline to examine the exact time and date of any change made to the Revision level or Lifecycle State of that Item and who made the change.
- Refresh – click to quickly refresh the panel. The current component selection will be saved.
Compare Feature
The Compare feature allows you to compare the parameters of two selected parts. This feature is accessed by selecting two components (parts) in the grid region with the icon enabled (blue). The Selected Component Details region opens to the right of the grid region. The upper region (region 1 in the image below) displays an image, the name, description, and price of the selected parts side-by-side. Click the Datasheet button to open the manufacturer's datasheet (if available) for the associated component. Click the Place button to place the component in the design space. The component will appear floating in the design space; click to place the component in the desired location. You can continue to place additional components or right-click or Esc to leave placement mode and return to the Components panel.
The lower region (region 2 in the image below) displays a side-by-side view of the components' parameters, with differences highlighted in red text for easy comparison.
The Compare feature is also available when the Components panel is in compact mode, though works a tad differently. This feature is accessed by selecting two components (parts) in the grid region. The Selected Component Details region opens below the grid region. The upper region displays the name, price, and view of the components' parameters, with differences highlighted in red text for easy comparison. The lower region displays a side-by-side view of the components' Symbols and Models.
The symbol and footprint of a given component can be hidden within the Models section of the Details pane, which is accessed by clicking on the upper right. Once hidden, the symbol and footprint will be replaced with clickable links that revert the hidden items to their original view. Also included is the ability to scale the size of the displayed models. For both the symbols and footprints, click and drag the lower perimeter of the model area to resize the image.
For a Schematic Library (*.SchLib
) file being browsed in the Components panel, the symbol and footprint of the selected component can be edited using the button at the bottom-right of the model preview.
The ability to edit a footprint is made available when accessing the Components, as long as valid and linked footprints are already present.
Component Selection Dialogs
The search engine and view used in the Components panel is also applied in other Altium NEXUS applications where a component choice is made. The component search functionality is included in these (modal) dialogs, along with an OK confirmation button and minor variations in the available action commands. The dialog is typically called Component Search.