Active Roles 7.3.3 - Web Interface User Guide

Getting Started Web Interface Basics Performing Management Tasks Using Approval Workflow

Searching for directory objects

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, and 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

  1. Click the Search in box on the Toolbar, and 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.

  2. 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, and then configure the criteria as appropriate. The Web Interface will search for objects that match the criteria that you configured.
  3. 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 earlier in this document). To sort the list by column data, click column headings.

Example: Searching by object type

Example: Searching by object type

The following steps demonstrate how you can use the search function to list all groups that exist in the Active Directory domains managed by Active Roles:

  1. Click Search on the Navigation bar.
  2. Click the button on the right side of the Toolbar to expand the Toolbar, click Add criteria, select the check box next to Object type is User/InetOrgPerson/Computer/Group/Organizational Unit, and then click the Add button.
  3. On the Toolbar, click Group in the list next to The object type is, and then press Enter.

Filtering the contents of a container

Filtering the contents of a container

If a container, such as an organizational unit in your Active Directory, holds 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

  1. Navigate to the container in the Web Interface.

    To navigate to a container, you can search for the container object (see Searching for directory objects) and then click its name in the list of search results on the Search page. Alternatively, you can browse for the container objects by using the Browse pane and the List of objects.

    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, and then configure and perform a search as described in Searching for directory objects earlier in this document.
  2. Specify how you want to filter the objects held in the container:
    • To filter objects by naming properties, type in the Filter field on the Toolbar and 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 typed. The naming properties include name, first name, last name, display name, and logon name.
    • To filter objects 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 filter, click Add, and then configure the criteria as appropriate. The list of objects will include only the objects that match the criteria you configured.
  3. 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. You can remove the filter to view all objects: If you did not add criteria, clear the Filter field on the Toolbar and then press Enter; otherwise, expand the Toolbar, click Clear all, and then press Enter.

Example: Filtering by object type

Example: Filtering by object type

The following steps demonstrate how you can configure a filter that lists only user accounts held in a particular organizational unit, removing objects of any other type from the list:

  1. Navigate to the organizational unit in the Web Interface.
  2. Click the button on the right side of the Toolbar to expand the Toolbar, click Add criteria, select the check box next to Object type is User/InetOrgPerson/Computer/Group/Organizational Unit, and then click the Add button.
  3. On the Toolbar, confirm that the field next to The object type is reads User and then click the button next to the Filter field, or press Enter.
Related Documents