Atlassian JIRA Introduction to JIRA Issue and Project Tracking Software Tutorial 1

Once again, we are back with another tool tutorial. This time it’s the Issue and Project Tracking Software – Atlassian JIRA. You will learn JIRA issue tracking tool with this series of simple and easy to understand JIRA training tutorials.

*********************

For your convenience we have listed all the JIRA tutorials in this series:

Tutorial #1: Introduction to JIRA Issue and Project Tracking Tool
Tutorial #2: How Are Issues Handled in JIRA?
Tutorial #3: Creating and Working with Sub-tasks in JIRA
Tutorial #4: Managing Issues, Workflow Progress & Reporting Feature
Tutorial #5: Admin Aspects of JIRA Test Management Tool
Tutorial #6: Using JIRA for Managing Agile Projects

*********************

Before we get into what this tool is, how it can be used and who it is used by, I want to lay out some ground rules that will help us learn any tool easily and effectively in a short period of time.

Jira

I personally think that learning any tool has 2 phases to it:

  1. Understanding the underlying process
  2. Learning the tool itself- features/capabilities/shortcomings etc.

Take the case of JIRA. Think that you are a newbie and know nothing about it. You have heard about it from various friends, online references etc. You want to try your hand at it. How can you do that?

Ask yourself these questions: What kind of tool is it? Who uses it?

Tip:  When you are learning a tool (or any other software) and you want to get a non-technical description, Wikipedia is the best place to start. Since wiki is aimed at a general audience, the information will be easy for you to understand without being overwhelming.

JIRA is an Incident Management tool; what is Incident management? This is the stage when you forget all about the tool and work on the process.

Before we see more details about this tool, let’s get familiar to the incident management process.

Incident Management Process overview:

Any task that is to be completed can be considered an incident.

The top 10 Incident Management requirements are:

  1. An incident has to be created
  2. Additional information needs to be added to the incident to make the description comprehensive
  3. Each stage of its progress should be marked and moved along the steps until completion
  4. The stages or steps that the incident needs to go through should be defined
  5. It might be linked to other incidents or have some child incidents
  6. Incidents might have to be grouped according to some common rules
  7. Concerned people should be aware of the incident creation/change in the state
  8. Others should be able to provide their feedback on a certain defects
  9. Incident should be searchable
  10. Reports have to available, if we need to see any trends

Whether it is JIRA or any other incident management tool, they should be able to support these core 10 requirements and enhance them if possible, right?  In this series, we will look into how JIRA fares with respect to our list.

What is JIRA?

It is a defect tracking/project management tool by Atlassian, Inc., the current version is 6. It is platform independent.

You can download JIRA and try it free for 30 days at this page: Download JIRA

Who uses JIRA?

Software project development teams, help desk systems, leave request systems etc.

Coming to its applicability to QA teams, it is widely used for bug tracking, tracking project level issues- like documentation completion and for tracking environmental issues.  A working knowledge of this tool is highly desirable across the industry.

Basics about JIRA:

JIRA in its entirety is based on 3 concepts.

Atlassian JIRA

  1. Issue:  Every task, bug, enhancement request; basically anything to be created and tracked via JIRA is considered an Issue.
  2. Project:  a collection of issues
  3. Workflow: A workflow is simply the series of steps an issue goes through starting from creation to completion.

Say the issue first gets created, goes to being worked on and when complete gets closed. The work flow in this case is:

Atlassian JIRA workflow

Let us get hands on:

Once you create a trial, an OnDemand account gets created for you and you will be able to login to it.

Atlassian JIRA 1

------------

Once logged in, the dashboard page is displayed (unless otherwise chosen) to the user. The dashboard page gives a snap shot about the description of the project you belong to; issue summary and the activity stream (the issues that are assigned to you, the issues that you created etc).

Atlassian JIRA 2

Tip:  When you are trying to create/modify a certain issue under a project for the first time, it really helps to know about the project itself.

You can do that by going to the main menu and choosing the Project name from the “Projects” drop down.

Atlassian JIRA 3

We defined earlier that a project is a collection of issues. Item number 6 in our list – the feature that enables the grouping of the issues is fulfilled with this concept. Projects have components and versions under it.  . Components are nothing but subgroups within a project based on common grounds . Also, for the same project, different versions can be tracked.

Every project has the following main attributes:

  1. Name – as selected by the administrator.
  2. Key- It is an identifier that all the issue names under the project are going to start with. This value is set during the creation of a project and cannot be modified later even by an administrator.
  3. Components
  4. Versions

For instance, take a web based application; there are 10 requirements that need to be developed. There will be 5 more features added to it later on. You can choose to create the project as “Test for STH” version 1 and Version 2.  Version1 with 10 requirements, version 2 with 5 new ones.

For version 1 if 5 of the requirements belong to Module 1 and the rest of them belong to module 2. The module 1 and module 2 can be created as separate units

Note: Project creation and management in JIRA is an admin task. So we are not going cover project creation and will continue the discussion using an already created project.

Taking the details in the above example, I have created a project in JIRA called “Test for STH”, the key is “TFS”. So, if I create a new issue, the issue identifier will start with TFS and will be “TSH-01”. We will see this aspect in the next session when we create issues.

The following is how the Project details are displayed in JIRA: (click to enlarge images)

JIRA Tutorial

Please note the left hand side navigation.

When I choose the “Components” option, it displays the two components within the project:

JIRA Tutorial 1

When I choose the versions option, the versions within the project are displayed

JIRA Tutorial 2

Choose Roadmap option, the version information is displayed along with dates giving a general idea about the important milestones in the project.

JIRA Tutorial 3

Choose the calendar option to view the milestones date wise:

JIRA Tutorial 4

At this point, there are no issues created for this project. If there were, you will be able to see all of them by choosing “Issues” from the left navigation menu.

We will learn all about working with issues in JIRA in the next session. Please free to post your questions and comments below.



The Best Software Testing Training You'll Ever Get!

software testing QA training

27 comments ↓

#1 Dahir mohamud on 10.02.13 at 4:50 am

it is nice to know jira thanks anyway

#2 Pravin on 10.02.13 at 9:35 am

Hi,
I click on Download link, it’s display the Try jira 30 for days free here two options
1) OnDemand
2)Download
so witch version i download
plz help me
Thanks.

#3 Anojan on 10.02.13 at 12:01 pm

I have been using JIRA for nearly 18 months :) Your explanations about the tool are good!

#4 jayashree on 10.02.13 at 1:53 pm

awesome job sir!!1
Detailed explanation of JIRA

#5 jayashree on 10.02.13 at 2:08 pm

Iam looking for the job ?
can you give some interview question frequently asked?

#6 Swati Seela on 10.03.13 at 1:15 am

@Pravin: Choose the OnDemand version, because it is much more easier and won’t need any installation.

#7 Word unusual on 10.03.13 at 6:10 am

This was a fantastic read! I use this at work now! :) Thank you as always.

#8 S.Dhevi on 10.03.13 at 10:19 am

I am very happy to see Jira on your website. Its very informative. Looking anxiously for future articles. STH is providing us so much valuable information selflessly….good going
One more suggestion please from my side, after Jira please could u also provide some articles on Bugzilla also…..Please……
Thanks in advance…….:-)

#9 Sibu S on 10.03.13 at 11:34 am

Very useful section thanks for choosing JIRA many thanks to vijay. Waiting for next tutorial

#10 varaprasad on 10.03.13 at 12:45 pm

Iam newbie to jira and i learned a few basic steps in this article..

Thanks
varaprasad

#11 Mohan.G on 10.05.13 at 6:13 am

My sincere thanks to u for providing this Valuable JIRA tutorial.

#12 Amandeep Singh on 10.05.13 at 9:53 am

A good start for newbies to start working on a new tool…

#13 Jai on 10.08.13 at 7:48 am

Hi ,
during jira installatin got below hard message “The HTTP port 8080 you have chosen appears too be in use.
Please choose a different port number”. Please help me out to get resolved.
Regards
Jai

#14 Abhi on 10.08.13 at 12:21 pm

I am using Jira for last few months. It is nice tool. Thanks for the explanation. It is quiet elaborate.

#15 Swati Seela on 10.08.13 at 6:33 pm

@Jai: please try using the Ondemand version. You will not need any installation. Let me know how that goes

#16 Jai on 10.15.13 at 12:22 pm

@ Swati:
Thanks, Now i am able to proceed.

#17 Sai Bhavana on 10.26.13 at 4:01 am

Hi Vijay,
I have completed payment for the Software testing career package book today. Wondering when I should receive it.Thanks!

#18 Vijay on 10.26.13 at 12:44 pm

It’s been sent to your email address. I hope you will enjoy reading it.

#19 parveen on 11.20.13 at 9:51 am

hi,

in how many days a manual tester can learn the jira tool.
and if anybody have notes for jira
please share on my email-id
parveen.syal@gmail.com

#20 Daniel on 02.07.14 at 12:55 am

It’s very useful and comprehensive section.

Thanks!

#21 sanoj on 02.12.14 at 1:53 pm

you are just awesome sir..good going…your article is so informative..thanks.

#22 Ramanachinnathoti on 03.05.14 at 5:26 am

Great article sir, this is very helpful for testing professionals

#23 sandeep singh negi on 03.07.14 at 3:23 pm

i our office we are using this JIRA tool but it’s customized version. actually we are not able to see these menus as per the screen.

#24 Jerin on 03.13.14 at 12:57 pm

Good article.Keep writing post like this.This was very helpful to me.

#25 Ali on 04.13.14 at 3:55 am

When I click download, system required some information including payment information. After expiry of 30 day free trail, Jira will charge me $10/month? Can anybody share me the experience about charge. Thanks Vijoy!

#26 Jagadish Bisalegowda on 06.25.14 at 10:11 am

Thanks Vijay.
You explain it in very simple manner

#27 Kannan Manoharan on 07.22.14 at 5:59 pm

Hello vijay,
Currently i’m working on project with JIRA. It’s been really helpful for me to understand about it well. Thank you so much.!!

Leave a Comment