Microsoft Identity Integration Server 2003 graphic

Using Metaverse Search

Metaverse Search is used to locate, list, and configure the state of objects in the metaverse. You use Metaverse Search to view the lineage of objects in the metaverse to troubleshoot attribute precedence problems, disconnect an object, or view groups of objects for troubleshooting. In a large enterprise, the number of metaverse objects can run into the millions. Metaverse Search can be used to locate a single object or a subset of objects based on similar attribute values.

Searches are implemented by running search queries. Search queries are created by selecting an object type to scope by and building one or more search clauses. A search clause can consist of three parts: an attribute, an operator, and a value. Some search clauses may only use an attribute and an operator. For example, the following three-part search query returns all persons in the accounting department:

The following two-part search query returns all persons that do not have a homePhone attribute:

A metaverse search query can also consist of multiple clauses. The following search query returns all Assistant Managers in the Seattle-area offices: First clause: Second clause:

Search queries persist after you close Identity Manager; however, the search results are not saved. If you create queries that you want to use on a regular basis, you can save or export the queries and import them as you need them. Queries are saved in XML format with a .qry file extension.

Displaying the properties of a metaverse object

When you have run your search query, you can click any object in the Search Results list to display the property page for that metaverse object. There are two tabs on the property page: Attributes and Connectors.

The following table lists the information that is displayed on the Attributes tab.

Column Description
Attribute name Displays the metaverse attribute name.
Value Displays the value of the attribute.
Contributing management agent Displays by which management agent the value was last updated.
Type Displays the attribute type. For more information about attribute types, see Using Metaverse Designer.
Last modified Displays the date and time that the attribute was last modified.

The following tables list the information that is displayed on the Connectors tab.

Column Description
Distinguished name Displays the value of the distinguished name (also known as DN) attribute for the object in each connected management agent.
Management agent Displays all management agents that the object is linked to.
Join method Displays by what process the object was linked to the management agent. Possible values are:
  • provisioning-rules
  • join-rules
  • projection-rules
  • import-flow-rules
  • export-flow-rules
  • de-provisioning-rules
  • connector-filter-rules
  • mv-deletion-rules
  • joiner-rule
Button Description
Properties When a connector is selected in the list, this displays the properties of the linked object in the connector space of that management agent
Disconnect When a connector is selected in the list, this disconnects the linked object in the connector space of that management agent from the metaverse. You may select whether to make the object a Disconnector (default) or an Explicit Disconnector.
For more information, see Work with Metaverse Search.