Scheduling Recurring Checks
Learn how to set up, manage, and receive notifications for recurring automated checks to continuously monitor project quality without manual effort.
Why Schedule Checks?
Manual checks catch issues at a point in time. Scheduled checks catch them continuously. Set up a nightly or weekly check and receive email summaries without lifting a finger.
Creating a Scheduled Check
- Go to the Run Check tab.
- Select folders and a rule set (or per-folder mappings) as if you were running a manual check.
- Click Schedule (next to the Run Check button).
- The schedule dialog opens with:
| Setting | Description |
|---|---|
| Name | A name for the scheduled job (e.g. "Nightly Arch QA") |
| Schedule | Use the visual SchedulePicker to set the frequency |
| Email on completion | Receive an email with pass rate, violation count, and a link to results |
| Email on failure | Receive an email only if the check fails (any Error-severity violations found) |
The SchedulePicker
The visual schedule builder supports:
- Quick presets: Daily, Weekly, Monthly.
- Day-of-week toggles: Select specific days (e.g. Monday, Wednesday, Friday).
- Time: Hour and minute.
- Custom cron: Switch to advanced mode and enter a cron expression directly (e.g.
0 2 * * 1-5for 2 AM weekdays).
Click Create Schedule to save. The job appears in the Scheduled section at the bottom of the Run Check panel.
Managing Scheduled Jobs
Viewing Scheduled Jobs
Scheduled jobs for the current project are listed at the bottom of the Run Check panel with:
- Status dot (green = enabled, grey = disabled).
- Job name.
- Run now button to trigger an immediate execution.
Editing and Deleting
Manage scheduled jobs from the Scheduled Jobs section in the sidebar (admin section) or through the inline controls on the Run Check tab.
Email Notifications
When a scheduled check completes, Foreman can send an email with:
- Pass rate (percentage).
- File counts (total, passed, failed, warnings, skipped).
- Top violations summary.
- Direct link to the check results in Foreman.
Configure notification preferences in the schedule dialog when creating or editing the job.
Scheduled checks use your stored APS tokens. If your Autodesk session expires, the check may fail. Re-authenticate via the Foreman settings page if you see token-related errors in the execution history.
Retention
Check run results are subject to your plan's export retention policy. Older results are automatically cleaned up by the QACheckCleanup background job.
Next Steps
- Running QA Checks -- learn the manual check flow first
- Scheduled Jobs Overview -- general scheduled jobs documentation