Choice List Version 2.0.0.0Print this Page
Saved Searches Pattern Set
 
Description Return to Top

A saved searches choice list placed above a table enables users to select from a list of available saved searches and personalize the list of saved searches. Showing the saved searches region enables users to view search criteria and create new saved searches. The saved searches region can be expanded in place or displayed in a dialog box. A saved search can change:

  • Search and filter criteria
  • Hidden and shown columns
  • Column order
Selecting a saved search does not change the object in the table.

 
Pattern Set Decision Table Return to Top
  Choice List Tab Equivalents Saved Searches Submenu
Will the user frequently switch between saved searches? Yes Yes No
Must the saved search selector always be visible? Yes Yes No
Must all saved searches be visible concurrently? No Yes No

 
Pattern Sample Return to Top
Search Criteria in Expandable Region

This pattern can be implemented by running Application Development Framework (ADF) Query in Compact mode with the search panel collapsed by default. In this case, the user sees a choice list containing the list of saved searches and the Personalize (Saved Searches) option by default and can optionally expand the query panel to display the search criteria and button bar.

When the user selects a saved search from the choice list above the table, the search criteria are updated and the new search should be run. The list of saved searches is presented in alphabetical order, followed be a separator and Personalize command as described in the Search and Query Usage guideline.

A manual View, Refresh command must be placed in at the bottom of the View menu following a separator, and a Search icon button must be placed on the toolbar whenever a saved searches design pattern is used. This is so users can run saved searches that have Run Automatically set to False when the search panel is hidden. Run Automatically must be set to True for all seeded saved searches when this design pattern is used.

Saved Search choice list
Figure 1. A View, Refresh command and a Search icon button

To view search criteria and create new saved searches, the user must first expand the query panel by clicking the Disclosure icon button beside the choice list. The user can also select the redundant View, Search Criteria menu item. This expands the search region to display the search criteria and Save button.

Search region expanded
Figure 2. The Disclosure icon button and the View, Search Criteria menu item

The Create and Personalize Saved Searches dialog boxes are provided by the query component.

Save dialog Personalize dialog
Figure 3. Create and Personal Saved Searches dialog boxes
Search Criteria in a Dialog Box

If the search region should not expand in place due to page complexity (the need to re-layout a complex page) or limited screen real estate, teams can hand code the saved searches choice list. In this case, the View, Search Criteria menu item launches a dialog box containing the search region. See the Saved Searches Submenu design pattern.

If this variant of the Saved Searches: Choice List design pattern is used, ADF Query is placed in the dialog box in Compact mode. ADF Query's Create Saved Search and Personalize Saved Searches dialog boxes are launched from the Search Criteria dialog box. The choice list above the table is not part of ADF Query.

Note that this design pattern uses the Save and Personalize dialog boxes provided by ADF Query. Teams can optionally hand code a Personalize Saved Searches dialog box and launch it from the View menu if the users are unlikely to realize that Show Search Criteria also enables them to personalize saved searches. The Create Saved Searches dialog box must be launched from the Search Criteria dialog box so that users can view and edit the criteria for their new saved searches.

Search region in dialog
Figure 4. View and edit criteria for new saved searches
Required Screen Elements
Component Type Required Components Customizable or Extendable Components
Choice List
  • Prompt
  • Choice List

Personalize option

Separator between saved search names and Personalize option

Disclosure Icon Button Disclosure icon button Disclosure icon button
Table Toolbar

Manual Refresh toolbar button

NA

View Menu
  • Manual Refresh menu item
  • Search Criteria menu item

Personalize Saved Searches menu item

 
Related Patterns Return to Top
Transactional Search Patterns for searching for objects in Oracle Fusion.
Table Filters A pattern set used when a filter is needed on a table. A filter changes rows, but not columns.
 
Related Guidelines Return to Top
Search and Query Usage guideline Section on Saved Searches describes usage of the ADF Query Saved Search.
 
About Oracle | Legal Notices | Terms of Use | Your Privacy Rights