Search dialog definition

<searchDialog> </searchDialog>

The primary element defining a search dialog. The following attributes are supported:

resourceBundle: Required: Resource bundle to be used throughout the entire Search Dialog. For example, samples.samplesNLS

<criteriaPanel> </criteriaPanel>: Panel to define the criteria fields and its dictionary.

databean: Optional: A fully qualified name of a user criteria data bean to provide data definitions on the criteria panel. For example, com.ibm.commerce.tools.test.SampleSearchCriteriaDataBean.
title: Required: Title that displays on criteria panel. For example, searchTitle.

description

Optional: Description of the Search Dialog's function. For example, searchDesc.

<jsFile/>: External JavaScript file to be included in the Search Dialog. Files defined here are included in the parent frame. Thus, access to these functions require parent. prefixed to function calls to scope them to the parent frame. Multiple instances of this tag are allowed.

src: Required: Location of the JavaScript file. For example, /wcs/javascript/tools/samples/sampleSearchDialog.js.

<jsMessage/>: NL enabled message to be used in JavaScript.

name: Required: JavaScript variable name to hold the message. For example, missingFieldMsg.
resourceKey: Required: The resource key name used to retrieve the message from the resource bundle. For example, missingFieldMsg.

<field></field>: Criteria field to be displayed on the criteria panel.

type: Required: The criteria field type. Supported values are hidden, text, select-one, select-multiple, checkbox, radio, and calendar.
name: Optional: The HTML form input name to represent this criteria field. For example, productNumber.
value: Optional: The HTML form input value for this criteria field. For example, sports0001.
size: Optional: The HTML form input size for this criteria field. This field is valid only when the type specified is text. For example, 50.
maxlength: Optional: The HTML form input maxlength for this criteria field. This field is valid only when the type specified is text. For example, 50.
resourceKey: Optional: The resource key name used to display the field name that describes the criteria field. For example, productNumber
beanMethod: Optional: A Java method name in the databean defined in the <criteriaPanel> element. The Tools Framework invokes this method, and expects it to return a String for the hidden field type, and Hashtable for field types select-one, select-multi and radio. For example, getMessage.

<operatorBox></operatorBox>: A selection box to represent matching operator. Only applies to the <field> element.

name: Required: The HTML form selection box name to represent this operator. For example, productNumberOp.

<operator/>: An operator entry in the operator selection box. Only applies to the <operatorBox> element.

value: Required: The HTML form select option value for this operator. For example, EQ
resourceKey: Required: The resource key name used to display the text for this operator. For example, exactMatch

<checkbox/>: A check box entry field. Only applies to the <field> element if its field type is checkbox.

name: Required: The HTML form check box name for this field. For example, displayNum
value: Required: The HTML form check box value for this field. For example, 20.
resourceKey: Required: The resource key name used to display the text for this check box. For example, numToDisplay.

<yearField/>: 4-digit year entry field. Only applies to <field> element if its field type is calendar.

name: Required: The HTML form input name for this year field. For example, startDateYear.

<monthField/>: 2-digit month entry field. Only applies to <field> element if its field type is calendar.

name: Required: The HTML form input name for this month field. For example, startDateMonth.

<dayField/>: 2-digit day entry field. Only applies to <field> element if its field type is calendar.

name: Required: The HTML form input name for this day field. For example, startDateDay.

<resultPanel/>: Panel to define the search result page.

url: Required:The URL to display the search result page. For example, /webapp/wcs/tools/servlet/NewDynamicListView?ActionXMLFile=samples.sampleSearchResult&cmd=ResultList
target: Optional: The target frame that the URL should be displayed on. By default, it is the dialog's content frame. For example, mcccontent
navigationPanelXML: Optional: A customized XML file for Search Dialog's navigation panel. You can customize buttons and actions according to a dialog's XML file. This attribute will only be effective if the default target frame is not changed. For example, samples.sampleSearchDialogRefine

Example

The following example defines a search dialog.


<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE searchDialog SYSTEM "../common/SearchDialog.dtd">
<searchDialog resourceBundle="samples.samplesNLS">
   <criteriaPanel databean="com.ibm.commerce.tools.test.SampleSearchCriteriaDataBean"
         title="searchTitle" description="searchDesc">
 
      <jsFile src="/wcs/javascript/tools/samples/sampleSearchDialog.js"/>
 
      <jsMessage name="invalidCharMsg" resourceKey="invalidCharMsg"/>
      <jsMessage name="missingFieldMsg" resourceKey="missingFieldMsg"/>
 
      <field type="hidden" name="secret" value="password"/>
      <field type="hidden" name="messageFromServer" beanMethod="getMessage"/>
 
      <field type="text" name="productNumber" resourceKey="productNumber" size="50" maxlength="50">
         <operatorBox name="productNumberFilter">
            <operator resourceKey="equals" value="EQ"/>
            <operator resourceKey="greater" value="GT"/>
            <operator resourceKey="less" value="LT"/>
         </operatorBox>
      </field>
 
      <field type="select-multiple" name="manufacturer" resourceKey="manufacturer" 
            beanMethod="getManufacturer"/>
 
      <field type="text" name="shortDesc" resourceKey="shortDesc" size="50">
         <operatorBox name="shortDescOperator">
            <operator resourceKey="exactMatch" value="EQ"/>
            <operator resourceKey="containsPhrase" value="LIKE"/>
         </operatorBox>
      </field>
 
      <field type="select-one" name="store" resourceKey="store" beanMethod="getStore"/>
 
      <field type="radio" name="displayNum" resourceKey="displayNum" beanMethod="getDisplayNum"/>
 
      <field type="checkbox">
         <checkbox name="includeBundle" value="true" resourceKey="includeBundle"/>
         <checkbox name="includePackage" value="true" resourceKey="includePackage"/>
      </field>
 
      <field type="calendar" resourceKey="startDate">
         <yearField name="startDateYear"/>
         <monthField name="startDateMonth"/>
         <dayField name="startDateDay"/>
      </field>
 
      <field type="calendar" resourceKey="endDate">
         <yearField name="endDateYear"/>
         <monthField name="endDateMonth"/>
         <dayField name="endDateDay"/>
      </field>
   </criteriaPanel>
   <resultPanel url="/webapp/wcs/tools/servlet/tools/samples/DumpRequest.jsp"
         target="mcccontent" navigationPanelXMLFile="samples.sampleSearchDialogRefine"/>
</searchDialog>