Run Usage Searches

In the Metadata Manager, usage searches allow you to search for how the items are used across a specific type or across all types. You can run usage searches from the Items window, or directly from the Search dialog box. For usage searches, you need to provide information about the related type, such as a type name, item name, or an attribute name.

It is helpful to know the actual metadata hierarchy structure prior to running the usage searches. The usage search results include parents and/or children, depending on the search criteria. The mapping is always included.

On this page

1 Search from the Items Window
2 Search from the Search Dialog Box

The following search criteria are used by the usage search:

use and do not use. Return the parent metadata of the child selected in the related type.
are used by and not used by. Return the children metadata of the parent selected in the related type.
use or are used by. Returns both the parents and the children metadata depending on how the search criteria is entered.

Search from the Items Window

To run a usage search from the Items window:

From any Metadata Manager window, click Types in the navigation path, or click the Types bottom tab to display types in the workspace.
Double click a row to select a specific type for which you wish to display item details.
You see the item list for the type you selected.
Right click any row displayed in the Items window.
Click Run a Usage Search for this Item.
You see the Search dialog box that displays the usage search with the Item ID and Item Name of the item you selected pre-populated in the Related Type criteria.
If needed, click that drop down to edit the use, do not use, used by, not used by, or use or are used by search criteria.
Click the Search for drop down and select a type.
Enter the From Type criteria.
Click the Search button in the lower left corner of the Search dialog box.
In the Search Results window, you see the items based on the criteria you selected.
Click to select an item and click Load Paths to see all the navigation paths to the item.
Click the Path name to view the item in the Item Detail window.
In Item Detail window, click the Attributes, Parents & Children, or Mapping tabs to view the item details.
Click the Types bottom tab to return to the Types window.

Search from the Search Dialog Box

To run a usage search from the Search dialog box:

From any Metadata Manager window, click the double arrow next to the Search button to access the Search dialog box.
In the Search dialog box, click the Usage tab.
Click the Search for drop down and select a type.
Enter the From Type criteria.
Click that drop down and select use, do not use, used by, not used by, or use or are used by search criteria.
Click the second Search for drop down and select a type.
Enter the Related Type criteria.
Click the Search button in the lower left corner of the Search dialog box.
In the Search Results window, you see the items based on the criteria you selected.
Click to select an item and click Load Paths to see all the navigation paths to the item.
Click the Path name to view the item in the Item Detail window.
In Item Detail window, click the Attributes, Parents & Children, or Mapping tabs to view the item details.
Click the Types bottom tab to return to the Types window.