Skip to main content


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

Making custom resources available in offline mode

Updated on April 27, 2022

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.

Before you begin: Prepare the framework for including custom resources in your app package:
  • Analyze the application logic and identify custom resources in your application model.
  • Create a configuration template that you can use to add offline support for your resources. For more information, see Creating offline configuration templates.
When a custom resource appears in the flow of your app, the mobile client tries to connect to the server and access the resource. In offline mode, the app cannot connect to the server, and if the resource is not packaged for offline use, the app displays a warning and forces the user to log out. By adding custom resources to the offline configuration template that you use to build your app, you include the resources in the client and support business continuity in areas with limited or no connectivity.
Note: Each template contains references to default, read-only elements that correspond to the resources in Theme UI-Kit or Pega Cosmos design system in your application.
  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 mobile app.
  3. On the Resources tab, add your components to the offline-supported list:
    ChoicesActions
    Add an image or icon
    1. In the Images and icons section, click Add image.
    2. In the dialog box, enter the path to the file with your custom image or icon.
      For images and icons, you provide the path to the file's location on the server. These resources are uploaded to the server when you create them with binary file rules.

      For more information, see Adding images to Image Library.

    Add a font
    1. In the Fonts section, click Add font.
    2. In the dialog box, enter the path to the file with your custom font.
      For fonts, you provide the path to the font file's location on the server. Font files are uploaded to the server when you create them with binary file rules.

      For more information, see Uploading custom font files.

    Add a locale
    1. In the Locales section, click Add locale.
    2. In the dialog box, enter the ID of your custom locale.
      For more information, see Localizing your application.
  4. 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.
  • Enabling support for components in offline mode

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

  • 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.

  • 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 Excluding data pages from delta synchronization in offline-enabled mobile apps
  • Next topic Routing case status conflicts 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.

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

Close Deprecation Notice
Contact us