Sun Java System Directory Editor 1 2004Q4 Installation and Configuration Guide |
Chapter 6
Searching DirectoriesYou can use the Directory Editor Search tab to search for objects in the directory installation.
This chapter explains how to configure and execute three different types of searches from the Directory Editor Search page. The information is organized as follows:
Executing a Basic SearchUse the Basic Search tab (the default page) to search for users, groups, or organizational units.
Figure 6-1 Search Results
To perform a basic search, use the following steps:
- Enter the name of a user, a group, or organizational unit into the text field provided.
For example, type manager for a list of all objects that have “manager” in their name.
- Select a Search Type from the drop-down menu.
- Click the Search button or press Return (Enter) on your keyboard.
The search results will display in table-format at the bottom of the Search page.
For example, the following figure shows the result of searching for manager:
Figure 6-2 Search Results
A bank of buttons also displays just above the Results table. You use these buttons in conjunction with the table.
Note that each entry in the Results table is preceded by a checkbox. You can enable one or more checkboxes to select those rows for an action and then click one of the following buttons:
- Create: Opens a Create page so you can add a new user, group, or organizational unit. (See Chapter 4, "Creating and Editing Objects.")
- Delete: Opens an Delete page, where you must confirm whether to delete the object. Click Delete to confirm the action or click Cancel to terminate the action.
- Rename: Opens a Rename page so you can specify a new name for that object and for children of the object. (See Chapter 4, "Creating and Editing Objects.")
- Enable: Opens an Enable page, where you must confirm whether to enable the object. Click Enable to confirm the action or click Cancel to terminate the action.
- Disable: Opens an Disable page, where you must confirm whether to disable the object. Click Disable to confirm the action or click Cancel to terminate the action.
Note
You can also click any linked entry in the table’s Name column, to open the Edit an Object page where you can edit the object’s attributes. See Chapter 4, "Creating and Editing Objects." for more information about editing objects.
Executing an Advanced SearchSelect the Advanced Search tab to search for objects by specifying search conditions, which can be combined with and operations.
Figure 6-3 Advanced Search Tab
To configure and execute an advanced search, use the following steps:
- Select one of the following object types from the Search type menu:
- User
- Group
- Organizational Unit
- Other
When you select the Other option, the Object Classes selection tool displays (similar to the one shown in the following figure).
Figure 6-4 Selecting Object Classes
- You can select object classes from the Available Object Classes list and click the Add button to move the object classes to the Selected Object Classes list.
- Click Add All to move all available object classes to the Selected Object Classes list.
- Click Remove All to move all object classes from the Selected Object Classes list back to the Available Object Classes list.
- Select object classes from the Selected Object Classes list and click Remove to move the object classes from the Selected list back to the Available Object Classes list.
- Enter a Base Context in the text box provided (or click Browse to search the organizational units in the directory).
The Search will return results from items in this container and “contained” containers.
- Use the Search Conditions table to configure your search criteria, as follows:
- Click the drop-down button in the Attribute column to select an attribute from the list.
Note
- The attributes in this list are determined by the object type specified in Step 1.
- You cannot remove all rows in this table. If you try to remove the only remaining row, an error will result.
- Click the drop-down button in the Conditions column and select one of the following conditions from the list:
- Enter a value to search for into the Value column of the table.
Note
The Attribute, Condition, and Value entries are “OR’ed” together to create the search criteria.
- Click the Search button.
The search results will display in table-format just below the text field.
The search results will display in table-format at the bottom of the Search page.
As with a Basic Search, a bank of buttons (Create, Delete, Rename, Enable, and Disable) also displays just above the Results table. Use these buttons in conjunction with the table as described in Step 2.
Note
Click any of the linked entries in the Name column, and the Edit an Object page displays so you can edit the object’s attributes. (See Chapter 4, "Creating and Editing Objects" for information about editing objects.)
Following are several examples of an Advanced Search.
Someone reports a “fender-bender” in the parking lot and you want to notify the car owner. You could specify the following parameters to identify the owner:
The following figure shows the result of searching for the license number:
Figure 6-5 Example 1 Search Results
You want to send an email to all Marketing managers. You could specify the following parameters to identify these managers:
The following figure shows the result of searching for Marketing managers:
Figure 6-6 Example 2 Search Results
Executing a Filtered SearchSelect the Filtered Search tab to specify free-form query strings to search for objects in the directory.
Figure 6-7 Filtered Search tab
The default search string on this tab is (&(objectclass=Person)(cn=*) or a string that represents the current basic or advanced search specified on the Basic or Advanced Search tabs.
You can use the default search string or specify your own query in the Search Filter text field. For example, if you want to search for all groups in the directory, type the following text in the Search Filter text field and click Search:
(|(ObjectClass=groupofnames)(ObjectClass=groupofUniqueNames))
The following figure shows the result of the filtered search.
Figure 6-8 Example Filtered Search Results
As with the other search methods, the search results will display in table-format at the bottom of the Search page.
In addition, a bank of buttons (Create, Delete, Rename, Enable, and Disable) displays just above the Results table. Use these buttons in conjunction with the table as described in step 2 on page 6-82.
Note
Click any of the linked entries in the Name column, and the Edit an Object page displays so you can edit the object’s attributes. (See Chapter 4, "Creating and Editing Objects" for information about editing objects.)
Editing the Search Page ConfigurationThe procedures in this section describe how to change the appearance and content of your Search page. The information is organized as follows:
Accessing the Search Configuration Page
To open the Search Configuration page, select the Configure > Search Options.
The Search Configuration page is displayed as follows:Figure 6-9 Search Configuration Page
This page contains three tabs:
Specifying Default Settings
Use the following procedure to configure a default search filter for the Search page.
- Select the Settings tab (see Figure 6-9).
- Modify the default filter shown in the Default Search Filter text box or enter a new filter.
- Modify or enter a new display name in the Display Name text box.
You may want Directory Editor to return results in the same way your company displays data. For example; cn, uid, and so forth.
- You can click Save to apply your changes (or click Cancel and return to the Home page).
From here, you can select another tab to continue configuring your Search page.
Configuring the Results Table
Use the following procedure to configure a results table for the Search page.
- Select the Results Table tab.
Figure 6-10 Results Table Page
- Use the Results Columns selection tool to add attributes to or remove attributes from the Selected Attributes list, as follows:
- Select one or more attributes from the Available Attributes list and click the button to move them to the Selected Attributes list. (Press your Shift key and click on items in the list to select multiple attributes.)
- Click the button to move all available attributes to the Selected Attributes list.
- Click the button to move all attributes from the Selected Attributes list back to the Available Attributes list.
- Select one or more attributes from the Selected Attributes list and click the button to move them back to the Available Attributes list.
- Use the (move up) and (move down) buttons to change the order of attributes in the Selected Attributes list.
- By default, Directory Editor populates the Display Names table with attribute names and display names.
You can replace the default names in the Display Names column by typing directly into the text boxes provided.
- Enter a value in the Use the Length of each field in the results table text box to specify the maximum character length for fields results table.
- Enter a value in the Number of Results text box to specify the maximum number of search results (how many lines) to display in the Results table.
Specifying Search Types
You can use the Search Types page to modify the kind of search Directory Editor performs by default. Use the following procedure to specify the type of searches available for the Search page.
- Select the Search Types tab.
Figure 6-11 Search Types Page
- If necessary, change the Default Search Type name by entering a new value in the text box provided.
- Use the table to change the search type names and associated attributes that are available in the Search Type menu list.
- To change the name of a search type, delete the old name and enter a new value.
For example, you might want to change Organization to Offices.
- Use the Objectclasses selection tools in the Value column to create a list of valid values for that search type.
For example, you might want to specify the following values for the User type:
- When you are finished, click the Save button to save your changes and return to the Home page (or click Cancel to undo your changes).
Adding Search Types
To add search types to the table, use the following procedure:
- Click the Add Type button located beneath the table.
- When Directory Editor adds a new row to the table, enter a name for the search type in the text box provided in the Name column.
- Use the Objectclasses selection tool in the Value column to create a list of valid values for the new search type.
For example, you might want to specify a Location search type with the following objectclasses:
- When you are finished, click Save to save your changes and return to the Home page (or click Cancel to undo your changes).
Removing Search Types
To remove objects from the Search Types menu list,
- Enable the checkbox next to the search type you want to delete.
- Click the Remove Selected Types button located beneath the table.
Directory Editor immediately removes that row from the table.
- Click Save to save your changes and return to the Home page, or click Cancel to undo your changes and return to the Home page.