14.01.2013 Views

Oracle JHeadstart Developer's Guide - Downloads - Oracle

Oracle JHeadstart Developer's Guide - Downloads - Oracle

Oracle JHeadstart Developer's Guide - Downloads - Oracle

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

7.2. Creating a Search Region<br />

7.2.2. Using Quick Search<br />

In most cases, you want to give the end-user some query functionality to search for rows<br />

with specific values and reduce the number of rows. This section describes how to do<br />

that.<br />

<strong>JHeadstart</strong> is able to generate two distinct ways of search functionality:<br />

1. Quick Search: The search region is placed on top of the generated page.<br />

Typically you can only search on one field at a time. Range queries are not<br />

supported with quick search.<br />

2. Advanced Search. The search region can be on top of the page or in a separate<br />

page. The user can search on multiple fields together. Range queries are<br />

supported.<br />

Suggestion: You can use both options together. For example: a Quick Search<br />

for the most frequently used selection, and an Advanced Search for less<br />

frequently used selections. In that case the Quick Search will be shown by<br />

default, with a button to go to the Advanced Search region.<br />

Before generating a Quick Search or Advanced Search page, you have to make some<br />

preparations:<br />

7.2.1.1. Determine which items should be displayed in the Search Region<br />

You need to review each group and identify items that should not logically be queriable.<br />

If requested to generate search functionality, the <strong>JHeadstart</strong> Application Generator needs<br />

to know what the queriable items are. You can set the Include in Quick/Advanced<br />

Search properties for each item in a group. Both properties are default true.<br />

1. Select an item in the Application Definition Editor.<br />

2. Check or uncheck the Include in Quick/Advanced Search properties.<br />

To generate a Quick Search region for a group, you have two choices:<br />

1. The item used for searching is always the same. Give the Quick Search?<br />

property the value singleSearchField. Select the search item in the Single or<br />

Default Search Item property.<br />

2. You want the user to be able to select the items to search on. Set the Quick<br />

Search? property to ‘dropdownList’. <strong>JHeadstart</strong> will populate a dropdown list<br />

with item names so the user can select the item to query on. Only queriable items<br />

are shown in the list (see previous section). The default item is specified by the<br />

Single or Default Search Item property.<br />

You can also completely disable Quick Search by setting Quick Search? to ‘none’.<br />

7 - 8 Generating Query Behaviors <strong>JHeadstart</strong> Developer’s <strong>Guide</strong>

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!