scheduleDashboardRefresh
Schedule, change, or stop automatic dashboard page refreshes using cron-based local times, and check upcoming runs. Use it to keep Garmin dashboard data current without an assistant open.
Instructions
Turns on, changes or stops the automatic refresh of a dashboard page. Use it only when the user
asks for it or says yes to the question of a dashboard prompt. A job in the scheduler of the
computer (launchd, cron or Task Scheduler) replaces the data of the page at the given times, also
with no assistant open. The refresh removes the coach notes, because old notes do not agree
with new data. The computer must be on at that time. The page must exist (writeDashboard first).
last is the last automatic run: its time and the pages that it could not update, with the
error. A page shows a note when its update is more than 1 hour late: last tells why.
cron: convert what the user says, in any language, into a 5-field cron expression in local
time: minute hour day-of-month month weekday, numbers only (0 = Sunday), e.g. "0 7 * * 1-5" for
weekdays at 7. Two runs must be at least 1 hour apart. The cron is for all scheduled pages;
path adds that page (default the main page); off stops the refresh of path, or of every
page when no path is given. Without arguments it only reads. The reply has next, the next
runs in local time: tell them to the user in their language, so they can check the schedule.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| off | No | Stop the refresh | |
| cron | No | minute hour day-of-month month weekday, e.g. "0 7 * * *"; default 0 7 * * * | |
| path | No | The .html file; relative paths are inside the data dir |