Schedulers can manually update a job's status relating their allocated resources' actions.
Requirements for Completing a Job Manually
The scheduler can manually complete an allocated job providing it is in one of the following states:
- En Route.
- On Site.
- In Progress.
Note: The "Complete Job" menu option will be disabled if the job is not in one of these (above) states.
Completing a Job Manually in Job Details
Open the job in the job details view. Click the additional menu icon (above the right column) and select "Complete Job."
Figure 1. Manually completing a job via the job details view.
Once the process is started, Skedulo will perform some checks. First, it will check the setting "Consider job tasks to be optional" (which is configurable via the admin settings). Depending on the result, one of two things will happen:
- If it is enabled, the "Complete Job" modal will open (i.e., job tasks are optional).
- If it is disabled, Skedulo will check for incomplete tasks assigned to the job.
Also, see Admin Settings: Workflow (for job task option mentioned above).
The Incomplete Tasks Modal
The incomplete tasks modal states the following message:
"There are incomplete tasks on this job. Do you want to mark these tasks as complete now?"
- Clicking the "Yes, complete tasks" button will complete all the outstanding tasks, then it will open the "Complete Job" modal.
- Nothing will be changed if the "Cancel" button is clicked.
Figure 2. The incomplete tasks modal.
The Complete Job Modal
When the complete job modal opens, four fields are available for configuration:
- Actual start date. This value populates the "In Progress" field (see figure 5).
- Actual start. This value populates the "In Progress" field (see figure 5).
- Actual end date. This value populates the "Complete" field (see figure 5).
- Actual end time. This value populates the "Complete" field (see figure 5).
Figure 3. The complete job modal.
These fields can be populated in different ways depending on the status of the job and the current time:
- If the scheduled end time of the job is in the past when the modal opens, the four fields will auto-populate with the scheduled start and end times. These can be changed to the actual start and end times and saved (using "Complete job").
- If the job is "In Progress," it will already have an actual start time. As a result, Skedulo will lock the actual start time in the complete job modal (it will be read-only). The end time can be changed to the actual end time and saved (using "Complete job").
- If the job is in the "Ready" or "En Route" state but the scheduled start time has not yet been passed when the modal is opened, the fields will be blank. Selecting a date prefills the time field with the current time. The values can be changed, but they cannot be in advance of the current time indicator on the swimlane (i.e., they cannot be times in the future, only those current or past). A warning is be given if the times are set too far ahead.
- A blank modal (i.e., where all fields are left blank) can be saved, and the job will be completed. This results in no times being recorded for "In Progress" (actual start) or "Complete" (actual end).
Note: If the entered end time is before the start time a warning is displayed and will stay present until the field is corrected.
Figure 4. A warning is displayed when the time selected is in the future.
Figure 5. The result of a job completed using blank modal fields.
Note: In the job allocation record, the actual start time is saved against the "TimeInProgress" field and the actual end time against the "TimeCompleted" field.
If the job allocation already has an entry for these fields, then that entry will remain. Skedulo only saves to empty (unpopulated) fields, so that "actual" data is preserved.