Mobile Business Object Properties

Modify mobile business object properties from the Properties view.

Mobile Business Object Properties
Tab Contents
General
  • Name – the name of the mobile business object (MBO).
  • Comment – describes the mobile business object.
  • Generate metadata options – select to generate the metadata class for the corresponding MBO attributes and operations. This option is unselected by default. Generate metadata when you want to further customize generated MBO code. There are also Generate metadata options in the Code Generation wizard. If selected, those options override the MBO level options.
Attributes
If the mobile business object attributes are bound to a data source, the contents of the Attributes tabs include:
  • Data Source – information about the data source from which the attributes are derived and bound. Select Change Connection Profile to change the connection profile of the same data source type, or Bind Data Source to bind or rebind the mobile business object to a data source of any supported type.
  • Definition – displays the defined attributes and any runtime credential/authentication requirements, which vary depending on the data source type. Select Edit to launch the Change Definition dialog and modify the definition. You can also create a resultset filter skeleton or add an existing resultset filter class. Select Preview to preview the mobile business object.

    Result Set Filters shows resultset filters and their paths.

  • Load Arguments – see Adding a Load Argument for details.
  • Attributes Mapping – Includes:
    • Attributes
      • Name – name of the attribute.
      • Datatype – attribute datatype
      • Nullable – a Null value for the attribute is valid.
      • Primary key – analogous to a relational database table's primary key, when set, MBO data can be searched/found using the attribute's value.
        When set, a findByPrimaryKey object query is generated by default, and the generated device client code contains FindByPrimaryKey methods (along with associated parameters and return types). At runtime, FindByPrimaryKey methods return a collection of objects that match the specified search criteria defined in the object query.
        Note: The SAP Mobile Server cache database (CDB) does support identical rows. If a SQL query statement generates identical rows, the CDB identifies and stores one unique row, resulting in only one row displaying on the device after synchronization.
    • Data Source
      • Map to – data source column to which the corresponding attribute is mapped.
      • Datatype – data source column datatype to which the corresponding attribute is mapped.
      • Nullable – select this option only for enterprise information system (EIS) arguments that support NULL as a valid value.
        Note: For SAP and Web service data sources, the Nullable and Datatype columns are read-only. You cannot change them, instead, SAP Mobile WorkSpace correctly identifies and sets them from the back-end data source. But for a JDBC data source, SAP Mobile WorkSpace may not be able to correctly identify the Datatype and nullability, so you need data source knowledge to correct them if needed.
    • Click Refresh to refresh the metadata (parameters and columns). Use the Add, Delete, Delete All buttons to remove attributes.

    • Click Remap to automatically generate new mappings for unmapped attribute columns based on metadata changes of the data source to which the mobile business object (MBO) is bound.

    • Show figure button – when selected, the visual display of the attribute to tabular view column mapping displays.
  • Roles – lists all logical roles assigned to the mobile business object along with all available roles. Use Add and Add All to move available roles to assigned roles, and Remove and Remove All to remove roles from a mobile business object (or double-click a role to add or remove it). Select Create to define a new role.
  • Object Queries – displays the auto-generated object queries based on which attributes are primary key attributes. Also allows you to add, edit, or delete object queries. See Object Queries for details.
  • Share – lists MBOs and data source bindings for any attributes that share an EIS read operation. Using Delete and Delete All deletes the shared-read MBO.
Operations

Lists all operations defined for the mobile business object. Select Add to define a new operation, highlight an existing operation and select Edit to modify an existing operation, or use Delete and Delete All to remove operations.

Select Bind to bind an operation to a data source, or Rebind to change an existing binding to a different data source. See Mobile Business Object Operation Properties for details.

Relationships

Lists all relationships defined between this and other mobile business objects. Select Add to define a new relationship, highlight an existing relationship and select Edit to modify an existing relationship, or use Delete and Delete All to remove relationships.

Synchronization Define various synchronization aspects of the MBO from the Advanced Developer profile. See Defining Synchronization Properties for Individual Mobile Business Objects.
Appearance

Modify certain look-and-feel aspects of the mobile business object from the Advanced Developer profile.

Related concepts
Entity Read Operations
Defining Output Mappings
Composite Operations
Related tasks
Creating Attributes for a Mobile Business Object
Creating Operations for a Mobile Business Object
Creating the Mobile Business Object using the Mobile Business Object Palette item
Previewing Mobile Business Objects
Modifying Load Arguments