QQL User Interface Elements

QQL brings you an intuitive user interface (UI). Here’s a quick tour of the key UI elements in QQL, which you find in most of the Qualys modules in your subscription:

The various user interface elements of a QQL query.

Let us view each UI element of the QQL query.

1. Data Sources

2. Search bar

3. The Plus Icon icon

4. Search Help icon

5. Search Action menu

1. Data Sources:

On some tabs that support QQL queries, you see a list of data sources adjacent to the Search bar. For your convenience, we’ve categorized the available search tokens into these data sources. For example, in the example screenshot given earlier in this topic, you see the Vulnerability data source and the Asset data source. So, here you need to decide whether you want to use search tokens that fetch data from the Vulnerability data source or you want to look for the Asset tokens (or use both and form a combined query).

The interface will only provide auto-suggest options for the tokens that are valid for the query search bar you are in. Invalid tokens won’t return any results.

2. Search bar:

Here is where you type the search query. Start typing and, the auto-suggest feature will list down all the possible tokens that you can use.

See Qualys Query Language Syntax

3. The icon:

Create a query by using just one data source index, or click the icon, add another query that contains tokens belonging to a different search index and refine your search. Such queries are logically ANDed together.

Example of using multiple elements to form a search query.

4. Search Help icon:

Click (Search Help icon) to see the How to Search topic. This topic provides Help context about how to leverage the search capabilities of QQL.

5. Search Action menu:

To view more options related to your search queries, use the Search Action menu. Here are actions listed in the menu:

Available option	Description
Recent Searches	View the queries that you entered recently in the Search bar. You can pick queries from your recent searches and reuse them.
Save this Search Query	You create a QQL query and press Enter to view the query results. After your get the results, click this option to save your query and the results. Thus, you can save your queries for future reference.
Manage Saved Searches	Click this option and then from the Saved Searches dialog, pick your saved query search, reuse it and/or modify it as required.
Create Widget from Query	Click this option to visualize your query results in the form of a dashboard widget. After you click this option, you see the Customize data widget screen and your query pre-populated in the query box.

See Examples