Use > Modeling > Introduction > Topology Query Language > Shortcut Menu Options

Shortcut Menu Options

This section includes a list of TQL query shortcut menu options:

UI Element (A-Z) Description
Add Calculated Relationship

Enables you to create a calculated relationship.

Add Compound Relationship

Enables you to define the connection between two query nodes using a compound relationship.

For details, see Add/Edit Compound Relationship Dialog Box.

Add Join Relationship

Enables you to define join relationships. You create them by defining an attribute for each query node. These query node values are used for comparison during federation.

For details, see Add/Edit Join Relationship Dialog Box.

Add Related Query Node Wizard Displays the Add Related Query Node Wizard which enables you to build a TQL query. For details, see Add Related Query Node Wizard.
Add Relationship

Enables you to create a relationship for your query nodes by selecting it from a predefined list. Displays the Add Relationship dialog box.

For details, see Add/Edit Relationship Dialog Box.

Note In Enrichment Manager, this option adds an Enrichment relationship to the rule when working in Enrichment mode. Applicable for regular and Enrichment query nodes. For details, see Enrichment Manager. Added relationships are denoted by an added indicator.

Add to Hierarchy

Adds the selected query node to the hierarchy as a separate query node.

Note Only relevant for the Modeling Studio.

Add to Model Output

Designates the selected query node as output for the pattern-based model.

Note Only relevant for pattern-based models in the Modeling Studio.

Change Query Node/Relationship Type

Displays the Change Query Node Type dialog box. Enables you to change the CI type of the query node after you have created it. For details, see Change Query Node/Relationship Type Dialog Box.

Note Only relevant for the Modeling Studio.

Clear

Available by right-clicking a query node or relationship when working in Enrichment mode in the Enrichment Manager. Clears the query node/relationship's Enrichment rule definition. For details, see Enrichment Manager.

Appears only if you have updated or deleted a query node/relationship using an Enrichment rule.

Note Only relevant for Enrichment Manager.

Copy/Paste

Copy/paste an existing TQL query node/relationship in the same query or into another TQL query.

The copied TQL query node/relationship includes all TQL definitions.

You can copy and paste relationships provided that the TQL query nodes to which the relationships are connected are also selected. A relationship on its own cannot be copied without its connecting TQL query nodes.

You can select multiple TQL query nodes/relationships as well.

Note The Copy and Paste options are only available in the Modeling Studio. The Paste option is available only after using the Copy option to copy an existing TQL query node/relationship.

Define Impacted

Defines which query node in the TQL query is the trigger Impact Analysis query node and which query nodes are impacted by the changes that occur in the system. For details, see Impacted Query Nodes Dialog Box.

Note Only relevant for Impact Analysis Manager.

Delete

Deletes the selected query node/relationship/CI.

Note This option is not available for calculated relationships.

Delete Relationship/Query Node

Available by right-clicking a query node or relationship when working in Enrichment mode.

Creates a specific Enrichment rule that is designed to delete CIs/relationships from the CMDB. Applicable to regular query nodes and relationships only. You can use this option, for example, for removing unnecessary data from the CMDB. For details, see Enrichment Manager.

Deleted query nodes and relationships are denoted by a removed indicator.

Note Only relevant for Enrichment Manager.

Edit Relationship

Displays the Refine Relationship Type dialog box. For details, see Refine Query Node Type Dialog Box.

Note  

  • Not relevant in the Modeling Studio.
  • This option appears only when the selected relationship has descendants.
Hide Element in Query Results

When this option is selected, a Hidden in Query Results indicator appears to the right of the selected TQL query node in the editing pane.

Any query results pertaining to that TQL query node are not displayed in the topology map. This can be useful when certain relationships or TQL query nodes are required to build the query but are not needed in the results. At least one query node must be visible for the view to be valid.

Note Only relevant for the Modeling Studio.

Hide Element in View Results

Hides the selected virtual-compound relationship when viewing the results of an Automated Service Map in the UCMDB Browser (based on the Service_template perspective being applied on top of the service's Business Element CI), as long as the CIs linked by the virtual-compound relationship are not linked by any other relationship.

Note  

  • This option appears only when you are creating or editing the perspective on which a service model is based. Only relevant for the Modeling Studio.
  • If the Hide Element in Query Results option is selected for a node, this option will not be available, since the node and all of its relationships will not appear.
Query Node/Relationship Properties

Displays the Query Node/Relationship Properties dialog box, enabling you to define the attribute conditions for the selected TQL query node/relationship. For details, see Query Node/Relationship Properties Dialog Box.

Note This option is not available for calculated relationships.

Refine Query Node Type

Displays the Refine Query Node Type dialog box. Enables you to change the CI type of the query node after you have created it. For details, see Refine Query Node Type Dialog Box.

Note This option only appears if a child of the CI type exists. Only relevant for Impact Analysis Manager and Enrichment Manager.

Remove Subgraph Only appears if you have defined a subgraph definition. For details, see Subgraph Definition Dialog Box.
Reset Impacted

Removes the Define Impacted definition applied to that query node. For details on the Define Impacted definition, see Impacted Query Nodes Dialog Box.

Note Only relevant for Impact Analysis Manager.

Reset Inner Relationship

Redraws a self-referential relationship in the Topology map as a square for ease of viewing.

Note Only relevant for self-referential relationships that are not square.

Select All

Selects all query nodes and relationships in the TQL query.

Note Only relevant for the Modeling Studio.

Set As Contact Query Node

Designates the selected query node as a contact query node for the perspective.

Note Only relevant for perspectives in the Modeling Studio.

Set Integration Points

Opens the Select Integration Points dialog box which enables you to select the required data sources for a TQL query node.

Note Only relevant for the Modeling Studio.

Show Element in Query Results

When this option is selected, the results pertaining to the TQL query node are displayed in the topology map.

Note Only relevant for the Modeling Studio.

Show Element in View Results

Displays the selected virtual-compound relationship when viewing the results of an Automated Service Map in the UCMDB Browser (based on the Service_template perspective being applied on top of the service's Business Element CI).

Note  

  • This option appears only when you are creating or editing the perspective on which a service model is based. Only relevant for the Modeling Studio.

  • If the Show Element in Query Results option is selected for a node, this option will not be available, since the node and all of its relationships are already displayed.
Show Element instances

Displays the CI Instances dialog box which displays all the instances found for each query node in a table. For details, see CI Instances Dialog Box.

Show Node Parameters

Opens the Template Parameter Values dialog box, which enables you to set the values of the query node's parameters.

Note Only relevant for template-based views in the Modeling Studio.

Subgraph Definition

Displays the Subgraph Definition dialog box, where you can create a graph that represents additional TQL query data related to a specific query node. For details, see Subgraph Definition Dialog Box.

Update Relationship/Query Node

Use an Enrichment rule to update the value of CI attributes in the CMDB, or to add data to attributes that currently do not have values. Opens the Query Node Definition - Attributes dialog box. For details, see Query Node/Relationship Definition Dialog Box. This is applicable for both regular and Enrichment query nodes.

Updated query nodes are denoted by an updated indicator.

Note Only relevant for Enrichment Manager.