Apply scheduled changes
Applies pending scheduled changes when their effective date arrives.
How it works
The apply scheduled changes job runs daily and applies all scheduled changes that are due:
- Checks for pending changes — Looks for scheduled changes with an effective date on or before the run date
- Applies each change — Updates the entity with the scheduled values
- Records the application — The change moves from “scheduled” to “applied” in the version history
Supported entities
The job processes scheduled changes for:
| Entity | Description |
|---|---|
| Employees | Personal information, employment data, manager assignments |
| Org units | Structural changes, leadership updates |
| Employment terms | Norm time, allowances, and other terms |
| Time off policies | Accrual rules, carryover limits |
| Allowance policies | Allowance configurations |
| Work time policies | Working day patterns, holiday calendars |
| Holiday calendars | Holidays, and which employments the calendar covers |
| Roles | Permissions of custom roles |
When it runs
The job runs automatically each day and checks if there are pending changes due. It only runs when there are changes to apply, saving unnecessary processing.
Triggering manually
You can run the job manually from :
- Click Run Job
- Select Apply scheduled changes
- Optionally choose a specific run date
- Click Run Job
This is useful for:
- Testing scheduled changes before their effective date
- Catching up on missed changes after system downtime
- Verifying that changes will apply correctly
Job results
After the job completes, the results show one <entity>_applied and one <entity>_failed counter per entity type:
| Metric | Description |
|---|---|
| employees_applied / employees_failed | Employee changes applied / failed |
| org_units_applied / org_units_failed | Org unit changes applied / failed |
| employment_terms_applied / employment_terms_failed | Employment terms changes applied / failed |
| timeoff_policies_applied / timeoff_policies_failed | Time off policy changes applied / failed |
| allowance_policies_applied / allowance_policies_failed | Allowance policy changes applied / failed |
| worktime_policies_applied / worktime_policies_failed | Work time policy changes applied / failed |
| holiday_calendars_applied / holiday_calendars_failed | Holiday calendar changes applied / failed |
| custom_roles_applied / custom_roles_failed | Role changes applied / failed |
| Scheduled changes that were discarded because they no longer apply — for example because the entity was deleted. Only shown when it happened |
Troubleshooting
| Issue | Solution |
|---|---|
| Change not applied | Check the effective date — the job only applies changes on or before the run date |
| Change shows as failed | View the job run details for the specific error message |
| Multiple changes for same entity | Changes are applied in order of their effective date |
Related
- Scheduled and retroactive changes — How to create and manage scheduled changes