Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: ShowIf deleted

...

The use case described in this article shows how such a combination may be configured within a single Working Day Calendar:

  • a basic Monday to Saturday working week is defined as an Included Frequency and
  • National Holidays and regularly occurring days are defined as Excluded Frequencies and are "removed" from the basic working week.

Note that the . The advantages and disadvantages of using a single Working Day Calendar - as described here - in comparison with the use of using separate Working and Non-Working day Calendars Day calendars have already been described in the Calendar Use Cases - Managing Working Day Calendars article.

Article Scope

This article describes how to configure a basic Calendars calendars and builds on the first two Use Case use case articles in which the configuration procedure was described in detail:

Feature Availability

The Calendar feature is was introduced with JobScheduler 

Display feature availability
StartingFromRelease1.12

...

This article has been written assuming that a Job Chain and Order has already been configured in a demo/end2end/ folder in the JobScheduler Master's config/live/ folder and that the Calender will be assigned to an the Order.

Calendar Configuration

The configuration is implemented within a single Working Day Calendar, Valid From 1st January 2017 to 31st December 2019, as and is summarized in the following table:

Frequency TypeFrequencyValid FromValid To
IncludedBasic business week: Monday to Saturday--
ExcludedNational Holidays 2017--
ExcludedNational Holidays 2018--
ExcludedNational Holidays 2019--
ExcludedLast Saturday in Month for August to  mid-November 20181st Aug 201818th Nov 2018

The following screenshots will summarize the main configuration stages required for the different components - called Frequencies - in the Calendar configuration. Step-by-step descriptions of the individual configuration stages can be found in the two Calendar Use Cases - Managing Working Day ... articles that are linked in the Introduction. 

...

The Calendar itself will appear as shown in the next screenshot:

The included frequency days are shown in blue and the excluded frequency days are in orange. This allows the last Saturdays in the months of August to November can to be readily identified in orange, as can the National Holidays, along with the National Holidays. The select box at the top right of the window, which is showing All Frequencies in the screenshot above, can be used to show a preview for individual frequencies if required.

Order Run-time Configuration

Assigning the Calendar to an Order

The Calendar is assigned to an Order - in this case order_cal-001 - in the Set Run-time modal window, which is opened by from the Additional Options (ellipsis symbol) menu in the Job Chains or Orders views.