Creating an Online Request Menu Item

Create an online request menu item for synchronous calls to Unwired Server, which means the device client waits for a response from the server.

1. From the palette on the Screen Design page, click Menuitem, then click the Menu box.
2. In the Properties view, select the menu item for which to configure the properties.
3. In the Properties view, configure the properties for the online request menu item:

   Property	Description
   Name	Enter a valid name for the menu item. 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 online request menu item.
   Default	Select to display the menu item prominently on the screen.
   Type	Select Online Request.

4. If the menu item is an operation associated with a mobile business object (MBO), you can configure these properties in the Details section:

   Property	Description
   Mobile business object	The MBO with which the menu item is associated. Click Search to locate the MBO.
   Invoke parent update	No changes are made to the parent MBO, but the appropriate operations (create, update, delete) are performed on its descendants.
   Invoke operation	Invoke the selected MBO operation with which the menu item is associated. Select the operation from the list, which is populated when you select the MBO.
   Invoke object query	Invoke the object query from the menu item.
   Generate old value keys	By default, this is selected, which means old value keys are generated. If you need the old value keys for update or parent update operations, you should leave this selected. If you unselect it, old value keys will not be generated.
   Show credential screen on authentication failure	If selected, the credential screen is shown when authentication fails. If unselected, the authentication failure is treated the same as other types of failures.
   Submit error message	Enter the message the user sees if there is an error during the submit operation. When an operation is invoked, the user can receive any error messages that may occur on the client application. The error messages are a single key of the List type, with a single key of the String type as its child. Each child instance corresponds to an error message.
   Timeout	Enter the allowed amount of time, in seconds, to wait for the server to respond before timing out and giving an error message.
   On device cache timeout	Represents the time, in seconds, that query results are cached on the device. If the same query is made with the same parameter values within the specified timeout, the results are pulled from the device cache and no call to the server is made.
   Error screen	The screen to go to if there is an error when submitting the data to the server. Click Generate Error Screen to automatically generate error screens.
   Success screen	Choose the Default Success Screen from the drop-down. This is the screen to go to upon successful communication with the server. Click Add to add a conditional navigation screen. A conditional navigation adds a callout during Mobile Workflow package generation to the customConditionalNavigation function, which returns a boolean. Each piece of custom logic is evaluated, in order, one at a time, and when the first condition comes back as true, the user is navigated to the matching screen for that condition.

5. (Optional) Click Parameter Mappings to define the keys to map to parameters.
   You see the parameters defined for the MBO and used to generate the object query. In addition to Key, you can map parameters to BackEndPassword, BackEndUser, DeviceId, DeviceName, DeviceType, UserName, MessageId, ModuleName, ModuleVersion, and QueueId.
6. (Optional) Click Personalization Key Mappings to select a personalization key and the key to which it maps.
   You can also fill the personalization key values from values extracted from the notification, depending on from where you are invoking the object query.
7. (Optional) Click Output Keys to view the keys that will be created and populated based on the selected action.
8. Select File > Save.