Overview:
A Repeating Job allows configuration of a Job that the system will automatically create with specified parameters on a user defined schedule. Use the "Configuration -> System -> Repeating Job" page to create and manage them.
Data Item | Details |
---|---|
Name | A textual name for this Repeating Job. It will be used as the name for any Jobs that are created. |
Code | A textual code for this Repeating Job. It will be used as the name for any Jobs that are created. It can be no more than 10 characters in length. |
From | A date from which this Repeating Job is active. |
To | A date to which this Repeating Job is active. |
Job Type | You must select what type of Job will be created. |
Shift Definition | The Shift that the Job be created for. |
Start-Finish | The start and end time on the day for created Jobs. |
Location | The Location that will be associated with created Jobs. |
Occurrences | The number of Jobs to be created. |
constraints:
- Only one of "Shift Definition" and "Start-Finish" can be provided.
- The actual number of Jobs created will be the minimum of the number provided as the "Occurrences" value and the number created by the "Frequency" schedule when combined with the From/To dates. E.g. if the Occurrences value is 20 but a Daily Frequency is provided for only one week, then only 7 Jobs will actually be created.
schedules:
Schedule | Details |
---|---|
A "Daily" schedule indicated that a Job will be created at an interval of a specified number of days, e.g. an Interval value of 2 means a Job will be created every second day. | |
When specifying "Weekly", select which days of the week Jobs will be created for. | |
For a "Monthly" schedule indicate which days of the month on which Jobs will be created, separated by ",". E.g. 1,10,20 will create three Jobs each month, on the first, tenth, and twentieth days. You can specify the last day of the month, regardless of whether it is 28th, 29th, 30th, or 31st by entering "L" (without the "). | |
"Annual" Jobs require you to specify on which date in the year the Job will be created. |
New Repeating Jobs
When a new Repeating Job is saved, the number of Jobs defined by the Occurrences value, the From/To dates, and the Frequency schedule will automatically be created by the system.
Updating Existing Repeating Jobs
Adding new Jobs:
If a change to the Occurrences or From/To dates signifies that new Jobs are to be created the system will simply create new Jobs to match the new required number of Jobs.
Removing Jobs
If a Repeating Job is being deleted or a change to the Occurrences or From/To dates signifies that existing Jobs need to be deleted, the system will first check the following ...
- If a Job needs to be deleted and the Job is in the past and Workers have been assigned to the Job and the assignment has been published, the change will not be allowed.
Assuming the above constraint is OK, future Jobs that need to be deleted will be, even if they have published assigned Workers.
When a Job is deleted, draft Worker assignments will also be removed.