Search string syntax


Use the search string syntax that is explained in the following sections to find specific entities such as systems in the Helix Capacity Optimization Dashboard.

The search string is not case sensitive and can contain single terms (including wildcards) and phrases (delimited by double quotes), and can optionally be combined by using boolean operators. 

Using wildcards

Wildcards allow you to search for similar terms using a single string.

Two types of wildcards are available:

  • Single character wildcards (?): Indicate one variable character; for example, to search for "text" or "test" you can use the search string te?t.
  • Multiple character wildcards (*): Indicate zero or more variable characters; for example, to search for "test", "tests", or "testing" you can use the search string test*.

Using boolean operators

Boolean operators allow you to combine terms and phrases in a search using logical operators.

The following table lists the supported operators:

Warning

Note

Boolean operators must be specified using capital letters (upper case) in the search string.

Information
Additional information

If no operator is specified between two terms, the AND operator is used by default.

Grouping search terms and phrases

You can use parentheses to group clauses and form sub-queries. For example:

(database* OR "web service") AND billing

Restricting the search using fields

You can restrict the search to specific fields using the syntax:

<field>:<value>

where <field> is an optional filter used to restrict search results. The available fields, including description and examples, are listed in the following table. For most fields, aliases that are easier and more intuitive to remember are also available; e.g. scenario instead of tc.

 

The following table lists advanced field options that allow you to search for unique IDs; this can be useful if you already know the specific ID of the object you are looking for.

The following table lists advanced field options that allow you to specify numerical ranges; this can be useful to search for systems based on their hardware characteristics.

The fields disksizeldisksize, and totalmem are expressed in bytes; you can append a letter to numerical values to specify a different unit: K (kilobyte), M (megabyte), G (gigabyte), T (terabyte), P (petabyte).

Escaping special characters

If you need to use special characters as part of the search string, they must be properly escaped using the \ character. For example, to search for a system called "Database (2)", you must escape the string as follows:

Database \(2\)

Special characters that need to be escaped are:

+ - && \|\| \! ( ) { } \[ \] ^ " ~ * ? : \ 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Helix Capacity Optimization 19.11