Posts Tagged ‘Tools’

Integrating Confluence and JIRA (part 2)

Posted in Confluence and JIRA, Tools on April 14th, 2011 by Jenny – 5 Comments

BachLast time, I left off at the point of displaying JIRA issues on a Confluence page. I’d found a way to insert single issues.

But I want to display a list of all the issues going into the release. The Atlassian documentation says to use the JIRA Issues macro, so that’s what I’ll try.

[Confluence 3.5, JIRA 4.3]

1. Create a search in JIRA for the issues you want to display

  1. In JIRA, click Issues to open the Issues Navigator.
  2. On the Summary tab, click Create new.
  3. In the panel, select your search parameters. I’ve picked the project, any issue type, the version, and a status of resolved.
  4. Click Search.
  5. Click View, and then select XML.
  6. Copy the URL from the address bar.

2. Insert the JIRA Issues macro on the Confluence page

  1. In Confluence, find the page where you want to add the list of JIRA issues.
  2. Click Edit.
  3. Click Insert, then select Other Macros.
  4. In the Search box, type “JIRA”.
  5. Click JIRA Issues.
  6. In the Insert JIRA Issues Macro window, in the URL field, paste the URL you copied from the JIRA search.
  7. In the JIRA Field Columns to Display field, type a comma-separated list of columns that you want to display.
  8. In the Title field, type a title for the table that will display the issues.
  9. Click Insert.
  10. Click Save.

Brilliant! That’s exactly what I want.

Now that I’ve got a list of issues displaying on my Confluence page, I need to set up a security scheme in JIRA so that I can control who sees the issues. I’ll let you know how that goes.


JIRA Issues Macro

Photo via Flickr user Brian Stocks


Integrating Confluence and JIRA

Posted in Confluence and JIRA, Tools on March 30th, 2011 by Jenny – 3 Comments

Northland, New ZealandSince our team is moving to JIRA for tracking bugs and enhancements, and we’re creating a new customer portal, possibly using Confluence, I’ve been thinking about ways to make our process for release notes smoother and more efficient.

Currently, we write up Word documents for each issue, and then compile the documents into a single document once we know which features are being added to the release. It’s a process that’s cumbersome and prone to error.

Instead, I’d like the team to document the issues in JIRA. Then we can pull the documentation from JIRA into a Confluence page, and use a report to find which corrections and enhancements have been included in the release.

That means getting the two applications to work together. I’ve upgraded Confluence to version 3.5, so I think this will be easy, but let’s see.

First I need to link the two applications together.

[Confluence 3.5, JIRA 4.3]

1. Add an application link in JIRA

  1. In JIRA, from the Dashboard, click Administration.
  2. Select JIRA Administration.
  3. Click Application Links.
  4. Click Add Application Link.
  5. Follow the instructions in the wizard.

2. Link a JIRA project to a Confluence space

  1. In JIRA, from the Dashboard, click Administration.
  2. Select the project.
  3. Click Configure Application Links.
  4. Click Add Link.
  5. Select Confluence.
  6. Select the space.

I’ve already created an issue in JIRA, so now I want to pull that issue into my Confluence page.

3. Display a JIRA issue on a Confluence page

  1. In Confluence, find the page where you want to add the JIRA issue.
  2. Click Edit.
  3. Click the Insert JIRA Issue icon.
  4. Select the issue.
  5. Click Insert.

Easy! But not exactly what I want.

What I want is a list of all the enhancements and corrections for a particular release. And I want our clients to see only the documentation about what’s new or updated, not the full history of each issue.

More to come next week…

Update: See part 2.

If you liked this post, consider subscribing to my RSS feed. Or have posts delivered via email. Thanks for visiting!

Photo via Flickr user Heike Quosdorf


Using the Windows Command prompt

Posted in Professional development on March 23rd, 2011 by Jenny – 5 Comments

kotareEvery time I install a program and the instructions tell me to open a Windows Command prompt, I groan. I can never remember how to move back and forth between folders, change to a different drive, see what’s in a directory. I know all you IT people out there are rolling your eyes, but for those of us who need a quick reminder, here is a cheat sheet for using the Command prompt. Since all this began with me upgrading from Confluence 3.4.8 to 3.5, I’ll use Confluence as an example.

To open the Command prompt window:

Windows 7

  1. Click the Start button.
  2. In the Search box, type cmd.
  3. Select cmd.exe from the results.

Tip: If you need to run the command prompt as an administrator, right-click cmd.exe
and select Run as administrator.

Windows XP

  1. Click Start, and then Run.
  2. Type cmd.
  3. Click OK.

To go back up a directory:

  • To go up one level, type cd ..\
  • To go up two levels, type cd ..\..\

To change to a different drive:

  • Type the drive letter and colon.
    For example, d:

To go forward in a directory:

  • Type cd foldername.
    For example, to change to the confluence-3.5-std folder, type cd confluence-3.5-std

To see what’s in a directory:

  • Type dir

To copy and paste text:

  1. Right-click in the Command prompt window and select Mark.
  2. Select the text you want to copy and press ENTER.
  3. Move the cursor to the place where you want to paste the text, right-click and select Paste.

After removing and reinstalling the Confluence Windows service over and over, and finally figuring out that I needed a new version of the Java JDK, I am now a Windows Command prompt pro! Well not really, but at least my Confluence 3.5 is up and running. Next I’ll be testing the integration with Jira!

Photo via Flickr user Dave Young