Oracle JHeadstart Developer's Guide - Downloads - Oracle

7.2.3. Using Advanced Search
7.2.4. Using a Query Operator
Again, there are two possibilities when generating Advanced Search functionality:
1. The Search region is in the same page as the rest of the group
2. The Search region is in a separate page.
You control this by setting the Advanced Search? property.
There are several properties that will affect the layout of the Advanced Search Region:
1. The Form Width property indicates the width of the Search Region. The default
value is 10% which will left align the items. If you set the value to a higher
number the items will be located further to the right on the page.
Attention: If you use the Form Width property when generating a
search region for a page of Form layout, this property value will
impact the layout of both the search region and the main form page.
2. The Advanced Search Layout Columns property indicates in how many
columns you want to display your items. By default all the items will be
displayed in one column.
3. Regions of the group. If the items you included in the Advanced Search, are also
included in a region, then by default a region will also be applied to the
advanced search area.
Attention: If you don’t want to apply the group regions to the
advanced search area, you can use a variation on the template
default\search\advancedSearchRegion.vm. Comment out the 3
lines just below the comment ‘Optional RegionContainer…’ by
putting ## in front of each line, and uncomment the 3 lines below
the comment ‘Use the following code instead…’ by removing the ##
in front of each line. Then put those 3 lines instead of the
#ADVANCED_SEARCH_ITEMS() call within the panelForm above. See
the comments in the template, and see the section Using Generator
Templates.
On item level the Query Operator can be set. This operator determines how to query the
data. Examples are contains, endsWith and greaterThan.
By default, the ‘StartsWith’ operator is used for String items. In all other cases the
equality operator is used.
You can change this behavior by setting the Query Operator property for an item. See
the help in the Application Definition editor for possible values of this operator.
A special case is the value ‘setByUser’ for the Query Operator. ‘setByUser’ means the
user of the application can at runtime choose the operator to be used.
1. Set the Query Operator property to ‘SetByUser’.
2. Generate the application
3. Go to the ‘Advanced Search’ region in the generated application. You will see
something like this:
JHeadstart Developer’s Guide Generating Query Behaviors 7 - 9