TQL Query Editor

This feature enables you to build and edit TQL queries.

To access

To open a new TQL query in the TQL Query Editor, go to the Modeling Studio, click the New button and select Query.

To open an existing TQL query in the TQL Query Editor, go to the Resources tab of the left pane in the Modeling Studio and select Queries as the Resource type. Right-click a TQL query in the tree and select Open Query or double click a TQL query or drag a TQL query onto the empty canvas. The TQL query opens in a new tab.

Important information To save your TQL query, use the Save button on the Modeling Studio main toolbar.
Relevant tasks How to Define a TQL Query
See also

User interface elements are described below (unlabeled elements are shown in angle brackets):

UI Element (A-Z) Description

Show View Results in IT Universe. Goes directly to the selected view in IT Universe Manager.

Note This button only appears for views, templates, or perspectives.

Create Relationship. Enables you to draw a relationship from one query node to another.
Calculate Query Result Count. Calculates the number of instances found for each TQL query node or relationship.
Preview. Displays a preview of the TQL query results as they would appear in IT Universe Manager.
Delete. Deletes the selected query node or relationship from the query.

Query/View Definition Properties.

For queries, opens the Query Definition Properties dialog box which enables you to edit the type, scope, and priority of the TQL query.

For views, opens the View Definition Properties dialog box.

Report Properties. Opens the Report Properties dialog box, which enables you to set the title, subtitle, and format for the view's topology report. For details, see Report Properties Dialog Box.

Note This button only appears for views, templates, or perspectives.

Assign Tenants. Opens the Assign Tenants dialog box which enables you to assign tenants to the resource.

Note This button is only available when multi-tenancy is enabled.

Manage Security. Enables you to assign the selected resource to specific roles or resource groups.

Show Parameters. Opens the Template Parameter Values dialog box which enables you to edit the parameters of a query node in a template-based view.

Note This button only appears for template-based views.


Indicates the icons displayed next to CIs with any of the following special designations:

  • It is defined as a contact query node in a perspective

  • It is a federated CI

  • It has attributes defined

  • It has selected identities defined

  • It is hidden in the query results

  • It is defined as the output query node of a pattern-based model

  • It has a subgraph defined

<Main menu> For details, see Main Menu.
<Shortcut menu options> For details, see Shortcut Menu Options.
<Topology Map Sidebar> For details, see Topology Map Sidebar.