Menu Item and Custom Action Properties

The Properties view shows properties for a selected item in the menu custom action box on the Screen Design page.

General

Property Description
Name Enter a valid name for the menu or custom action.
Note: To avoid wrapping of menu item names on Apple iOS devices, keep the name length to 10 or fewer characters.
Key Select the key with which to bind the item.
Default For a menu item, select to display the menu item prominently on the screen.
Type
  • Save screen – closes the current screen, validates the current input and, if validation succeeds, saves it.
  • Cancel screen – discards any changes on the current screen and closes it. No validation occurs.
  • Close workflow – discards any changes on any open screens and closes all open screens. No validation occurs.
  • Open screen – opens a different screen.
  • Online request – creates a synchronous call to the server, validates the data input on all open screens, saves it, sends it to the server and waits for a response from the server before continuing.
  • Submit workflow – creates an asynchronous call to the server, validates the data input on all open screens, closes the application, and sends the data to the server. You cannot use a Submit workflow action to invoke an operation on a nested, or child, element.
  • Select certificate – opens a dialog where the user can choose a certificate to use for the credentials.
  • Create key collection – opens the specified screen in the context of addng a new key collection to the list key bound to the list view.
  • Add/Update/Delete Key Collection – adds, updates, or deletes a key from a key collection from a list key bound to a Listview control. These operations are not invoked immediately, but are instead invoked when a Submit operation is made on the parent MBO to which this MBO is related. A key collection can be added only to screens that are navigated to as the result of a Listview details navigation, for example, by clicking a row in a Listview.
  • Custom – write your own custom code that dictates its behavior.
Details You can configure actions in the Details section. The properties available depend on the action type. See the topics for configuring the different menu or custom action types for information about configuring these properties.

Use the Parameter Mapping section to bind the parameters (if any) of an operation or object query to keys or, context data, such as DeviceName, BackEndPassword, BackEndUser, and so on.

For information about these parameters and how they map to MBO operations and queries, please see WorkflowClient.xml File in Sybase Unwired WorkSpace - Mobile Workflow Package Development.

Personalization Key Mappings

If you have a mobile business object with load parameters mapped to transient personalization keys, you can specify values for those personalization keys when you invoke an operation or object query from the Mobile Workflow package. This can, for example, be useful for loading only specific data into the consolidated database from large data sources.

Output Keys

Lists the keys of which values will be filled by the server and returned to the client. Output keys are used only with an Online Request menu or custom action type.