» Project Kenai Documentation and Training    » How Do I ...   »About Issue Tracking

Using the Jira Issue Tracker

If your project uses the Jira issue tracking system for tracking bugs and feature requests, you see a Jira page open when you click Issue Tracking on your project page.

This page describes how to report a bug, find bugs, and create and use a filter to restrict searches to your project. For general help on Jira, click the Help button at the top right of the Jira page.

Reporting a Bug for a Project

To report a bug for a project:

1. Click My Page in the left navigation bar.
   
   
   
   
2. Scroll to your project listing and click Issue Tracking in the list of features on the right.
   
   
   
   
3. The Jira page for that project opens.
   
   
   
   
4. Click Create New Issue (see figure above).
   Note: If you can't create a new issue, you might need to log in by clicking Log In at the top right of the page. If you see Log Out in that location, you're already logged in. In that case, you might not have permission to create issues in this project and will need to contact a project administrator.
5. Ensure that the project name is correct and select what type of issue you're reporting from the Issue Type droplist (most likely the default, Bug).
   
   
   
   
6. Click Next. The Create Issue panel opens.
   
   
   
   
7. Fill in the required fields, especially Summary, Priority, and Description.
   
   Note: The Jira editor for the Description field supports wiki-like text formatting markup. For some quick help on text formatting, see the section below, Jira Text Formatting.
8. At the bottom of the form, click Submit.
9. If you've forgotten to fill in anything important, you'll see a message saying so. Otherwise, you see your new bug.

Finding and Viewing Issues

To see which issues are open, follow the instructions above in Reporting a Bug for a Project to get to the Jira issue tracker, where you will see the main Jira page for your project (shown above). If you do not see the main Jira page for your project, click Browse Project in the top navigation bar to go there.

You can navigate to bugs from the list of categories or versions on the main page, or you can use the bug search tool, Find Issues, if there are too many bugs to browse through. If you already know the bug number, you can enter it in your browser's address line using the following syntax:
    http://java.net/jira/browse/[bug-id]

For example, the following URL goes to a bug in the coolphpcollabtool project:
    http://java.net/jira/browse/COOLPHPCOLLABTOOL-3

Note: The Jira URL uses the project name from the Project Kenai project URL:
    http://java.net/projects/coolphpcollabtool

To find bugs with the Find Issues tool:

1. Click Find Issues in the toolbar at the top of the page, and then click Create new search.
   
   
   
   
2. Select your project from the list of projects, then click Click here in the blue information box to update the search list.
   
   
   
   
3. To open an issue, click it in the list of returned issues.
   
   
   
   
4. With the bug open, you can read it and, if you have enough privilege in the project, comment on it or edit it..
   
   
   
   

Creating and Using a Filter

When you search for issues in your project, the first thing you have to do is select your project from the list of projects, which limits the search to just your project. To save yourself this extra step, you can save this search as a filter and then reuse it every time you do a search for issues in your project.

To create, save, and use a Jira project filter:

1. Click My Page in the left navigation bar, then scroll to your project listing and click Issue Tracking in the list of features on the right.
   
   
   
2. In the Jira window that opens, click Find Issues, and then click Create new search.
   
   
   
   
3. Select your project from the list of projects, then click Click here in the blue information box to update the search list.
   
   
   
   
4. Leave all other settings unchanged and click the View button to submit the search.
   
   
   
   
5. Above the search box, you see Save it as a filter. Click Save.
   
   
   
   
6. In the Save Current Filter dialog box, give the filter a name, such as your project name, and an optional description, then make sure the Favourite star is yellow and click Save.
   
   
   
   
7. The filter is saved as a favorite, which means that to reuse it, all you have to do is click Filters > filtername. For example, the filter saved for the Cool PHP Collbaration Tool project was named coolphpcollabtool, which is selected in the figure below.
   
   
   
   
8. If you want to edit or delete your filters, choose Filters > Manage Filters.
   
   

• For more help on filters, see the Jira help page Saving Searches ('Issue Filters') or click the help button on the Manage Filters panel.
• For general help on Jira, click the Help button at the top right of the Jira page.

Jira Text Formatting

When you file a Jira issue, you can use text formatting markup in the Description field that is similar to wiki markup. The following table shows some frequently used markups. For a complete list, see http://jira.atlassian.com/secure/WikiRendererHelpAction.jspa?section=all.

Markup		Result
_italic_		italic
*bold*		bold
*_bold and italic_*		bold and italic
		monospaced
[http://java.net]		http://java.net
[Project Kenai|http://java.net]		Project Kenai
[mailto:nobody@java.net]		mailto:nobody@java.net
		red text green text blue text yellow text
(empty line)		Produces a new paragraph.
\\		Creates a line break. Not often needed, most of the time the renderer will successfully guess new lines.
* bulleted item * another bulleted item ** indented bulleted item ** another indented bulleted item * back to main bullets *# embedded numbered list *# embedded step 2 * last main bulleted item		bulleted item another bulleted item indented bulleted item another indented bulleted item back to main bullets embedded numbered list embedded step 2 last main bulleted item
# numbered list, first step # step 2 of main list ## embedded numbered list ## step 2 of embedded list # step 3 of main list #* embedded bulleted list #* another bulleted item # step 4 of main list		numbered list, first step step 2 of main list embedded numbered list step 2 of embedded list step 3 of main list embedded bulleted list another bulleted item step 4 of main list
preformatted section of text-- *no* further _formatting_ is done here {noformat}		preformatted section of text-- *no* further _formatting_ is done here
\char i.e. \_not italic\_		Escape a normally interpreted character char. i.e. _not italic_
:) :( :P :D ;) (y) (n) (i) (/) (x) (!) (+) (-) (?) (on) (off) (*) (*r) (*g) (*b) (*y)		Emoticons

How to use Eclipse Mylan with Java.net JIRA

 - Action: Add new Task Repository, select type: choose JIRA connector
 - in Dialog: Task Rep properties
 - server: https://java.net/jira (+ credentials)
 - on validate settings and message dialog "location does not match" choose "keep location" and ok
 - click "finish"
 - in list of repositories, right click on newly created repository and "update rep configuration" (might take minutes, didn't here)
 - create query (as always, follow wizard)
 - wait ...