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.
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.
- Analyze your application logic and identify the components that might not get packaged for offline use. For more information, see Designing applications for offline mode.
- Create a configuration template that you can use to add offline support for specific components. For more information, see Creating offline configuration templates.
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.
- In the header of Dev Studio, click .
- On the Offline configuration tab, in the Configuration template section, click the template that you want to use with your offline-enabled app.
- On the Allow list tab, select the component category that you want to add to the allow list.
- 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:
Choices Actions Add a field value with the base class
- Click Add field values.
- 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
For more information about classes, see Understanding class hierarchy and inheritance.
- Click Add field values with multiple run-time class.
- In the Field value field, enter the field value that you want to add.
- In the Run-time classes field, enter the classes for which you want to add the field value.
- Click Add.
- 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
- On the offline configuration template form, click Save.
- 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