Introduction

JS7 offers provides JS7 - Calendars for use with JS7 - Schedules:

• Calendars specify the days for on which orders for executing workflows can be created by Schedules to execute workflows.
• Schedules can further limit the days suggested by a Calendar and specify the time for at which orders are scheduled.

Calendars and Schedules are highly flexible allowing and allow a larger large number of rules specifying when to execute workflows can be executed.

• The same A Calendar can be used by any number of Schedules.
• As each Schedule can limit the days for workflow execution within the scope of the a Calendar used , there is no need for a larger large number of Calendars.
• Typically one to five Calendars are sufficient for an organization, for example using specific Calendars for all days, for company business days, for department business days, etc.

Manage Calendar

Add Calendar

Calendars are available from can be accessed in the Configuration->Inventory View in in the respective relevant sub-folders.

• The tree in the left panel offers an action menu to create for creating a calendarCalendar.
• The action menu is available from the any Calendars object folder.
  
  

When adding a Calendar a popup window asks for the object name:

As a result This results in an empty Calendar object becomes becoming available:

• Calendars are configured for either working days or non-working days:
  • Working day Calendars specify the business days for on 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 or
  • after end of its validity period.
    
    

...

The selection of days in a Calendar is managed by use of using Frequencies:

• Any number of Frequencies of the same or different type can be added.
• Similar to Calendars, each Frequency can further limit its validity period. However, a Frequency cannot anticipate or exceed its Calendar's validity period.

...

When using the Add Frequency button for a Calendar the following popup window offers to select allows a Frequency to be selected:

• Any number of the same or different Frequencies can be added to a Calendar.
• Frequencies are merged to calculate the resulting days for the given Calendar.
  
  

...

Frequency Type: Weekdays

This option offers to select allows the days of week to be selected.

Frequency Type: Specific Weekdays

This option offers to specify allows a day of in the week and its occurrence in a month to be specified.

Frequency Type: Specific Days

...

• 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 Users will find the list of available Frequencies for the Calendar object as Frequencies are added. The following Actions are offered for each Frequency:

• The   icon shows the preview of days for the given Frequency.
• The  icon allows to edit editing of the given Frequency.
• The  icon removes the given Frequency.
  
  

From the Calendar object by default the filter button for Included Frequencies is active that specifies The Included Frequencies filter button specifying the days for workflow execution is active from the Calendar object by default.

• Users can choose to click the button for Excluded Frequencies that specifies days for on which no workflows should not be executed.
• A Calendar can have both Included Frequencies and Excluded Frequencies at the same time.
• When calculating resulting days of a Calendar then any days from Days specified in Excluded Frequencies are excluded from the resulting days when calculating resulting days for a Calendar.
  
  

Show Preview

The Calendar object view offers provides the Show Preview button:

• A This displays a preview of the merged days of all the 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 know a draft status and a released status:

• A draft status is visible from indicated by the icon and from the  orange bullet.
  • The draft status is in place when a Calendar is has been added or modified and is has not yet been released.
    • A In addition, a draft Calendar can further be invalid which is as indicated by the  icon. This happens can be due to missing input or invalid data added to the Calendar by the user.
    • Invalid Calendars are automatically stored in the same ways as valid Calendars. However, they cannot be released before they are validuntil they have been validated.
    • Validation is performed with a JSON Schema, see JS7 - Inventory Storage Format.
  • 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.
  • Only Valid Schedules only can be released.
  • Released Calendars are used by Schedules when creating orders for workflow execution with the Daily Plan.
  • In addition they , released Calendars are considered when manually creating the Daily Plan from the respective relevant view.