Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Flow processing in offline mode

Updated on February 23, 2022

With correctly configured flows that create cases, users can complete assignments, even when an offline-enabled mobile app is not connected to a network. With the following guidelines, you can ensure that your offline-enabled mobile app operates reliably.

When you design an application that users can access with an offline-enabled mobile app, you configure case types as offline-enabled. Each of those case types must contain flows that are either a standard back-to-back assignment flow that starts with an assignment or a screen flow.

Flows and subprocesses

In the context of offline-enabled mobile apps, flows and subprocesses have the following features:

  • You can execute flows, including flows that create cases.
  • You can expand flows, and only the following shapes are supported offline:
    • Assignment shapes.
    • Question shapes.
    • Decision shapes with decision tables, when rules, decision trees, decision maps, and simple Boolean expressions that run on the client.
    • Decision shapes that are the first shapes of screen flows.
    • Utility shapes that are at the end of the screen flow. The utility does not run when offline but becomes available online when the completed assignments are sent to the server during synchronization.

    When the flow reaches any other shape when offline, the flow processing stops.

When you design applications that use subprocesses, consider the following information:

  • When offline, a subprocess can run for the current work item in the following situations:
    • The subprocess is in the main flow.
    • The subprocess consists of another nested subprocess.
    • The subprocess is located next to an assignment shape.
  • Offline-enabled apps support changing the path of a flow based on likelihood values for connectors that leave a subprocess. When the results of two connectors match, the offline processing engine selects the one with the highest likelihood value.

Further application design considerations:

  • When you build an application on top of another application, in cases that you use in offline-enabled mobile apps, save the flows from the original application in the class of the current application, and do not reuse flows instead.
  • A worklist that is displayed in an application that users access with an offline-enabled mobile app must be of the Assign-Worklist class.
  • You can create work with parameters.
  • The pyWorkParty page is not supported in offline mode. Modify the logic in the application to not refer to this page.
  • In offline mode, data transforms run automatically for preprocessing and postprocessing. Additionally, you can include custom JavaScript code to execute basic business logic before and after a flow action is rendered, by adding the JavaScript code into a custom user scripts bundle called pypega_ui_userscripts_offline. Functions of that code must be called within a try/catch clause. The JavaScript code that you want to execute before a flow action is rendered is always called after the ClientCache activity is called and before the DisplayHarness activity is called. Preactivities and postactivities can also run when the flow is synchronized with the server.
  • You can use the JavaScript pega.process.flow.setFlowEndStatus() method to set a flow result. This method overrides the status that is set with a property in the end shape of the subprocess.
  • Users can route assignments to other users. The Review page is displayed for the user to confirm the operation. The assignment is actually routed to a new assignee when the flow is synchronized with the server.
  • The confirmation page that is used in cases is the one that is set on the pyStartCase flow.
  • The latitude and longitude coordinates are recorded for assignments that are performed in offline mode.
  • Both the client and the server processing date/time stamps are recorded for each assignment that is completed in offline mode. The datetime stamp in the audit trail is populated during data synchronization with the then current server date/time value.
Note: When the flow processing feature that you want to use is not available in offline mode, it can still be performed when the offline-enabled mobile app regains network connectivity. For more information, see Enabling online-only features in offline mode.
  • Offline-supported flow processing features

    Offline-enabled mobile apps support a selected set of flow processing features. To ensure that your application operates reliably without a network connection, get familiar with the flow processing features that are supported in offline mode.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us