Adding a Parameter to a Mobile Business Object

Add a parameter to a mobile business object (MBO) from the Properties view.

Parameters correspond to synchronization parameters on the mobile client and map to data source arguments. You can use MBO parameters to synchronize and filter data that is returned to the mobile device from the back-end data source. If you drag and drop a datasource or otherwise create MBO attributes that automatically generates attribute parameter-to-argument mapping, steps 1–3 are optional.

  1. In the Mobile Application Diagram, right-click the MBO, and select Show Properties View.
  2. In the Properties view, select the Attributes tab, then select the Parameters tab.
  3. Click Add. A new parameter is created with the default name of "parameter1." The next parameter you create is called "parameter2," and so on.
  4. Define the parameter and map it to a data source argument.

    For each parameter, specify:

    Option Description
    Parameters  
    Parameter name Name of the mobile business object parameter. Names cannot contain C# or Java reserved words.
    Datatype Select the parameter datatype from the drop-down list. Datatypes include string, date, int, datetime, decimal, and so on and map to the data source's datatype.
    Required Indicates that the parameter is required. For example, a primary key of a database. In an MBO this could be a user id which a client would be required to provide.
    Data Source  
    Argument Data source argument name to which the parameter is mapped.
    Note: Parameters must be mapped to a datasource arguments.
    Datatype Datatype of the data source argument to which the parameter is mapped.
    Default Value The default value for the argument, or select <NULL> or <no default value> from the drop-down list. NULL is not supported for MBOs that use SAP as the backend data source.
    Advanced Unselecting Hide advanced columns displays these columns, and allow you to edit their properties
    Personalization Key (Optional) If you select Filter by, you can select a personalization key to map to the parameter, which provides an argument value. For example, you can create and specify the "state" personalization key, and return values that match a specific value, such as "California".
    Filter by (Optional) Define the parameter as a field that can be used to filter the results that are downloaded to mobile devices based on the value.
    Fill from attribute (Optional) Select an attribute from the drop-down list to use its' value for that of the parameter.
    Show/Hide figure Once a parameter is defined, select Show figure to view a graphical representation of the parameter-to-datasource argument mapping. You can modify the mapping by dragging the connector line from the parameter to a different argument, which automatically updates the datatype to that of the argument.


Created September 17, 2009. Send feedback on this help topic to Sybase Technical Publications: pubs@sybase.com