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 |
| Organization units | Structural changes, leadership updates |
| Employment terms | Norm time, allowances, and other terms |
| Time-off policies | Accrual rules, carry-over limits |
| Allowance policies | Allowance configurations |
| Work-time policies | Working day patterns, holiday calendars |
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 Administration > Job runs:
- Click Run job
- Select Apply scheduled changes
- Optionally choose a specific run date
- Click Run
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 | Organization 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 |
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