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 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 provides 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.

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. 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.
     • Nullable – accepts Null as a valid value.
   • 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.
     • Nullable – the data source column to which the parameter maps accepts Null as a valid input. When the argument is nullable, you can select <NULL> from the drop-down list. You would not select this option for a primary key.

   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 Unwired WorkSpace
  Unwired 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.