Binding a Mobile Business Object to a Web Service

Bind the attributes and operations of a mobile business object to a Web service.

1. In the Mobile Application Diagram, right-click the MBO, and select Detailed Properties.
2. In the Mobile Business Object Properties dialog, select the General tab, and verify that the Syncable property is checked.
3. Select the Connection tab, then define the connection details:
   1. To the right of the Connection field, click Select.
   2. Select Define Connection Now, then select Web Service as the Connection Type.
   3. For the Connection Name, either select the name of an existing Web service connection, or click New and create a new connection. Click OK.
   4. If the Web service requires Basic HTTP Authentication, specify:
      
      • Password type – Text or Digest.
      • User name – user log-in name.
      • Password – password for the user name.
   5. If the Web service requires that a method be called each time the MBO connects to the Web service, select the Login Method.
4. To map Web service operations to MBO operations and attributes, the Web service response message is converted to a tabular format. To define the XSLT that is used for converting the response messages, you can either generate the XSLT or define it manually.
5. Select the Mapping tab, and map the MBO attributes to the Web-service data columns.
   Note: Each Web-service data row corresponds to a different MBO instance, and each column corresponds to a different MBO instance's attribute value.
6. To map MBO parameters to Web-service arguments, select the Parameters tab.
7. For each parameter that you want to map, specify:

   Option	Description
   Name	Parameter name. Note: Parameter names cannot contain C# or Java reserved words.
   Datatype	Parameter datatype.
   Default Value	Default parameter value.
   Argument	Web service argument name.
   Datatype	Datatype of the Web service argument.
   Default Value	Default argument value.
   Filter By	Define the argument as a field that can be used to filter the results that are downloaded to mobile devices.
   Personalization Key	If you select Filter By, you can select a personalization key to map to the argument, which provides an argument value.

8. On the Summary page, review the MBO configuration. To save the values and exit, click Finish. To change any values, click Previous to go back to the configuration page.

• Generating XSLT
  Generate the XSLT that is used to convert a Web service response message to a table format, and define which parts of the message to keep.
• Defining the XSLT Manually
  Define the XSLT that is used to convert a Web service response message to a table format, and define which parts of the message to keep.