Search Operations Oracle Fusion Middleware Online Documentation Library

Design Console Overview 1-15

1.5.1 Starting a Search

The Design Console enables you to perform searches queries for records in the database. Every form in the Design Console provides a search function. The search function is also available in lookup fields. To conduct a search on a blank form or after entering a search filter, click the binoculars icon on the toolbar. After you enter the search criteria in the query fields, click the binoculars symbol or press Ctrl+Q.

1.5.2 Constructing a Search Filter

You can filter the search results in a form field. Filtering limits the results that are returned to only the records that match the criteria you entered. If you leave all form fields blank before conducting the search, all records in the table are returned. You can use a wildcard character in a search. The asterisk wildcard character represents unspecified portions of the search criteria. You can use a wildcard character at the beginning, middle, or end of the value that you enter in a field. For example, if you enter B in the Location field of a Design Console form and execute a search, you retrieve all records with locations that begin with the letter B for example, Burbank, Boston, Bristol, and so on. If the asterisk is placed in the middle of a search value, as in Bon, you retrieve all records that begin with B and end with ON for example, Brighton, Boston, and so on. If you place the asterisk at the beginning of the search value, as in A, you retrieve all records that end in A for example, Philadelphia, Tampa, and so on. In Figure 1–12 , a query is performed on the Organizational Defaults form and the Organization Name field is used to filter the search criteria. The filter Xell ensures that only organizations with names that begin with Xell are retrieved. Figure 1–12 Using a Filter in a Search Query

1.5.3 Results of a Search

When you submit a search request by clicking the toolbar icon Query for records, one of the following occurs: 1-16 Oracle Fusion Middleware Developers Guide for Oracle Identity Manager ■ No records are returned . No records in the database match your search criteria for this form. Either the record that you are searching for no longer exists in the database, or you must modify your search criteria. ■ One record is returned. One record in the database matches your search criteria. The Form view displays that record. ■ More than one record is returned. Multiple records in the database match your search criteria. A Table view is displayed, listing all records that meet your search criteria. The first record is displayed in the Form view, as shown in Figure 1–13 . Figure 1–13 Multiple Records Returned

1.5.4 Working with a Set of Query Results

If multiple records in the database match your search criteria, you can view details about each record. Several buttons can assist you when viewing these records in the Form view. These directional buttons, referred to as VCR buttons, are located in the toolbar. The following table describes the VCR buttons:

1.5.5 Optimizing Query Performance

A query that returns a large result set can require significant time to run and can affect your computers performance. To optimize performance, use the following search techniques: ■ Define the scope of a search strategy as precisely as possible. Enter the most specific information that you can when constructing your query. For example, if the first name of a contact is JOHN and the last name is JACKSON, enter both pieces of information, rather than searching only for contacts with the last name JACKSON. ■ Use the asterisk wildcard character where possible. Buttons Description Click this button to display the first record in the result set in the Form view. Click this button to display the preceding record according to the display sequence in the Table view. The record is displayed in the result set in the Form view. Click this button to display the next record according to the display sequence in the Table view in the result set in the Form view. Click this button to display the last record in the result set in the Form view. Design Console Overview 1-17 If you place the asterisk in front of an alphabetic character for example, A, fewer records are returned as compared to when you leave a field blank.

1.5.6 Exceeding the Limit for a Result Set

If you have both read and write access to all forms and records in the Design Console that is, if you are a system administrator, you can set the maximum number of records that are displayed in the result set for a search. If the number of records retrieved for a search exceeds this value, the Design Console displays the Query size exceeded dialog box, as shown in Figure 1–14 . Figure 1–14 Query Size Exceeded Dialog Box You are prompted to enter a specific range or subset of the result set to be viewed. In Figure 1–14 , the maximum result set of 100 has been exceeded. Only records 1 through 100 will be displayed.

1.6 Forms Accessible from the Design Console

The left side of the Design Console main screen is the Design Console Explorer. The Explorer consists of a list of icons that represent forms that you have permissions to access. These icons are grouped under folders based on functionality and are displayed to the users according to the access rights that you assign to them. Figure 1–15 shows the Explorer in the Design Console main screen. 1-18 Oracle Fusion Middleware Developers Guide for Oracle Identity Manager Figure 1–15 The Design Console Main Screen The forms in the various folders in the Design Console Explorer are described in the following sections: ■ User Management ■ Resource Management ■ Process Management ■ Administration ■ Development Tools ■ Business Rule Definition

1.6.1 User Management

The User Management folder provides tools to create and manage information about organizations, users, and roles. This folder contains the following forms: ■ Organizational Defaults: This form is used to specify the default values that the organization users should have for certain resources. The organization hierarchy is considered while getting the values specified on the organization defaults by traversing from the bottom of the hierarchy to the top. ■ Policy History: This form is used to view resources that are allowed and disallowed for users through policies. ■ Roles: This form is used to specify which Design Console forms are available for which roles.