By Derek Fields, Rightstar

Calendar Management

For those of us who administer Service Level Agreements (SLAs) in Jira Service Desk , the ability to associate a calendar with an SLA is critical to configuring the SLA. Out of the box, JSD comes with 2 calendars: a 9-5 weekday calendar and a 24×7 calendar. For most of us, this is all we need. When you configure a calendar, you indicate the days of the week that will count against an SLA and the hours of each day that are included. Naturally, for the 24×7 calendar, the SLA is always counting. For the 9-5 weekday calendar, this is 9am to 5pm (or 17:00) Monday through Friday. Changing these calendars or adding a new one is simple.

Setting the Working days and hours

What has not been as simple is adding in the holidays that need to be accounted for in the SLA. For instance, you probably don’t want to count Christmas or New Year’s Day against your SLA. This has required filling out the holiday calendar each year. Only those days that recur on a specific day can be entered regularly. However, this doesn’t work for holidays whose observance moves each year, such as Thanksgiving Day in the US and Canada.

Fortunately, starting in JIRA Service Desk 4.4, Atlassian has added a much needed capability to import a holiday calendar. They support the Internet Calendar and Scheduling (ICS) format (.ics files). There a several free sources for holiday calendars for many different countries. Having looked through several sites, the best one appears to be (Note, I have no connection with this organization). When you look for an ICS calendar, make sure that you can download it, not just subscribe to it. There are ways to download a subscribable calendar – those are outside the scope of this article.

Once you have downloaded the .ics file, click on Import Holidays under the holidays section and import that file.

Click on Import holidays

This will provide you with a list of holidays that are defined in this file. As you can see in the image below, using the 2020 U.S.A holiday calendar, there are holidays that we don’t need to include in our file such as Valentine’s day, Mother’s Day,  and Father’s Day (we love you all, but these don’t affect our SLAs).

Shows the imported list of holidays

You can remove these from your holiday calendar by clicking on the “x” to the left of the holiday. Then click import and you will have an updated list of holidays for your specific location.

Edit the list of holidays that you want to keep

This makes setting up our calendars so much easier than in the past.