Dynamic Widgets

Search for	Example	Results
A single word	`cat`	Topics that contain the word "cat". You will also find its grammatical variations, such as "cats".
A phrase. You can specify that the search results contain a specific phrase.	`"cat food"` (quotation marks)	Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase.

Search for	Operator	Example
Two or more words in the same topic	`AND` `and` `+` (plus symbol) `&` (ampersand)	`cat AND dog` `"cat food"+milk` `"cat food"&"dog food"`
Either word in a topic	`OR` `or` `\|` (pipe)	`cat OR dog` `cat \| dog`
Topics that do not contain a specific word or phrase	`NOT` `not` `!` (exclamation point)	`NOT cat` `! dog`
Topics that contain one string and do not contain another	`^` (caret)	`cat ^ mouse`
A combination of search types	`( )` parentheses	`cat + (dog \| mouse)` `cat \| dog + (! mouse)`

Note Dynamic widgets are supported on UCMDB 10.10 and later versions.

Dynamic widgets are widgets that display data about a particular view. You create dynamic widgets in the Modeling Studio in UCMDB.

Note

After you create a dynamic widget in UCMDB, you must log out of the UCMDB Browser and then log in again to see the newly created widget.
Only one level of grouping is supported.
If no grouping option has been specified in the hierarchy tree, all CI attributes appear in a single screen.
You must use the > Resource Creation Action > Dynamic Widget action on the Security > Roles Manager > General Actions tab to control which users may create new dynamic widgets in the Modeling Studio (for use in the UCMDB Browser).

Create a dynamic widget

In UCMDB, go to Modeling > Modeling Studio.

Note To create a dynamic widget, you must have Create Dynamic Widget permission assigned in the Roles Manager in UCMDB.

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

In the View tab, add the query nodes and relationships that define the query.

Specify whether to use a manual (default) or rule-based hierarchy when defining the TQL query.

Note If you are starting with a blank widget, you must add at least one query node in order to save your widget.
In the Report tab, select a node in the Hierarchy pane, and choose the attributes for that node that you want to appear in the widget.

In the Widget tab, select a node and set values for that node's attributes:

UI Element	Description
Overview	Boolean. Specifies whether this attribute appears in the CI Overview mode.
Details	Boolean. Specifies whether this attribute appears in the Widget Details mode.
Refocusable	Boolean. Causes the attribute to appear as a hyperlink, which will refocus to the CI on which it is defined.
Group Name	String. Specifies the name of the section under which the attribute will be grouped in the Widget Details mode.

Select the Show path checkbox to cause the UCMDB Browser to display the route in the dynamic widget from a specific node in the view definition to all the node's children.
Select the Enforce Browser CI access control checkbox to ensure that the dynamic widget displays data only according to the permissions that were specified in UCMDB (on the Browser CI Access Control tab in the Roles manager). If the checkbox 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 (folding definitions are also reflected).
- 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.