How to Create a Dynamic Widget

This task describes how to define a new dynamic widget for the UCMDB Browser module.

1. Create a New Dynamic Widget in the Pattern View Editor

   Click New and select Dynamic Widget. In the New Dynamic Widget dialog box, select the base TQL query on which your new dynamic widget is based, or select Create new query to build a new TQL query.

2. Add Query Nodes and Relationships to a TQL Query

   In the View tab, add the query nodes and relationships that define the query. For details, see How to Add Query Nodes and Relationships to a TQL Query.

   Note The root (and only the root) of the folding definition in the TQL query must be designated as a contact query node for the dynamic widget to display data about that node in the UCMDB Browser module. If no contact query node is specified, the TQL query is saved as a pattern view and not as a dynamic widget.

   1. Specify whether to use a manual (default) or rule-based hierarchy when defining the TQL query. For details, see Setting the View Hierarchy.

      Note If you are starting with a blank widget, you must add at least one query node in order to save your widget.

   2. For each property for which you want data to be displayed in notifications in the dynamic widget, do the following:

      1. Right-click a node in the topology map and select Query Node Properties.
      2. Click the Element Layout tab.
      3. Select the Select attributes for layout radio button.
      4. In the Conditions pane, select either All (to display all attributes of the selected node) or Specific Attributes (to display only the attributes you select).
      5. Select attributes in the Available Attributes pane and click to add them to the Specific Attributes pane.
      6. Click OK when you are finished.

3. Select Attributes for the Widget

   In the Report tab, select a node in the Hierarchy pane, and choose the attributes for that node for which you want data to be displayed in the widget.

   Note In the Hierarchy pane in either the Report tab or the View tab, you can specify a grouping option on any node. Although you can choose between different grouping options, the CI's attributes are always displayed in groups by CI type when you view the dynamic widget in the UCMDB Browser module in Widget Details mode. To set a grouping option, right-click a node in the hierarchy tree and select one of the grouping options (attribute, CI type, or view node).

4. Set Values for the Widget's Attributes

   In the Widget tab, select a node and specify how and where you want the selected attributes to be visible in the widget. For details, see Pattern View Editor.

   • Select the Show path check box to cause the UCMDB Browser module to display the route in the dynamic widget from a specific node in the view definition to all the node's children.
   • Select the Browser CI access control check box to ensure that the dynamic widget displays data only according to the permissions that were specified on the Browser CI Access Control tab in the Roles manager. If the check box is not selected, the dynamic widget will display all data, without permission enforcement.

   • Select an initial display mode for the dynamic widget.

     • Properties Mode. Displays individual properties for CIs.

       Note If you do not select a Widget Type value, Properties Mode is enabled by default.

     • Topology Map Mode. Displays CIs according to your current topology.
     • Topology CIT Group Mode. Displays CIs grouped by CI type according to your current model.
     • Topology Textual Mode. Displays a list of CIs broken down by CI type.

     The topology mode that you select is the initial view selection until you change to another one in the UCMDB Browser module.

   When you are finished, click Save .

Related Information