Siebel Store-and-Forward Messaging Guide > Administration of Siebel Store-and-Forward Messaging > Process of Configuring Asynchronous Query for Siebel Handheld Applications >

Configuring the Find Object in Siebel Tools

The Find dialog on the handheld device, which contains the functionality for local find and server find (asynchronous query), is configured in Siebel Tools. For information on configuring Find Objects, see Siebel Search Administration Guide.

You start the configuration process by adding a Find object. There are two views for each Find object. One view is rendered when a user performs a local find. The other view is for asynchronous query only and is based on the business object: SHCE Async Query.

When the user taps the Details button in the Asynchronous Query List applet, the Siebel Handheld application identifies the Find object of the highlighted row and renders the view that is related to the SHCE Async Query business object. This view, and its applet, display the asynchronous query results for the Find object.

When the user clicks on the Find button (local find) in the Find dialog, the view that is not related to the SHCE Async Query business object is rendered. The visibility of this view is used for Asynchronous Query as well.

To configure the Find object

1. In the Siebel Tools Object Explorer, click Find, then query for the Find object you wish to enable for asynchronous query.

   If the Find object does not exist, create a new record.

   Some fields of the Find object are explained in the table below:

   Property	Description
   Applet	Describes the applet that is rendered when the user clicks on the local Find button. When a user performs a local find (by tapping the Find button in the Find dialog on the Siebel Handheld application), the user is navigated to the specified applet and a local query is performed.
   Display Name	The name that is displayed in the Find dialog Look In drop-down list. For example, by default the Siebel Service Handheld application contains Orders, Assets, Products, and Solutions.

To add Find fields

1. In the Siebel Tools Object Explorer, click Find > Find Field.

   The available fields in the Field property associated with the business component of the applet specified in the Applet property. For example, the Order-SHCEService Find object uses SHCE Service Orders List Applet - Find. The business component of that list applet is Order Entry - Orders.

   The necessary fields for the Find Field are explained below.

   Field	Description
   Display Name	The name displayed in the Find Dialog Look In drop-down list. For example, the default Siebel Service Handheld contains Orders, Assets, Products, and Solutions.
   Display in Entry	Indicates that the field is available in the Find Dialog when the parent Find Object is selected in the Look In drop-down list. In other words, the user can enter query text for this field.
   Display in Results	Indicates that data is retrieved for this field during an asynchronous query. This property is only relevant for asynchronous query (server find), as the data returned for local find is dictated by the available columns in the applet specified in the Applet property of the Find object.

To add Find views

1. In the Object Explorer, click Find > Find View.
2. Add the view.

   NOTE:  Only two views should be added: one for local find, and one for asynchronous query (server find).

   For Local Find. A view that contains the applet specified by the parent Find Object Applet property should be added. When a local find is performed in the client Find Dialog, the user is navigated to this view. For example, if a local query is done on Orders in the Service Handheld application, the user is navigated to SHCE Service Asset List View - Find, which contains the applet SHCE Service Assets List Applet - Find that was specified in the parent Find Object local properties. Note that the visibility of this view is used by the asynchronous query feature when requesting server information. For example, if the visibility is designated as Personal, then the server query only returns Personal results.

   For Server Find. When a user taps the Asynchronous Query icon in the upper right corner of the screen, the SHCE Async Query List view appears. The SHCE Async Query List view has been configured and is available for use. From the SHCE Async Query List view or applet, the user can highlight a query and tap the Details button. This operation brings up an Asynchronous Query Results view or applet, which should be configured and added into the application. For information on configuring the Asynchronous Query Results applet and view, see Creating the Asynchronous Query Results Applet and Creating the Asynchronous Query Results View.