Operations APIs

Mobile business object operations are performed on an MBO instance. Operations in the model that are marked as create, update, or delete (CUD) operations create instances (non-static) of operations in the generated client-side objects.

Any parameters in the create, update, or delete operation that are mapped to the object’s attributes are handled internally by the Client Object API, and are not exposed. Any parameters not mapped to the object’s attributes are left as parameters in the Generated Object API. The code examples for create, update and delete operations are based on the fill from attribute being set. Different MBO settings will effect operation methods.

Note: If the Sybase Unwired Platform object model defines one instance of a create operation and one instance of an update operation, and all operation parameters are mapped to the object’s attributes, then a Save method can be automatically generated which, when called internally, determines whether to insert or update data to the local client-side database. In other situations, where there are multiple instances of create or update operations, it is not possible to automatically generate such a Save method.

Create Operation
To execute a create operation on an MBO, create a new MBO instance, set the MBO attributes, then call the save() or create() operation.
Update Operation
To execute update operations on an MBO, get an instance of the MBO, set the MBO attributes, and then call either the save() or update() operations.
Delete Operation
To execute delete operations on an MBO, get an instance of the MBO, set the MBO attributes, then call the delete() operation.
Save Operation
When called, the Save method determines internally if it should insert or update data to the client database.
Other Operation
Operations that are not create, update, or delete operations are called “Other” operations. An Other operation class is generated for each operation in the MBO that is not a create, update or delete operation.
Multilevel Insert
Multilevel insert allows a single synchronization to execute a chain of related insert operations.
Pending Operation
You can manage pending operations using these methods:
Passing Structures to Operations
Structures hold complex datatypes (for example a string list, class or MBO object, or a list of objects) that enhance interactions with certain enterprise information systems (EIS) data sources, such as SAP and Web services, where the mobile business object (MBO) requires complex operation parameters.

Parent topic: BlackBerry Client Object API