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
   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 RFC 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/RFC 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 Refresh in the Search dialog to refresh the SAP data source and display current BAPIs/RFCs. This is only necessary if there is a change to the data source and need to display the current BAPIs/RFCs. 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 credential and connection properties	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 provide access. You can also set default values, or use personalization keys for all JCo connection properties.
   Result checker	Optionally add a result checker to the MBO. A result checker is a custom Java class that implements error checking for mobile business objects (MBOs). See Adding a Result Checker.
   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.
   Refresh	(Optional) Select Refresh to refresh the parameters for the selected BAPI operation. Any changed parameters are decorated with an asterisk "*" at the beginning of the name. This is required only if there is a change to the BAPI.

3. Click Finish to use default mappings, or Next to modify the columns to attributes mapping, or parameter mapping.
4. From the Parameters page you can configure these MBO argument properties that are modeled from the data source's remote operation argument:
   • Argument – the MBO argument name
   • Datatype – datatype of the argument

     The datatype of a data source column is read-only, and changes only if the Map to column changes.

   • Nullable – identifies if NULL is a valid value
   • Default value – the default value, if any, of the MBO argument

   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.
• Configuring the SAP AutoCommit Feature
  Configure an SAP operation, so commit is always called after the operation succeeds.
• Modifying SAP Connection Properties
  Use SAP connection properties as mobile business object (MBO) parameters when making connections from an SAP MBO to an enterprise information system (EIS).
• Modifying SAP BAPIs that Contain Namespaces so they are Valid In SAP Mobile WorkSpace
  SAP Mobile WorkSpace does not allow a structure datatype to contain names with special characters (a forward slash ‘/’ in this case), because the forward slash is used as a Java class name after deployment and code generation.