Binding an SAP Data Source to a Mobile Business Object

Bind the attributes and operations of an SAP object or Business Application Programming Interface (BAPI) to a mobile business object.

1. In the Bind Data Source wizard, enter the following information and click Next:

   Field	Action
   Specify a data source	Select and bind to a data source.
   Data source type	Select SAP.
   Connection profile	Select the SAP connection profile to which you are binding your mobile business object attributes/operations. If the required data source is not in the list, click Create to define a new connection profile.

2. Enter the SAP definition information. You can bind attributes and operations using this screen.

   Field	Action
   Method definition	Browse for the BAPI or RPC operation from which the attribute or operation is bound. Once selected, the wizard automatically retrieves the meta data (for example, parameters, and input/output tables of the specified BAPI/RPC operation) and builds models for the MBO instance in the table definition. If you select Browse, the wizard displays a tree that represents the data source from which you can access the BAPI or operation. You can enter text to filter specific SAP business objects, or use the Search BAPIs/RFCs dialog box. Once you select the business object of interest, the associated BAPI operations are listed in the table. Select the operation and click OK.
   Parameters definition	Select the parameters, structure, input tables, or output tables of the BAPI operation and choose one or more table (or columns inside the tables), or output parameters to be mapped as mobile business object attributes.
   Runtime data source credentials	If the data source is protected, and if the user name and password (data source access credentials) are different than the selected connection profile, you need to enter the User Name and Password that provides access.
   Result set filters	Optionally add a result set filter to the MBO. A result set filter is a custom java class that manipulates the rows or columns of data returned from a read operation for an MBO. To write a filter, developers must have previous experience with Java programming — particularly with the reference implementations for javax.sql.RowSet, which is used to implement the filter interface. See Result Set Filters.
   Preview	Click Preview to preview the newly defined mobile business object attributes.

3. Click Finish to use default mappings, or Next to modify the columns to attributes mapping, or parameter mapping.
4. The Parameters Mapping screen provides a graphical view of the parameter-to-remote operation mappings. Modify the default parameter mappings by using Add, Delete and Delete all. Rearrange parameters using Up and Down. Make a connection between parameters by dragging a line from the source to the target. Parameter properties include:
   
   

   • Parameters
     
     • Parameter name – name of the mobile business object parameter. Names cannot contain C# or Java reserved words.
     • Datatype – enter the datatype of the parameter. It must be compatible with the datatype of the remote parameter to which it is mapped.
     • Required – The parameter is required. For example, a deployed MBO that contains user name and password parameters would require this information be supplied by the client.
   • Data Source
     
     • Argument – include any arguments to be passed to the parameter used by the MBO operation on the Unwired Server side when executing an MBO operation.
     • Datatype – displays the datatype to which the parameter is mapped.
     • Default value – enter a default value for the argument, or select <no default value> from the drop-down list. NULL is not supported for MBOs that use SAP as the backend data source.

   Click Next or Finish when done.

5. The Attributes Mapping screen provides a graphical view of the columns to table mappings. You can collapse and expand the view and click the navigational buttons to rearrange attributes, remove and add individual attributes, and remove a mapping or all mappings. Click Next or Finish when done. You can remove mappings without removing associated attributes from the graphical view only.
6. The Role Assignments screen allows you to Create, Add, and Remove role assignments from the mobile business object. Click Finish when done.

• Searching for SAP BAPIs and RFCs
  Use regular expression pattern matching to locate SAP BAPIs and RFCs from the Search BAPIs/RFCs dialog box.