Skip to main content


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

Enabling support for components in offline mode

Updated on March 3, 2022

Make all elements of your offline-enabled mobile app work as designed, by populating the list of offline-supported components.

For example, your app displays a table with expense reports that users can categorize; the source of the table is a parameterized data page. When users select an expense category, the client sends a query to the data base to fetch the appropriate results, which is not possible in offline mode. To make the expense report table work correctly in offline-enabled apps, you first create a data page that stores all expense records. Then, you add this container data page to the allow list in the offline configuration template to ensure that the data page is packaged for offline use.

Before you begin: Prepare the framework for enabling support for components in offline mode:

Pega Platform automatically packages the components that you reference in the application model for use in offline mode. You can use your offline configuration template to ensure that any components that are not automatically packaged are available for use in your offline-enabled app.

The usage of some components in offline mode is limited. For more information about the implementation of specific components in offline-enabled apps, see Understanding offline features.

  1. In the header of Dev Studio, click ConfigureMobileOffline configuration.
  2. On the Offline configuration tab, in the Configuration template section, click the template that you want to use with your offline-enabled app.
  3. On the Allow list tab, select the component category that you want to add to the allow list.
  4. If you select the Field values category, in the Field values section on the right side of the form, determine how you want to add field values to the allow list:
    ChoicesActions
    Add a field value with the base class
    1. Click Add field values.
    2. Populate the autocomplete field with the field values that you want to enable for offline use, and then click Add.
    Add a field value with multiple run-time classes
    1. Click Add field values with multiple run-time class.
    2. In the Field value field, enter the field value that you want to add.
    3. In the Run-time classes field, enter the classes for which you want to add the field value.
    4. Click Add.
    For more information about classes, see Understanding class hierarchy and inheritance.
  5. In the section on the right side of the form, populate the autocomplete field with the components that you want to enable for offline use, and then click Add.
    For example:
    Adding a data page to the allow list
    Process of adding a data page to the allow list in offline configuration template
  6. On the offline configuration template form, click Save.
Result: When you configure offline support in the mobile channel, you can select the template that you modified to ensure that appropriate components are packaged when you generate an offline-enabled app.
  • Excluding data pages from packaging in offline-enabled mobile apps

    Improve the performance of your offline-enabled mobile app by excluding data pages from the app installation package. For example, exclude a resource-heavy data page from packaging when you plan to replace the data page with a large data page that is optimized for offline mode.

  • Excluding data pages from delta synchronization in offline-enabled mobile apps

    Optimize data exchange and save time when your offline-enabled mobile app synchronizes with the server, by excluding data pages from the delta synchronization process. For example, you can exclude a large data page with a list of countries that does not change often and therefore does not have to be packaged during delta synchronization.

  • Making custom resources available in offline mode

    Ensure that your mobile app displays custom resources and continues the process flow in offline mode by including the resources in the app installation package. For example, you can add offline support for a custom font that matches your company's branding guidelines.

  • Routing case status conflicts in offline mode

    Provide an uninterrupted experience for the users of your offline-enabled mobile app by routing possible case status conflicts to designated work queues. By adopting this functionality, users continue to use the app while a designated person (for example, a system administrator) can address the conflicts to ensure that no data is lost.

  • Previous topic Creating offline configuration templates
  • Next topic Excluding data pages from packaging in offline-enabled mobile apps

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.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us