Enabling offline mode in the Perceptive apps

For Perceptive applications, the offline experience is available through the Service Worker API. A service worker is a script that your browser runs in the background, and it can intercept and handle network requests, including programmatically managing a cache of responses. Service Worker is a powerful API where you can fabricate and filter responses.

Note: For more information, see Operations and services roles and Managing services.

Configure Offline Mode

During development, you can use Service Worker through your localhost. But to use it on production, for security reasons, you must have HTTPS configured on your Maximo® Real Estate and Facilities server. In other words, to guarantee that the Service Worker code is not tampered or compromised during its journey across the network, you must download it over a HTTPS connection.

To use the offline capabilities with HTTPS configured on your Maximo Real Estate and Facilities production server, you must also obtain a TLS certificate. Your HTTPS configuration will depend on the architecture of your Maximo Real Estate and Facilities installation. It is possible to set up the HTTPS on the application server, the HTTP server, in the network load balancer, or anywhere else, depending on the architecture in place.

For more information, see the triplat-offline-manager and triplat-ds-offline components in your UX component documentation.

Enable Offline Mode

To enable offline mode for the Work Task Services (WTS) portal and Work Task app, you (as Application Administrator) can open the foundation Maximo Real Estate and Facilities Application and select Tools > System Setup > General > Application Settings. In the Work Task Settings tab, select the Enable Work Task Offline Feature check box.

Note:
  • While many features of the Work Task Services (WTS) portal and Work Task app are supported in offline mode, the following features are not supported at this time:
    • Logging into the app.
    • Submitting a new work task.
    • Opening a completed work task.
    • Selecting a location for a work task.
    • Self-assigning a work task from a pool of work tasks.
    • Displaying a photo for a comment (iOS devices).
    • Displaying a floor plan for an asset or location.
    • Displaying a pin icon for an asset or location in a list.
    • Downloading files attached to an asset or procedure.
    • Generating an ID for a new material or new work task.
    • Opening the Service Request app.
    • Opening the Locate app.
    • Opening the BIM view.
  • In offline mode, the Download data action is not displayed.
  • Other offline limitations:
    • Due to a Microsoft Edge limitation, this browser is not supported at this time.
    • Due to a Google Chrome on iOS limitation, this combination is not supported at this time.
    • Due to a Mozilla Firefox ESR limitation, this browser is not supported by default. But the feature can be enabled.
Note:
  • Device Performance: We performed the following download tests on an Android smartphone, Apple iOS smartphone, and Windows laptop. These were the results that we observed.
  • Scenario 1: Fifty in-progress work tasks to be ready for offline use, each with 100 procedure steps. No images.
    • Chrome on Android 7 phone (Motorola G4, 2 GB RAM, 16 GB ROM): Download time took 67 seconds. Website storage took 10 MB.
    • Safari on iOS 11.4 phone (iPhone 7 Plus, 3 GB RAM, 32 GB ROM): Download time took 61 seconds. Website storage took 9.5 MB.
    • Firefox on Windows 10 laptop (Dell Precision 7720, 32 GB RAM): Download time took 69 seconds. Website storage took 26.3 MB.
  • Scenario 2: Two buildings with 10,000 spaces each to be ready for offline use. No floor plans or images.
    • Chrome on Android 7 phone (Motorola G4, 2 GB RAM, 16 GB ROM): Download time took 32 seconds. Website storage took 6.8 MB.
    • Safari on iOS 11.4 phone (iPhone 7 Plus, 3 GB RAM, 32 GB ROM): Download time took 22 seconds. Website storage took 9.5 MB.
    • Firefox on Windows 10 laptop (Dell Precision 7720, 32 GB RAM): Download time took 30 seconds. Website storage took 5.1 MB.
  • Download time and characteristics will vary depending on network speed, device configuration, and amount of data.