Introduction
JS7 offers JS7 - Calendars for use with JS7 - Schedules:
- Calendars specify the days for which Orders can be created by Schedules to execute Workflows.
- Schedules can further limit the days suggested by a Calendar and specify the time for which Orders are scheduled.
Manage Calendar
Add Calendar
Calendars are available from the Configuration->Inventory View in in the respective sub-folders.
- The tree in the left panel offers an action menu to create a calendar.
- The action menu is available from the Calendars object folder.
When adding a Calendar a popup window asks for the object name:
As a result an empty Calendar object becomes available:
- Calendars are configured for either working days or non-working days:
- Working day Calendars specify the business days for which orders for workflow execution are scheduled.
- Non-working day Calendars specify days that are excluded from workflow execution.
- Both calendar types can be combined with precedence being given to non-working days for any overlapping days.
- Calendars can be limited by a validity period that specifies the begin and end of validity respectively. A Calendar does not calculate days that lie
- before begin of its validity period,
- after end of its validity period.
Add Frequencies
The selection of days in a Calendar is managed by use of Frequencies:
- Any number of Frequencies of the same or different type can be added.
- Similar to a Calendar each Frequency can further limit the validity period. However, a Frequency cannot anticipate or exceed its Calendar's validity.
Typical Frequencies include for example:
- Weekdays: Monday to Friday, every week,
- Specific Weekdays: every first Friday, every last Monday in month
- Specific Days: days selected from a yearly calendar
- Month Days: 3rd of month, last of month, last-3 of month
- Recurring Days: every 2nd day in every month,
- National Holidays: for a country for the particular year.
When using the Add Frequency button for a Calendar the following popup window offers to select a Frequency:
- Any number of the same or different Frequencies can be added to a Calendar.
- Frequencies are merged to calculate the resulting days of the given Calendar.
Frequency Type: Weekdays
This option offers to select the days of week.
Frequency Type: Specific Weekdays
This option offers to specify a day of week and its occurrence in a month.
Frequency Type: Specific Days
This option lets users freely select dates from a yearly calendar.
Frequency Type: Month Days
This option specifies relative days in a month:
- in ascending order from the 1st, 2nd, 3rd etc.
- in descending order from the last, last-1, last-2 etc.
Manage Frequencies
With Frequencies being added users find the list of available Frequencies for the Calendar object: Actions are offered for each Frequency:
- The icon shows the preview of days for the given Frequency.
- The icon allows to edit the given Frequency.
- The icon removes the given Frequency.
Show Calendar Preview
The Calendar object view offers the Show Preview button:
- A preview of merged days of all included Frequencies is displayed.
- The preview can further be limited by selecting from the list of available Frequencies.
Release Calendar
Calendars are not deployed to a Controller and Agent. Instead they are used by the JS7 - Daily Plan Service to create orders for workflow execution at the given days.
Calendars therefore know a draft status and a released status:
- A draft status is visible from icon and from the orange bullet.
- Draft Calendars are ignored by the Daily Plan when creating Orders for Workflow execution.
- A released status is visible from the icon and from the blue bullet.
- Released Calendars are used by Schedules when creating Orders for Workflow execution with the Daily Plan.