Configure scheduled offline caching

  • Release version: Australia
  • Updated June 9, 2026
  • 2 minutes to read

    • Configure offline caching so your field technicians can receive scheduled updates to their offline data cache. Scheduled downloads are based on the user's work schedule.

    Activate the Agent Schedule plugin

    To enable and configure scheduled offline caching, the Agent Schedule plugin [com.snc.agent_schedule] must be activated. For details on plugin activation, see Activate a plugin.

    Create work schedules for offline caching

    For mobile clients other than Mobile Agent, verify that an entry in offline download schedule (sys_sg_offline_download_schedule) exists for the client type, for example, Request. This entry specifies the table that has the offline download schedules for the agents or technicians. Mobile uses the schedule from this table for scheduling offline cache generation. To populate schedules for each user, a scheduler script can be used like in Field Service Mobile.

    For the Mobile Agent app, the entry is created when the plugin is activated. After activating the plugin, you must create work schedules for the agents or technicians to enable users to automatically receive scheduled offline caches. This can be done directly through the Agent Work Schedules [agent_work_schedule] table. For more information on how to create schedules through this table, see Create a work schedule for an agent or technician.

    Based on the records from the Agent Work Schedules table, your instance runs background scheduled jobs that create schedules in the Agent Daily Schedules [agent_daily_schedule] table. Within these schedules, agents will receive a silent push sometime throughout their scheduled day.

    The offline payloads that your instance generates are based on the times recorded in the Agent Daily Schedules. These can be found in the Events [sysevent] table. Use the records in the Event table to track these payloads, and info about when they are created and when they are sent to the agents.

    Scheduled Jobs associated with offline caching

    These scheduled jobs are automatically scheduled for only users who enable background downloading on their app. For information on how users can enable this feature, see Offline mode for mobile.

    Populate Agents Daily Schedule Table
    This job runs once daily for all users with background downloading set to true.
    Scheduled Download of Offline Payload
    This job creates an event for the first payload of the day in the [mobile_offline_payload_gen_queue] table.

    Offline scheduling system properties

    Use the following properties on the System Properties [sys_properties] table to configure scheduled offline caching.

    Table 1. Offline scheduling system properties
    Property Description
    glide.sg.offline.scheduled_download.enabled

    Enables scheduled downloading for all Mobile Agent app users.
    glide.sg.offline.scheduled_download.cachesync_offset Defines the number of minutes before the user's scheduled time that the instance begins generating the offline payload.
    glide.sg.offline.scheduled_download.reminder_offset Define the number of minutes before the user's scheduled offline time that a reminder is sent to download the cache manually.
    glide.sg.offline_payload.refresh_frequency Define a fixed interval between the initial scheduled cache download and when the cache should be refreshed.
    glide.sg.offline.attachment.max_total_bytes Defines the total amount of storage the offline cache can use for attachments in bytes.

    For information on other related offline system properties, see System properties in offline mode.