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.
- Go to your Confluence URL in your browser. For example,
http://www.foobar.com:8090/confluence
. - Choose Browse > Confluence Admin.
- Click Plugins in the left-hand panel.
- The plugin management screen will appear. Click the Install tab.
- Enter '
team calendars
' into the Search the Plugin Exchange text box, and click Search. - Click the Team Calendars for Confluence plugin name in the list of plugins.
- The plugin details will appear. Click Install Now.
- 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.
- Open the user options menu under Charlie's name by clicking Charlie of Atlassian, then choose Calendar.
- Follow the prompts to choose a time zone, view the welcome message and add a People Calendar.
- 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.
- Name:
- Click OK to create the calendar.
- The 'Congratulations' screen will appear. Click Add to add an event to the calendar.
- 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.
- Calendar:
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.
- Make sure that you are still on the 'My Calendars' screen. Choose Add Calendar > New Calendar.
- Click JIRA Calendar.
- Enter the following information:
- Name:
Dragons
- Description:
Dragons JIRA calendar
- Related space:
Dragons
- Project:
Dragons
- Show – Select Issue Due Date and Version Due Date.
- Name:
- Click OK to create the calendar.
- Click Close.
- 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 Administration > Projects > Dragons.
- 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.
- Go to your JIRA URL in your browser. For example,
- 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.)
- 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
- 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.)
- Edit the page.
- Place your cursor after the Charlie badge at the top of the page, and press Enter to create a new line.
- 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. - Press Enter to start a new line, then start typing:
{calendar,
to add a Team Calendars macro.
- The 'Macro suggestions' dropdown list will appear. Select Team Calendars. (Or open the Macro Browser and find the macro manually.)
- 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
- Calendar:
- Click Insert to add the calendar to the page.
- 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
|