The "Jobs Calendar" is the first view that a scheduler will see when they open the scheduling console; it is the default view. It provides schedulers with a way to visualize their scheduled jobs at a high-level, e.g., jobs per week or a full calendar month.
Short Video Explainer
The Jobs Calendar (3 min 13)
Filtering the Jobs Calendar (1 min 39)
The Jobs Calendar View
The monthly calendar view shows a complete month, divided by days of the week. Color-coded job cards contain labels to highlight their current job status.
Figure 1. The monthly jobs calendar view in the scheduling console.
The weekly calendar view shows a complete seven day week (Sunday to Saturday), also divided by days. Crucially, it differs from the month view having each day subdivided by hours and minutes. This means jobs can be allocated to a date and time in a single movement (see "Moving Jobs in the Jobs Calendar").
Figure 2. The weekly jobs calendar view.
There are three ways to control the visual range of the calendar:
- The date picker–use this to select a target month from the calendar.
- The date switcher–zoom to "Today," or step forward or backward one month at a time.
- The view options–choose from the available options to increase or decrease the visible time span (e.g., one month or one week).
Figure 3. The calendar controls, date picker, date switcher and view options are located in the action bar, above the calendar.
Also, see Job Status and Job Allocation Status.
Public holidays are marked with a small dot in the top-right corner and are shaded gray. The name of the public holiday is shown in a tooltip on mouseover.
Figure 4. Highlighted holidays in the jobs calendar.
Create a Job in the Jobs Calendar
To create a new job in the jobs calendar, right-click on a day and select "Create Job." The create job modal will open with the date pre-populated. Complete all the required fields highlighted red and then click "Save."
Figure 5. How to create a job in the jobs calendar.
Figure 6. Filling in the details on the create job modal.
Note: Creating a new job on a specific day in the calendar will pre-populate the "Date" for the job but not the start or end times. The times must be specified to save the job.
In the scheduling console, it is possible to drag-and-drop job cards from the job list onto the calendar whereafter the time and duration are set.
It is also possible to drag-and-drop job cards onto the calendar using the "Quick Create Job" feature. Once the card is dropped into place, the scheduler can allocate times via the "Select time range" pop-up.
Note: Dragging job cards onto the calendar does not assign any resources to the job, this must be done separately.
Figure 7. How to drag a job from the jobs list to the jobs calendar.
Figure 8. How to drag a quick job onto the jobs calendar.
Figure 9. Allocating times to a quick job placed on the jobs calendar.
Moving Jobs in the Calendar
Schedulers can drag-and-drop job cards between dates in both the month and week calendar views.
Figure 10. Drag-and-dropping a job card in the jobs calendar.
Important! Currently, there is no validation applied to job cards that are dragged between dates in the jobs calendar. Care should be taken to ensure that applied job constraints are not overlooked.
View Job Details in the Jobs Calendar
A summary of the job details accompanies each job in the calendar. To view the summary, left-click on a job card.
Figure 11. Viewing the job details summary for a job in the jobs calendar.
In the monthly calendar view, only four job cards can be displayed per day. When more than six jobs exist on the same day, the sixth card indicates there are more jobs available, e.g., a card displaying "+2 JOBS" indicates the card is shared by two jobs (they are stacked together to save space).
In the weekly calendar view, where two or more jobs are allocated on the same day, at the same time, they are stacked or clustered–represented by a small black and white counter, e.g., a card displaying the black label with a white "2" indicates the time and date are shared by two jobs (they are stacked together to save space). Using a mouse, roll over the counter to reveal the stacked job cards and their details.
To view a job's full details, click on the job number on the job card–this will open the job details view. To view the time allocated for a job, using a mouse, roll-over the job card and a tool-tip will show the start and end times.
To view jobs that are long in duration (i.e., extend over two days or more), using a mouse, roll-over the job card in the calendar. The job card will expand to show the actual dates covered by the job.
Also, see Job Details.
Figure 12. An example showing multiple jobs sharing the same of a job cluster or stack.
Figure 13. Two jobs sharing the same date and time in the weekly jobs calendar.
Figure 14. How to view the time allocation for a job in the jobs calendar.
Figure 15. Viewing a long duration job in the jobs calendar.
Cancel or Unschedule a Job from the Jobs Calendar
To unschedule or cancel a job in the calendar, right-click on a job card and select the required action from the menu options.
Figure 16. How to unschedule or cancel a job in the jobs calendar.
Filtering the Jobs Calendar
To surface specific information of interest, a scheduler can apply filters to objects in the jobs calendar. For example:
- Show all jobs assigned to a resource.
- Show all jobs pending that have a high urgency.
- Show all jobs with a job status of "Pending Allocation."
- Show only the jobs that are associated with a certain account.
There are many more combinations of filters that can be applied; these are all available in the filter bar.
Also, see Filter Bar.