Searching for directory objects
To search for directory objects, you can use the Search page that allows you to select the container to search and specify criteria for the objects you want to find. The Web Interface searches in the container you select and in all of its subcontainers.
The Web Interface opens the Search page when you do any of the following:
-
Type in the Search field located in the upper right corner of the Web Interface window, then press Enter or click the magnifying glass icon in the Search field. In this case, the Web Interface searches all managed Active Directory domains for objects whose naming properties match what you typed and the Search page lists the search results. The naming properties include name, first name, last name, display name, and logon name.
-
Click Search on the Navigation bar. The Search page opens, allowing you to configure and start a search.
To configure and start a search
-
Click the Search in box on the Toolbar, then select the container that you want to search. You can select more than one container.
The Web Interface will search in the selected container and all of its subcontainers.
-
Specify criteria for the objects that you want to find:
-
To search by naming properties, type in the Search field on the Toolbar. The Web Interface will search for objects whose naming properties match what you typed. The naming properties include name, first name, last name, display name, and logon name.
-
To search by other properties, click the button on the right side of the Toolbar to expand the Toolbar, click Add criteria, choose the properties by which you want to search, click Add, then configure the criteria as appropriate. The Web Interface will search for objects that match the criteria that you configured.
-
Press Enter to start the search.
The search results are listed on the Search page. You can customize the list by adding or removing list columns and sorting the list by column data. To add or remove list columns, click the Menu button on the left side of the Toolbar and then click Choose columns (see also Adding or removing columns from the list of objects). To sort the list by column data, click column headings.
Searching by object type
You can list objects by type in the Active Roles Web Interface. This is useful, for example, to look for specific object types or to narrow the conditions of a search. The following example shows how to use this feature by listing all groups in an Active Directory domain managed with Active Roles.
To list all groups that exist in your Active Directory domain
-
Click Search on the Navigation bar.
-
Expand the Toolbar with the button on the right side of the Toolbar. Then, click Add criteria, select Object type is User/InetOrgPerson/Computer/Group/Organizational Unit, and click the Add button.
-
On the Toolbar, click Group in the list next to The object type is, then press Enter.
Filtering the contents of a container
If a container, such as an Organizational Unit in your Active Directory, holds a large number of objects, you can narrow down the displayed list of objects by filtering the objects held in that specific container.
To filter the objects held in a container
-
Navigate to the container in the Web Interface. To navigate to a container, you can:
IMPORTANT: The scope of filtering is always set to the current container, and does not include any subcontainers of that container. Filtering is essentially a search for objects held in a given container only. If you want to search the current container and all of its subcontainers, click Search under this container in the Command pane, then configure and perform a search as described in Searching for directory objects.
-
Specify how you want to filter the objects held in the container:
-
To filter objects by naming properties, enter them in the Filter field on the Toolbar, then press Enter or click the button next to the Filter field. The list of objects will include only the objects whose naming properties match what you entered. The naming properties include name, first name, last name, display name, and login name.
-
To filter objects by other properties, expand the Toolbar with the button on the right side of the Toolbar, and click Add criteria. Then, choose the properties by which you want to filter, click Add, and configure the criteria as appropriate. The list of objects will include only the objects that match the criteria you configured.
-
To apply the filter, press Enter or click the button next to the Filter field on the Toolbar.
When a filter is applied to a container, the Web Interface lists a subset of all objects held in that container. Once you no longer need it, you can remove the filter to view all objects again:
-
If you did not add any criteria, clear the Filter field on the Toolbar and press Enter.
-
If you specified any criteria, expand the Toolbar, click Clear all, then press Enter.
Filtering by object type
To improve searching for specific objects, you can filter by object type in the Active Roles Web Interface. The following example procedure shows to configure such a filter.
To configure a filter that lists only user accounts held in a particular Organizational Unit or remove objects of any other type from the list
-
Navigate to the Organizational Unit in the Web Interface.
-
Expand the Toolbar with the button on the right side, then click Add criteria, and select Object type is User/InetOrgPerson/Computer/Group/Organizational Unit. Then, click Add.
-
On the Toolbar, confirm that the field next to The object type is reads User, then click the button next to the Filter field, or press Enter.