Atlassian Integration Guide : Dragons Stage 4 - Install Team Calendars in Confluence


It's like having a date with a flame thrower! You are embarking on stage 4 of the Atlassian Dragon Quest.

In this stage, you will add Team Calendars to Confluence, so that you can see a consolidated view of team leave, project due dates, and other team events. Team Calendars is a plugin for Confluence.

Time estimate: This stage will take approximately 15 minutes.

On this page:

Step 1. Install Team Calendars

In this step you will install the Team Calendars plugin into Confluence.

  1. Go to your Confluence URL in your browser. For example, http://www.foobar.com:8090/confluence.
  2. Choose Browse > Confluence Admin.
  3. Click Plugins in the left-hand panel.
  4. The plugin management screen will appear. Click the Install tab.
  5. Enter 'team calendars' into the Search the Plugin Exchange text box, and click Search.
  6. Click the Team Calendars for Confluence plugin name in the list of plugins.
  7. The plugin details will appear. Click Install Now.
  8. Set up your Team Calendars license key:
    • Click Team Calendars in the 'Administration' section of the left-hand panel. (Refresh the screen if the option does not appear immediately.)
    • The 'Team Calendars' administration screen will appear. Click the License Configuration tab.
    • Paste your Team Calendars license key into the License textbox. If you do not already have a Team Calendars license, click Generate evaluation license (open the link in a new browser window or tab) and follow the prompts to get an evaluation license key.
    • Click Update.

Full details are in the Team Calendars Installation Guide.

Step 2. Add a People Calendar

In this step you will add a calendar where Charlie and his team can keep track of their leave.

  1. Open the user options menu under Charlie's name by clicking Charlie of Atlassian, then choose Calendar.
  2. Follow the prompts to choose a time zone, view the welcome message and add a People Calendar.
  3. The 'Create People Calendar' screen will appear. Enter the following information:
    • Name: Team leave
    • Description: Charlie's team leave calendar
    • Related space: Dragons
    • Time zone – Leave the default value.
  4. Click OK to create the calendar.
  5. The 'Congratulations' screen will appear. Click Add to add an event to the calendar.
  6. Enter the following information:
    • Calendar: Team leave
    • Who: Charlie of Atlassian (charlie)
    • When – Leave the default value (today's date).
    • Leave the other fields at their default values too.
    • Click OK.

Step 3. Add a JIRA Calendar

In this step you will add a JIRA calendar where Charlie and his team can keep track of their JIRA issues.

  1. Make sure that you are still on the 'My Calendars' screen. Choose Add CalendarNew Calendar.
  2. Click JIRA Calendar.
  3. Enter the following information:
    • Name: Dragons
    • Description: Dragons JIRA calendar
    • Related space: Dragons
    • Project: Dragons
    • Show – Select Issue Due Date and Version Due Date.
  4. Click OK to create the calendar.
  5. Click Close.
  6. Now you will schedule a JIRA issue and a JIRA version for today, so that you can see the events from both calendars showing on the same date.
    • Go to your JIRA URL in your browser. For example, http://www.foobar.com:8080.
    • Go to your JIRA dashboard and click the DRA-5 issue key in the 'Assigned to Me' gadget.
    • The issue details screen will appear. Edit the issue and set the Due Date to today's date.
    • Choose AdministrationProjectsDragons.
    • The project administration screen will appear. Click Versions in the left-hand panel.
    • Hover your cursor in the Release Date column for version 2.0.S2, and click the prompt to Add release date.
    • Change the release date to today's date.
    • Click Update.
  7. Go back to the 'My Calendars' screen in Confluence, and refresh both calendars. (Click the downward-pointing arrow next to the calendar and choose Refresh.)
  8. Click Month  to see the monthly calendar view. It will show three events for today's date:
    • Charlie's day of leave, from the People calendar.
    • The due date for sprint 2.0.S2, from the JIRA calendar.
    • The due date for issue DRA-5, from the JIRA calendar.
      At this point, Charlie realises that he's playing with fire by scheduling a day's leave on the same day as the release is due.

Screenshot 1 (click to enlarge): Team calendars


Step 4. Add Team Calendars to your Confluence Home Page

In this step you will add a Team Calendars macro to the home page in your Dragons space, showing events from the two new calendars

  1. Go to the 'Home' page of your 'Dragons' space in Confluence. (Type 'Home' into the Confluence search box and choose the 'Home' page from the dropdown list.)
  2. Edit the page.
  3. Place your cursor after the Charlie badge at the top of the page, and press Enter to create a new line.
  4. Enter the following text, and format it as a heading level 2: My calendar
    Hint: Press Ctrl+2 or Cmd+2 as a keyboard shortcut to format a heading level 2. Click the question mark on the right of the editor toolbar to see all the keyboard shortcuts.
  5. Press Enter to start a new line, then start typing: {calendar, to add a Team Calendars macro.
  6. The 'Macro suggestions' dropdown list will appear. Select Team Calendars. (Or open the Macro Browser and find the macro manually.)
  7. The 'Insert Team Calendars Macro' screen will appear. Enter the following information:
    • Calendar: Dragons
    • Calendar (add a second entry in the same box): Team leave
    • View: month
  8. Click Insert to add the calendar to the page.
  9. Save the page.

Victory!

You now have a consolidated view of events in a team leave calendar and a JIRA calendar.

Screenshot 2 (click to enlarge): Charlie's team calendars displayed on a Confluence page


Problems? Please raise a support ticket for the product you're stuck on, or see answers from the community.
Victory? Please continue.

Grab your shield and move to the next stage

Attachments: