Concept of calendars
Calendars in The Scheduler represent set of days in which Scheduled Issues will not be executed. It is possible to create multiple calendars, and users who create Scheduled Issue can choose, which calendar will be applied.
There are two types of calendars:
- Project calendars, that will be available only for project in which they were created,
- Global Calendars, which will be available across all projects.
Creating a Calendar:
Project Calendars can be created in Project Administration section, at the "Project Calendars" link.
To get there the quickest way, access desired project and then head to "Project Settings" (1) and "Project Calendars" (2):
Only users with Administer Project permission can access that page.
As a result, you will be presented with such page view. Follow an advice presented to create your first project calendar (1):
Jira Administrators can create Global Calendars in "Add-ons" (1) section of Jira Administration, "Global Calendars" (2) link.
Adding Calendar Dates
Within calendar you can add days in which Scheduled Issues will not perform any action. This means, any planned executions in those days for Scheduled Issues using that calendar will be marked as "Calendar day off". However, it still will be possible to manually execute Scheduled Issue.
To add a calendar day off, open an existing calendar and press "Add day off" (1) button, in the pop up provide needed description and date, then click "Save" (2).
Using Calendar
Only one calendar can be assigned to a Scheduled Issue, you can do it on the third step of Create Scheduled Issue or Edit Scheduled Issue wizard (as presented here). It is possible to choose from Global Calendars or Project Calendars.
Scheduled Issues with calendar set, on the day of the planned execution that overlaps day off, in upcoming execution will be marked as being in state "Calendar Day Off" (1):
Upcoming scheduled issues executions, will show "Calendar day off" in "Action" column, meaning issue will not be created that day (1):
Default Calendars
It is possible to select "Default calendar" within each project and for the whole Jira (when setting up default Global Calendar). This means, during creating new Scheduled Issue, that calendar will be preselected by default.
After clicking on "Default (1), it is to be set as a one preselected automatically during scheduled issue creation wizard. To undo such action click on "Clear default" (it replaces "Default" state).