R12.1-JA-2025June05

Search Devices by Formula

Search Devices by Formula allows you to build complex search queries to search for devices by using multiple search criteria and a Boolean expression.

Using Search Devices by Formula

  1. Click the search bar and then select Search Devices by Formula from the drop-down list.

  2. Specify the scope to search for devices.
  3. Set search criteria A based on your needs:
    1. Select a data source and a property from the first drop-down menu.
    2. Select an operator from the second drop-down menu.
    3. Specify the value of the property that you selected.
    4. Repeat to set more conditions if required.
  4. Define the condition combination in the Boolean Expression field. For example, A and B.

In the Search Devices by Formula window, four match operators are available:

  • Contains: The entered value is part of the contents in the first drop-down menu.
  • Does not contain: The entered value is not part of the content in the first drop-down menu.
  • Matches: The content in the first drop-down menu is complete the same as the specified value.
  • Does not match: The content in the first drop-down menu is not complete the same as the specified value.
    Information Note: When you select Hostname as data source from the first drop-down list, the system supports the Hostname Matches + regular expressions. See  Regex Search for more details.
    Information Note : When you select Config File as data source, and Matches as the operator, the system supports "Matches Near", to better match two keywords separated by other words.

5.  Click Search. The searched result is displayed as follows:
Graphical user interface, text, application, email Description automatically generated 

Components for Search Devices by Formula

The following table lists the available components in a Search Devices by Formula.

Table1 - Components in a Search Devices by Formula
ComponentDescriptionOption Values
Search ScopeThe scope of devices.
  • All Devices — all devices in the current domain (SDN and Public Devices are included).
  • Site — devices in one or more sites.
  • Device Group — devices in one or more device groups.
Search CriteriaProperty
  • Device Property — use one or more device properties to find devices.
    Tip: Whether a property can be used as a condition for Search Devices by Formula is configured in the global data repository.
  • Interface Property — use one or more interface properties to find devices.
  • Module Property — use one or more module properties to find devices.
  • Config File — use texts in the configuration file to find devices.
  • Front Server — use a Front Server to find their managed devices.
    Information Tip: The information about all registered Front Servers can be browsed in Shared Network Settings.
Match Operator

Specify multiple values by separating them with a semicolon (;).

  • Matches/Matches any/Does not match/Does not Match any — The full-text search pattern will be applied.
  • Contains/Does not contain — The * and ? characters are treated as either wildcards (only for a single term) or separators.
    Information Note: If you want the pattern to start at the beginning of the string or finish at the end of the string, then you have to anchor it specifically, by using ^ to indicate the beginning or $ to indicate the end. When $ is used at the end of a string with multiple terms, then it represents an exact match.
Boolean ExpressionThe logical relationships among search criteria.
  • Capitalized letters to represent the search criteria (A, B, C ....).
  • Boolean operator (and/or), which is used to define the logical relationships among the search criteria. By default, the and operator is used.
  • Parentheses, which is used to combine some search criteria.

 

Dynamic Search Manage and Operate Maps