Advanced Components Search

Old Content - see latest equivalent

Altium Vault 2.6 brings powerful new component searching with its Advanced Search capability. Delivered through a dedicated view within the Vaults panel, you can either perform generic-level searching or (and this is the really cool part) targeted searching through the use of saved search configurations. These allow you to search by a particular component type and also use ranged searching - a nice aspect of searching facilitated through unit-aware component parameter data types. Additionally, you can add a keyboard shortcut to your saved searches that allows you to quickly perform a search from wherever you are within the Vaults panel.

Prerequisites for Advanced Search

To use the Advanced Searching functionality, you need to meet the following requirements:

  • Be running Altium Designer 16.0 and ensure the CMPT Editor and Vault Explorer extensions are installed as part of that installation.
  • Upgrade to version 2.6 of the Altium Vault.
  • Re-release components to your vault from component libraries that use assigned component templates with defined unit-aware component parameter data types. This can be achieved by:
    1. Opening the component library (CmpLib)
    2. Creating and releasing a component template (CMPT) with:
      • Default schematic symbol and primary PCB Component model (as already used in the CmpLib).
      • The Default Value for the ComponentType system parameter set accordingly (e.g., Resistor, if the CmpLib is for a set of generic resistors). A variety of explicit component types are supported.
      • Component parameters defined that match all component parameters currently defined in the CmpLib (in this way, the existing values will be kept, while not duplicating any parameters).
      • For relevant parameters (e.g., Value, Tolerance, Power, etc.), set the data type accordingly - thus making those parameters unit-aware. A number of unit-aware component parameter data types are supported.
    3. Assigning this component template to the CmpLib (from the Document Options - Template tab, or from the Add » Templates sub-menu associated to the Required Models/Parameters region.
    4. Tweaking the values of any parameters that are shown in red (i.e., value not valid).
    5. Re-release the component definitions in the component library.

Accessing the Search Facility

The interface for the search facility - the Search view - is accessed through the Vaults panel by clicking the Search tab at the bottom-left of the panel.

Alternatively, the Search view is accessed when performing a generic search - using the Search field at the top-right of the panel, or if a keyboard shortcut assigned to a saved search is invoked. The view can also be accessed from the Folders view, by clicking the Search Results entry, at the bottom of the tree.

The Search view - a dedicated user interface within the Vaults panel.

Generic Search

This is the standard-type searching that was available previously. It simply provides a single search field for entry of search strings. Enter a search string and either press Enter, or click the  button to the right. 

The same generic searching can also be performed from the search field at the top right of the panel.

Accessing the single search field for a Generic search.

Creating a Saved Search

To create a new saved search, simply right-click in the Saved Searches region and choose New from the context menu. The New/Edit Saved Search dialog will appear, in which to define the search.

Creating a new saved search.

The dialog contains the following fields:

  • Saved Search Name - use this field to give the search a meaningful name (e.g. Resistor).
  • Shortcut - use this field to define an optional keyboard shortcut for quick access to the search. To populate the field, simply click in the field and perform the shortcut on the keyboard.
  • Component Types - use the drop-down to choose the specific component types to be targeted in the search. All supported types are listed and any number of types can be enabled.
  • Parameters - this region lists parameters that are available in the search. Initially, all detected parameters across all component types are listed. Once the Component Types field has been defined, only those parameters detected for the enabled component type(s) will be listed. For each parameter, the following are available:
    • Show filter - enable to show a corresponding filter field for the parameter, above the Search Results region of the Search view. It is through such a field that you can fine-tune your searches, based on value criteria stipulated for that parameter.
    • Default Visibility - enable to have a column for the parameter presented by default in the Search Results region of the Search view. Columns for parametric data can be hidden, or made visible at any stage, directly from the view.
    • Parameter - the name of the parameter. This could be a system parameter or a user parameter. Remember that in order to use range searches, parameters must be defined through an assigned component template and be unit-aware (of a specific data type).
    • Type - the data type for the parameter. For ranged searches, the parameter should be set to a unit-aware data type. This can only be done through a component template, which is then assigned to the component library prior to releasing the component definitions.
    • Default Value - use this field to constrain use of a parameter to a particular value, or range (if the parameter is a unit-aware data type). 
  • Public - enable this option to allow any user of the vault to see and use your saved search. If you want the search private to only you, leave this option disabled.
When defining a value, range is depicted using the hyphen character, for example 10kOhm-40kOhm. You can also use greater than (>) and less than (<). Greater than and less than are inclusive.

Example defined search

With the search defined as required, click Save. The search will be saved as an entry under Generic Search in the Saved Searches region of the view.

A set of saved searches can quickly be generated by right-clicking in the Saved Searches region and choosing the Generate From Component Types command from the context menu. The set covers all supported component types.

Applying a Saved Search

A saved search can be applied in the following ways:

  • Select the search in the Saved Searches region, then click the  button.
  • Use the assigned shortcut to switch to the required saved search, then click the  button.
  • Double-click on the entry for the saved search

If any parameters have their option to Show Filter enabled, as part of the applied saved search, dedicated fields for those parameters will be presented.

An example of a focused saved search - Resistor. The search has three parameters that have their Show Filter option enabled, so fields for those parameters are presented
as part of the search interface.

For those parameters whose filter fields are shown:

  • If the parameter has a default value specified as part of the search, its field will initially be prefilled with that value.
  • All possible values that could be chosen for that parameter will be available from the field's drop-down list.
  • A new value (specific, ranged, >, <) can be specified for the parameter by direct entry in the field.

Once any adjustments have been made, if needed, application of the search is performed by clicking the  button, at the top-right of the results area. Filtering of components will be performed based on the defined search criteria, and the results presented in the Search Results region.

Example results after application of a defined saved search.

Use the controls available in the Search Results region to further sort, filter, and group results as required.
You are reporting an issue with the following selected text and/or image within the active document: