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

Creating the Asynchronous Query Results Applet


Once the Find object has been configured, it is necessary to create the applet that is used to display the results to the user. When the user clicks the Server Find button in the Find dialog box, a record is added to the SHCE Async Query business component, and can be viewed in the SHCE Async Query List view by clicking the Asynchronous Query icon. The Asynchronous Query icon is only visible when Store-and-Forward Messaging is enabled. See Using Asynchronous Query with the Siebel Service Handheld Application for an example. When the server returns the results of the asynchronous query, they are placed in the SHCE Async Query Results business component, which is a child of SHCE Async Query business object. The user can access these results by tapping the Details button in the SHCE Async Query List view.

To create an applet to display asynchronous query results

  1. Create a new list applet, or copy an existing Asynchronous Query Result applet, such as SHCE Service Async Query Results Asset List applet.

    The new or copied applet must have the following attributes:

    • The applet must be a list applet.
    • The business component property must be SHCE Async Query Results. In other words, all results applets are based on this business component.
    • This applet should have the following fields checked:
      • No Insert
      • No Delete
      • No Update.
    • When mapping applet fields to business component fields (Data 1, Data 2, ... Data 6 of SHCE Async Query Results) it is necessary to make sure that the business component field corresponds the correct Find object field. Returned asynchronous query results are populated in sequence of the Find object fields that have the 'Display in Results' flag set. In other words, Data 5 maps to the 5th find object field with the flag. See the following example:
      Find Field Name
      Sequence Number
      Display in Results
      Display in Entry
      Data Column Map

      A

      0

      Y

      Y

      Data 1

      B

      1

      Y

      N

      Data 2

      C

      2

      N

      Y

      None (not displayed)

      D

      3

      Y

      Y

      Data 3

      E

      4

      Y

      Y

      Data 4

      F

      5

      N

      Y

      None (not displayed)

      G

      6

      Y

      N

      Data 5

  2. Use the Edit Web Layout feature in Siebel Tools to configure the user interface.

    This determines the order the query result columns appear in the user interface.

Siebel Store-and-Forward Messaging Guide