Scheduled Jobs
Configure automated background tasks for Novigem.
Access these settings via Novigem Admin > Settings > Scheduled Jobs.
Nightly Maintenance
One scheduled job, Novigem Daily Job, runs three batches in order.
| Order | Batch | Runs when |
|---|---|---|
| 1 | Recurring challenge reset | Always |
| 2 | Insights and coaching signals | Only when Enable Rule Engine is on |
| 3 | Streak milestones | Only when Enable Rule Engine is on and streakMilestonePoints is above 0 |
Recurring challenge reset resets progress for recurring challenges (weekly, monthly, quarterly) when the current period ends, and creates new progress records for the next period.
Insights and coaching signals compares each user’s recent activity against the insights thresholds and writes coaching signals for Team Pulse and the rep coaching feed.
Streak milestones awards the bonus configured in streakMilestonePoints at 3, 7, 14, 30, 60, and 100 consecutive active days.
Until this job is scheduled, no coaching signals are ever generated. Team Pulse and the rep coaching feed stay empty. Schedule it as part of setup.
Job Status
| Field | Description |
|---|---|
| Status | Whether the job is scheduled (Not Scheduled, Scheduled). |
| Last Run | Date and time of the most recent execution. |
| Next Run | Scheduled time for the next execution. |
| Last Status | Result of the last run (Completed, Failed). |
The job also shows processing details, such as “4/4 challenges processed, 0 errors”.
These fields report the recurring challenge reset batch only. To check the other two, open Setup > Apex Jobs and look for InsightsBatch and StreakMilestoneBatch.
Schedule Configuration
Enter a cron expression to define when the job runs. Default is daily at 1:00 AM.
| Setting | Description |
|---|---|
| Cron Expression | Standard cron format defining the schedule. |
Common Expressions
| Expression | Schedule |
|---|---|
0 0 1 * * ? | Daily at 1:00 AM |
0 0 0 * * ? | Daily at midnight |
0 0 6 ? * MON-FRI | Weekdays at 6:00 AM |
0 0 2 ? * SUN | Sundays at 2:00 AM |
Actions
| Button | Description |
|---|---|
| Schedule | Save the cron expression and enable the scheduled job. |
| Reschedule | Apply a changed cron expression to the job that is already scheduled. |
| Unschedule | Stop the job. Nothing runs again until you schedule it. |
| Run Now | Run the recurring challenge reset once, immediately. |
Run Now only runs the recurring challenge reset. It does not generate coaching signals and it does not award streak milestones. To produce signals on demand, use Run analysis now on the Team Pulse tab, which needs the Novigem Admin permission set.
Best Practices
- Schedule the job during setup. Coaching signals depend on it and nothing generates them before then.
- Schedule jobs during off-peak hours to minimize impact
- Use “Run Now” to check the recurring reset before relying on the schedule, and Team Pulse’s “Run analysis now” to check coaching signals
- Monitor job status regularly to catch failures early
- For recurring challenges, ensure the job runs before the new period starts
- After changing the cron expression on a scheduled job, click Reschedule so the new time takes effect
Next steps
- General Settings: Configure point behaviors, tracked objects, and insights thresholds.
- Integrations: Connect Novigem to external tools.
- Challenges Field Reference: Configure recurring challenge behavior.
- Designing Effective Challenges: Learn to use seasons and resets effectively.