Query Builders

In Tenable Web App Scanning, you can use Query Builders to build filter queries so that you can view specific data in a table. See Filtering and Simple Search. You can also save filter queries that you build. See Saved Queries.

Important: When you run a query using a query builder, it applies to all data in the table.

The Query Builder serves as the unified filtering engine across the Tenable Web App Scanning platform. Depending on the feature within Tenable Web App Scanning, query builders may have additional functionality.

  • Query Builder (Filters) — The ability to construct logic using specific fields. See Filtering and Simple Search.

  • Simple Search (Quotes) — The ability to perform a text-based search across multiple fields using double-quotes. See Filtering and Simple Search.

  • Saved Queries — The ability to save the filter query for reuse. See Saved Queries

Components of a Query

Queries consist of boolean conditions joined by boolean operators AND and OR. Query conditions have three components:

  • Filter — Filters available in the associated table (for example in Findings you find a Severity filter).

  • Operator — An operator to filter on (for example, is not equal to).

  • Value — The value to search (for example, a Severity of Critical).

Tip: You can nest queries with parentheses. For example, to search for high-severity findings where the VPR is greater than seven or the CVSSv3 Base Score is greater than six, use:

Severity is equal to Critical AND (VPR is greater than 7 OR CVSSv3 Base Score is greater than 6) .

Note: To ensure optimal performance while providing maximum flexibility, Tenable Web App Scanning limits the number of filters for defining a dataset to 35 boolean filter conditions in a single query.

For more information on creating and editing queries, see Manage Queries.