PrecisionScheduler 1.1.0

PrecisionScheduler for Sitecore

PrecisionScheduler for Sitecore is a drop-in replacement for the standard Task Scheduling found in Sitecore. Check out this article for more details.

Required Dependencies

• Cronos
• Hangfire.AspNet
• Hangfire.Core
• Hangfire.MemoryStorage
• Sitecore.Kernel
• Sitecore.Owin

Configuration

Your existing schedules should "just work". If you would like to make use of more advanced scheduling, you can use a cron expression directly in the Schedule field of a Sitecore scheduled task item.

Configuration Reference

Note: PrecisionScheduler is CM-only. The processor is gated by role:require="Standalone or ContentManagement" and will not activate on CD or other roles.

NuGet PackageReference

If you are installing using PackageReference instead of packages.config you'll want to either copy over the configuration files included in this repo or create your own.

<?xml version="1.0" encoding="utf-8" ?>
<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/" xmlns:set="http://www.sitecore.net/xmlconfig/set/" xmlns:role="http://www.sitecore.net/xmlconfig/role/">
  <sitecore role:require="Standalone or ContentManagement">
    <pipelines>
      <owin.initialize>
        <processor type="PrecisionScheduler.Pipelines.Initialize.Scheduler, PrecisionScheduler">
          <StartupDelaySeconds>30</StartupDelaySeconds>
          <RefreshSchedule>*/2 * * * *</RefreshSchedule>
          
          <RefreshMisfireBehavior>FireOnce</RefreshMisfireBehavior>
          
          <StartupCatchUpEnabled>true</StartupCatchUpEnabled>
          
          <MissedJobLookbackDays>30</MissedJobLookbackDays>
        </processor>
      </owin.initialize>
    </pipelines>
    <scheduling>
      
      <agent name="Master_Database_Agent">
        <patch:attribute name="interval" value="00:00:00" />
      </agent>
    </scheduling>
  </sitecore>
</configuration>

Cron vs Sitecore Recurrence Format

PrecisionScheduler accepts both formats in the Schedule field:

When a cron expression is detected (matches the standard 5-part cron pattern) it is used as-is. Otherwise the native Sitecore recurrence string is parsed and converted to a cron expression automatically.

Troubleshooting

Processor not loading after install Verify the assembly name in your config patch matches PrecisionScheduler (no trailing s). The correct type reference is:

type="PrecisionScheduler.Pipelines.Initialize.Scheduler, PrecisionScheduler"

Jobs not firing Check the Sitecore log for [PrecisionScheduler] entries. A WARN entry for a schedule item means its recurrence field is empty or could not be parsed. A ERROR entry means an exception occurred during a refresh cycle — the scheduler will retry on the next tick.

Unexpected jobs firing on startup PrecisionScheduler uses a frequency-aware catch-up window to decide whether to queue a missed job on restart:

• Sub-daily jobs (hourly, every N minutes) — only fire a catch-up if the missed run is within one interval of now. If the next slot has already passed too, the job resumes its normal cadence.
• Infrequent jobs (daily or longer) — fire a catch-up if the miss falls within MissedJobLookbackDays (default 30). This ensures a weekly job down over a weekend still catches up rather than waiting another full week.

To disable all startup catch-up, set StartupCatchUpEnabled to false. To narrow the window for infrequent jobs, lower MissedJobLookbackDays.

Jobs not catching up after a long outage If a missed run is older than MissedJobLookbackDays, it is skipped and the job resumes its next scheduled occurrence. Increase MissedJobLookbackDays to extend the window, or set StartupCatchUpEnabled to false and handle catch-up manually.

Changelog

See CHANGELOG.md for a full history of changes.