Creating a Submit Workflow Menu Item

A Submit Workflow menu item allows the user to update, delete, or create data even when not connected to the network. When the user connects, data is automatically sent and received.

The submit workflow menuitem of the first screen in mobile workflow forms editor must be associated with a mobile business object (MBO) operation or an invoke parent update.

If the user has multiple screens open at the time of the submit execution, and one of the underlying screens fails validation, the user is prompted with the configured warning message and the submit process stops.

  1. From the palette on the Screen Design page, click MenuItem, then click the Menu box.
  2. Select the new menu item.
  3. In the Properties view of the menu item, configure the properties for the submit 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 submit menu item.
    Default Select to display the menu item prominently on the screen.
    Type Select Submit Workflow.
  4. If the menu item is an operation associated with a mobile business object, you can configure these properties in Details:
    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.

    Submit confirmation message (Optional) Enter text to show in a message box on the screen when the submit operation finishes successfully.
    Resubmit confirmation message If the option Mark message as processed after processing is enabled in the Flow Design page properties, show the resubmit confirmation message if the user attempts to submit the workflow after it has already been previously submitted.
    Error screen The screen to which the user navigates in case an asynchronous operation invocation fails. Select an existing screen, or click Generate Error Screen to create a new one.

    If no error screen is specified, the client application receives no notification of the failure — failures appear only in the log files.

    Subject If an error occurs, a notification is sent to the device with the appropriate error log keys and specified Subject.
    Note: The subject can reference the screen name and action name using macros (except in server-initiated workflows). For example:

    "An error occurred trying to perform the ${action} action on the ${screen} screen.

    From When an error occurs and the notification appears in the inbox, the comment appears in the From field of the notification.
    Note: The subject can reference the screen name and action name using macros (except in server-initiated workflows). See the Subject example.
  5. Select File > Save.