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 |
|---|---|
| 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 |
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:
| Metric | Description |
|---|---|
| org_units_applied | Number of organization unit changes applied |
| org_units_failed | Number of organization unit changes that failed |
| employment_terms_applied | Number of employment terms changes applied |
| employment_terms_failed | Number of employment terms changes that failed |
| timeoff_policies_applied | Number of time-off policy changes applied |
| timeoff_policies_failed | Number of time-off policy changes that failed |
| allowance_policies_applied | Number of allowance policy changes applied |
| allowance_policies_failed | Number of allowance policy changes that 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