jira用戶使用指南
第一章、前言
JIRA 是澳大利亞 Atlassian 公司開發的一款優秀的問題跟蹤管理軟件工具，可以對各種類型的問題進行跟蹤管理，包括缺陷、任務、需求、改進等。JIRA采用J2EE技術，能夠跨平臺部署。它正被廣泛的開源軟件組織，以及全球著名的公司使用。
JIRA產品非常完善且功能強大，安裝配置簡單，多語言支持、界面十分友好，和其他系統如CVS、Subversion（SVN）、VSS、LDAP、郵件服務整合得相當好，文檔齊全，可用性以及可擴展性方面都十分出色，擁有完整的用戶權限管理。
您可在JIRA中國網站 http://www.fangwai.net 上了解到JIRA 更為詳細的信息。
此文檔主要介紹了JIRA產品的特性、安裝配置、基本概念及操作。為您評估使用JIRA提供一個基本的指南。另外，本文檔中介紹的部分功能是JIRA企業版獨有的，如：項目類別管理功能、設置模塊負責人。
第二章、JIRA介紹
跟蹤并管理在項目開發和維護過程中出現的問題（如：缺陷、新特性、任務、 改進等）是項目管理很重要的任務，但是很少有團隊能做的很好。 JIRA作為一個專業的問題跟蹤系統可以幫助您把缺陷管理起來，讓跟蹤和管理在項目中發現的問題變得簡單，而且充分利用JIRA的靈活配置和擴展特性，可以將JIRA作為一個項目管理系統或者IT支持系統。
2.1 JIRA 的特性
1) 管理缺陷，新特性、任務、改進或者其他任何問題
2) 干凈和強大的用戶界面
3) 靈活的工作流定制
4) 全文搜索和強大的過濾器
5) 企業級的權限和安全控制
6) 非常靈活的郵件通知配置
7) 可以創建子任務
8) 方便的擴展及與其他系統集成：包括 email 、LDAP 和源碼控制工具等；
9) 豐富插件庫
10) 項目類別和組件/模塊管理
11) 可以在幾乎所有硬件、操作系統和數據庫平臺上運行
2.2 JIRA 的版本
為了適應不同用戶的使用需求，JIRA產品提供三種版本，分別為：標準版，專業版和企業版，這三種版本在功能上有區別。企業版的功能最全，含蓋了標準版和專業版的全部功能并有較多增強的功能，專業版則包含了標準版的全部功能并有一些增強功能，標準版本是JIRA的基礎版本。
2.2.1 企業版
是為企業級用戶設計的，它與標準版，專業版相比，具有以下一些獨有的、重要的功能：
1)項目類別管理功能：可以將相關的項目分組管理。
2)組件/模塊負責人功能：可以將項目的不同組件/模塊指派相應的負責人，來處理所負責的組件的Issues。
3)項目email地址功能：每個項目可以有不同的email（該項目的通知郵件從該地址發出）。
4)LDAP配置器：用于將JIRA連接到公司的LDAP目錄上。
5)Issue安全級別：在一個項目里可以精確地控制對Issue的訪問。
6)無限制的工作流：可以創建多個工作流為不同的項目使用；
2.2.2 專業版
是為部門級設計的。它不具備JIRA企業版獨有的功能，但是它與JIRA標準版相比多出了如下幾個方面的功能：
1)子任務功能：可以在某個Issue下創建子任務；
2)共享過濾器功能：一個團隊成員可以訪問共享的過濾器；
3)Multiple dashboards功能：可以定制自己的JIRA顯示面板；
4)工作流編輯功能：可以對workflow進行編輯；
5)無限制的CVS repositories。
2.2.3 標準版
是為工作組級別設計的。它不具備上述的JIRA專業版和企業版的增強功能，具有JIRA的標準功能.
2.3 JIRA中涉及的角色
JIRA作為一個缺陷跟蹤管理系統，可以被企業管理人員，項目管理人員，開發人員，分析人員，測試人員和其他人員所廣泛使用。
2.3.1管理人員
根據JIRA系統提供的數據，更加準確地了解項目的開發質量和狀態，以及整個團隊的工作效率。
2.3.2項目管理者
可以針對登記進JIRA系統中問題，進行評估，分配缺陷；還可以通過JIRA系統的統計報告了解項目進展情況以及團隊的工作量、工作效率等信息。
2.3.3開發人員
在JIRA系統中查看分配給自己的問題，及時進行處理，填寫處理情況并提交工作量記錄。
2.3.4 測試人員
根據測試情況，在JIRA系統中及時快速的記錄問題并對開發人員處理后的問題進行驗證和跟蹤。
第三章、安裝JIRA
JIRA系統是一個'web應用’，就是說JIRA是需要安裝到服務器上運行，客戶端在自己的計算機上通過web瀏覽器（如：IE）來訪問JIRA。因此安裝JIRA的需要條件主要是和服務器有關。
3.1安裝Standalone發布包
Standalone發布包集成了應用服務器（Tomcat）和HSQL數據庫，僅需要Java環境，簡單點兒說就是要安裝JDK1.3以上版本；建議以前沒有接觸過JIRA的用戶使用Standalone發布包。JIRA的Standalone發布包安裝非常簡單，您只需要從http://www.fangwai.net網站上下載最新的Standalone版本，然后解壓縮到本地硬盤上（需要注意的是不要使用WinXP系統自帶unzip功能），然后運行\bin目錄下的startup.bat腳本文件就可以啟動JIRA了。
運行startup腳本后，在web瀏覽器中訪問：http://localhost:8080/ 然后根據瀏覽器界面上的JIRA配置向導，經過三個配置步驟就完成了：
第一個步驟是配置JIRA系統的屬性；
第二個步驟是配置JIRA系統管理員的信息；
第三個步驟是配置JIRA系統的郵件通知參數。
讓我們在幾分鐘內就搭建好Standalone版本的JIRA，并運行在您的系統上。
在*標題輸入中輸入您安裝的JIRA系統的標題信息；
在*模式下拉框中有兩個選項：public和private。表示JIRA可以運行在兩種模式下。Public模式－在這種模式下用戶可以自己注冊到JIRA系統中，并可以創建問題；
Private模式－表示安裝的JIRA系統是私有的，不允許用戶隨意注冊，只能由JIRA系統管理員來創建用戶、分配權限。
*根網址，表示您安裝的JIRA系統的訪問地址，用戶在瀏覽器中通過這個URL來訪問；
“*索引路徑”輸入框中輸入保存JIRA系統索引數據的目錄,如：d:\jira\indexs
Enable Backups，選擇“是”啟用JIRA系統的自動備份功能；
“附件路徑”輸入框中輸入保存與問題關聯的附件文件的目錄,如：d:\jira\attachments
“備份路徑”輸入框中輸入保存JIRA備份文件的目錄,如：d:\jira\backups （JIRA提供了定期自動備份的功能，自動備份的文件就存儲在這個目錄下。）
“授權碼”輸入框中輸入評估license，如果沒有的話，可以在安裝界面上點擊“在線”鏈接生成一個評估license，輸入評估license后，點擊“下一步”按鈕開始第二步配置。
說明：您可能已經注意到了JIRA的安裝界面右邊有“Choose Language”列出了十幾個國家的國旗圖標，表示JIRA系統目前支持的語言種類，中文是默認的安裝語言，如果您希望安裝完成后，JIRA系統的用戶界面是其他語言，那您可以在此選擇一下。值得一提的是在安裝完成后，用戶也可以根據自己的需要和喜好，通過修改自己的配置參數來改變JIRA界面的顯示語言，不影響其他用戶的界面顯示語言。
分別輸入JIRA系統管理員的登錄用戶名、密碼、全稱以及管理員的郵件地址。然后點擊“下一步”按鈕進入第三步的配置。
您可以根據具體情況填寫郵件通知的配置信息。如果您不希望JIRA系統與郵件系統集成來提供郵件通知功能，那么您可以點擊“禁止郵件通知”按鈕。
在網址輸入框中輸入郵件服務器的域名或者IP地址，如：smtp.fangwai.net
SMTP端口通常填寫為25（這個郵件服務器發送郵件的默認端口）；
用戶名輸入框中填寫一個郵件的帳號，如：plum
密碼輸入框中填寫與上面郵件帳號對應的密碼。
然后點擊“完成”按鈕，結束JIRA的配置。
注：JIRA支持一個SMTP的郵件服務器以及若干個POP/IMAP郵件服務器。通過SMTP郵件服務器，JIRA會發郵件給訂閱系統事件或者被分配Issue的用戶。通過POP/IMPA郵件服務器，使用者可以通過email建立新的Issue或者對已有的Issue發表評論，非常方便，解決了許多項目團隊中信息分散的問題。
3.2 瀏覽器要求
JIRA支持各種主流的web瀏覽器，如：IE6、Mozilla、Firefox、Opera、Safari等。
3.3 操作系統要求
JIRA的運行需要Java環境，Java是一個跨平臺的編程語言，因此所有支持Java的操作系統上都可以運行JIRA，當然也需要考慮操作系統上是否支持您選擇的應用服務器軟件。目前Sun的JDK有Windows(32位和64位)，Solaris（APARC 32位和64位），Linux平臺（32位和64位)。
3.4 JIRA支持的應用服務
1)OrionServer
2)Resin
3)Tomcat
4)JBoss
5)Jetty
6)Oracle OC4J
7)Weblogic
3.5 JIRA支持的數據庫
1)Oracle
2)DB2
3)MySQL
4)Firebird
5)SQL Server
6)SapDB
7)PostgreSQL
8)Sybase
第四章、JIRA中的概念
4.1問題
JIRA跟蹤問題（Issue），這些問題可以是bug，功能請求或者任何其他您想要跟蹤的的任務；每一個問題有一些關聯的信息：
-問題類型（Issue Type）
-摘要（summary）
-問題描述（description）
-問題所屬的項目
-問題關聯的項目組件（component）
-問題影響的項目版本（affect version）
-問題將被解決的項目版本（resolved version）
-問題發生的環境
-問題的優先級
-問題的報告者
-問題的指派處理人
-問題的當前狀態
-問題相關的歷史記錄
4.1.1問題類型
JIRA系統可以用于跟蹤多種不同類型的問題。系統管理員可以根據需要添加。JIRA系統缺省提供的問題類型如下：
Bug 測試過程、維護過程發現影響系統運行的缺陷
New Feature 對系統提出的新功能
Task 需要完成的任務
Improvement 對現有系統功能的改進
4.1.2優先級（Priority Levels）
在JIRA系統中用優先級來表示問題的嚴重級別。系統管理員可以在JIRA系統中添加優先級，JIRA系統缺省的優先級如下：
Blocker 阻塞開發或測試的工作進度，或影響系統無法運行的錯誤
Critical 系統崩潰，丟失數據或內存溢出等嚴重錯誤、或者必需完成的任務
Major 主要的功能無效、新增功能建議
Minor 功能部分無效或對現有系統的改進
Trivial 拼寫錯誤，文本未對齊等
4.1.3 狀態（Status）
每個問題有一個狀態，用來表明問題所處的階段，問題通過開始于open狀態，然后開始處理/Progress，再到解決/Resolved，然后被關閉/Closed。根據情況的不同，您可以根據項目來定制問題狀態以及工作流。JIRA系統提供的缺省狀態如下：
Open 表示問題被提交等待有人處理。
In Progress 問題在處理當中，尚未完成。
Resolved 問題曾解決，但解決結論未獲認可，需要重新分派解決。
Reopened 問題解決，等待結果確認，確認的結果是“Reopened”或者“Closed”。
Closed 問題處理結果確認后，置于關閉狀態。
4.1.4 解決（Resolutions）
一個問題可以用多種方式解決，系統管理員是可以在JIRA系統中定制解決方式。JIRA系統默認的解決方式如下：
Fixed 問題已經解決。
Won’t Fix 問題未解決 - 將不會解決的問題。
Duplicate 重復的問題。
Incomplete 問題描述得不夠準確、完全。
Cannot Reproduce 問題重現失敗，或者無足夠的信息重現問題。
4.2 項目
一個JIRA系統通常包含許多項目。這些項目相當于產品或者開發項目，您想要跟蹤和這些項目相關的問題。每一個問題屬于一個項目。每一個項目有一個名字和一個關鍵字（如：WEB），以后屬于這個項目的問題的關鍵字就會包含WEB（如：WEB-100，WEB-101）。值得注意的是，在JIRA系統中有一個權限'Administer Projects’，通常將這個權限賦給項目負責人，擁有這個權限的JIRA用戶就可以管理項目的'版本’和'組件’。
4.2.1 項目版本
在一個項目上，一般會有多個版本，如：1.0alpha、1.0beta、1.0、1.2、2.0。
JIRA系統中的問題涉及到兩個版本字段：
-影響版本，如一個bug可能影響版本1.1和1.2。
-修復版本，如bug影響版本1.1和1.2，可能在2.0版本上被解決。
版本通常有三種狀態：發布/released、未發布/unreleased和歸檔/archived。版本還有發布日期，在特定的報告中會顯示。在JIRA系統中可以為項目創建版本。
4.2.2 項目組件
每一個項目通常會包含多個組件/模塊，如：后臺，GUI，郵件子系統等等。一個問題可以和組件關聯起來。在JIRA系統中可以為項目添加組件。
4.3 分配給
分配給/Assign To：把某個問題Issue指定給某個團隊成員去解決；
4.4 上傳附件或屏幕截圖
Attach file/Screenshot：附加文件或屏幕截圖說明issue；
4.5 問題投票
投票/Voting：除了問題的創建人，其他人可以用投票來表明支持某個問題的內容；
4.6 監視問題
Watching：每人都有一個Watch List/監視列表，可以監視自己感興趣的Issue的狀態等。
第五章、使用JIRA
5.1 登錄和注冊
在成功安裝配置完成后的界面上點擊“登錄到JIRA”,就會看到JIRA的登錄界面了：
輸入系統管理員的用戶名和密碼就可以登錄JIRA系統。當然也可以點擊“注冊”鏈接在JIRA系統中注冊另外的用戶帳號。JIRA系統的注冊帳號
輸入系統管理員帳號信息后登錄JIRA系統.
5.2 創建新項目
現在可以算是正式開始使用JIRA了。在剛剛配置完的JIRA系統中是沒有任何項目的，通常開始使用JIRA首先是創建項目，在上面的界面上點擊“現在創建一個項目”，在界面上輸入項目的名稱，關鍵字/Key，項目負責人，項目的描述信息，通知模型/Notification Scheme，權限模型/Permission Scheme。最初使用的時候可以暫時不用管網址和Issue Security選項。Notification Scheme和/Permission Scheme可以分別選擇JIRA系統缺省的Default Notification Scheme和Default Permission Scheme。
項目的信息填寫完成后，點擊“增加”按鈕就會看到您在JIRA系統中創建的新項目的詳細信息界面;
接下來，您可以在項目的詳細信息界面上，為項目創建組件/模塊（Components）,管理項目的版本。如要創建組件，可點擊Component下方的“Add”鏈接，如要管理項目的版本（Versions），可點擊Versions下面的“Manage”鏈接。
注意：新項目創建完成后，項目的關鍵字/key（如：上面界面圖中項目的Key：KM）是不能修改的。
如果您想要繼續創建新項目，則可以點擊左側的“項目”鏈接，然后再點擊“Add Project”鏈接。
5.3 創建項目類別
在使用JIRA過程中，會有越來越多的項目被添加到JIRA系統中，這時候可以利用JIRA系統的項目類別功能（Project Categories），定義一些項目類別名稱，然后將同類的項目歸到一個類別里面，方便管理。
在項目詳細信息界面上可以找到Project Category: 無 ( Select Category ) 點擊“Select Category”鏈接，選擇一個項目類別，這樣就把該項目添加到所選擇的項目類別里了。把項目添加到項目類別后，在JIRA系統的首頁上可以看到的效果;
5.4 添加用戶
在安裝完JIRA系統后，系統中只有一個系統管理員帳號；在創建完項目后，通常需要在JIRA系統中添加其他的用戶帳號，在管理界面上點擊左側的Users&Groups->“User Browser”鏈接，在User Browser界面上再點擊“Add User”鏈接就可以添加新用戶了。注意：不要使用漢字作為用戶名。
5.5 添加組
JIRA系統的用戶是通過Group來管理的，通過給組的授權，達到管理用戶的目的。添加組的步驟：
在管理界面上點擊左側的Users&Groups->“Group Browser”鏈接，在Group Browser界面右側名稱輸入框中輸入組名，然后點擊“Add Group”按鈕即可。注意：不要使用漢字作為組名。
5.6 創建問題
創建問題第一個步驟是選擇項目和問題類型，然后點擊“下一步”填寫問題的詳細信息。
創建問題的第二步，填寫或選擇創建的問題詳細信息，主要包括：問題的概要描述、優先級、逾期日期、所屬模塊、問題影響的版本、問題修復的版本、分配給哪個人員、問題出現的環境描述、問題詳細信息描述。填寫完成后，點擊“創建”按鈕。
問題創建完成后，分配到問題的用戶將會收到通知郵件，登錄JIRA系統后，在分配給我的問題列表中點擊問題鏈接后，在問題的詳細信息界面上就可以進行根據可選工作流程進行操作。
問題詳細信息界面圖如下，從圖中可以看出這個目前對這個問題可以進行的操作有三個：開始進行、解決問題和關閉問題。
問題創建后，您除了可安裝可選工作流程對問題進行處理外，還可以給問題上傳附件，填寫備注，復制和編輯問題，如果有權限的話，還可以刪除問題，創建子任務等。
5.7 瀏覽項目
在瀏覽項目的界面上可以看到項目的基本信息資料，模塊和版本信息及問題分布情況。
5.8 查找問題
在查找問題界面上，您可以在界面左側進行查詢條件的設置，JIRA提供了強大的查詢功能，在您設定好查詢條件后，還可以將查詢條件保存起來，定義為過濾器，供以后的重復使用，甚至可以將保存的過濾器共享給團隊的其他成員。
第六章、項目設置
6.1 添加項目
輸入項目名稱、項目縮寫、項目經理，選擇郵件通知方案和權限設置方案；參見5.2
6.2 添加項目模塊
在項目的詳細信息界面上，為項目創建組件/模塊（Components）,管理項目的版本。如要創建組件，可點擊Components下方的“Add”鏈接。
6.3添加項目版本
設置步驟如下：
在 Project 頁面下的“ Versions ”部分，點擊“ Manage ”Versions，進入管理版本界面，可以為項目添加版本、版本描述、設置發布日期。
6.4選擇項目權限方案
設置步驟如下：
1)點擊“管理”－“項目 ”，點擊項目名稱鏈查看項目詳細信息界面；
2)在“ Permission Scheme ”部分，點擊“ 選擇 ”鏈接，在進入的頁面中選擇需要的權限設置方案。
6.5 設置項目的 Default Assignee
系統默認是分配給項目負責人，即項目經理。可以根據需要選擇默認為模塊負責人。
設置步驟如下：
1)在 Project 頁面下的“ Components ”部分，在“ select assignees for components ”處，點擊“ Select ”鏈接，進入“ Select Component Assignee ”界面
2)選擇模塊的默認分配人。
6.6 選擇郵件通知方案
設置步驟如下：
1)選擇“管理”－“ Projects ”－“ Projects ”，進入項目詳細信息界面 ；
2)在“ Notification Scheme ”部分，點擊“ select scheme ”鏈接，在進入的頁面中選擇需要的郵件通知方案。
第七章、JIRA系統的權限
JIRA系統中的權限管理分為：系統級別、項目級別、問題級別以及注釋級別。系統級是通過”全局權限（Global Permissions）”來管理的，影響JIRA系統中所有的項目和問題。針對個別項目來說，您還可以通過JIRA系統中的權限模型（Permission Scheme）進一步配置項目級別的權限。下面將分別介紹全局權限和基于項目的權限模型。
7.1 全局權限
設置步驟：
1) 以JIRA系統管理員登錄系統；
2) 點擊” Global Settings”->” Global Permissions”。
7.2 系統缺省權限模型
如下是關于JIRA系統缺省權限模型中的權限描述：
Administer Projects 管理項目的權限，能夠管理項目的組件/components和版本/versions；通常將此權限分配給項目負責人。
Browse Projects 瀏覽項目；無此權限將無法瀏覽到JIRA系統中的項目；通常將此權限分配給項目組成員。
Create Issues 創建問題（報告bug）；通常將此權限分配給測試人員。
Edit Issues 編輯問題；擁有此權限可以對創建后的問題進行修改。通常將此權限分配給問題報告者、項目管理人員；
Schedule Issues 設置或者編輯問題的預期完成日期；通常將此權限分配給問題報告者、項目管理人員；
Move Issues 在項目之間移動問題；只能移動到有創建問題權限的項目上；通常將此權限分配給項目管理人員；
Assign Issues 分配問題；通常將此權限分配給測試人員、項目管理人員。
Assignable User 可以分配到問題的人；通常將此權限分配給開發人員。
Resolve Issues 解決和重新打開問題，可以設置修復版本；通常將此權限分配給開發人員。
Close Issues 關閉問題；通常將此權限分配給問題報告人員或QA人員。
Modify Reporter 創建或編輯問題時修改報告者；通常將此權限分配給問題報告人員或項目管理人員。
Add Comments 添加注釋；通常將此權限分配給項目組所有人員。
Delete Issues 刪除問題、注釋和附件；通常將此權限分配給問題報告人員或項目管理人員。
Work On Issues 針對問題做完成情況記錄，須啟用Time Tracking；通常將此權限分配給開發人員。
Link Issues 將相關問題鏈接到一起，須啟用Issue Linking；通常將此權限分配給問題報告人員或項目管理人員。
Create Attachments 添加附件；通常將此權限分配給問題報告人員、開發人員和項目管理人員。
View Version Control 查看問題的提交版本控制信息；通常將此權限分配給問題報告人員、開發人員和項目管理人員。
View Voters and Watchers 查看投票者和關注者列表信息；通常將此權限分配給JIRA系統管理人員。
Manage Watcher List 管理問題監視者列表；通常將此權限分配給JIRA系統管理人員。
Set Issue Security 設置問題的安全級別,只有處于該安全級別的用戶才可以看到問題。通常將此權限分配給JIRA系統管理人員。
第八章、常見問題與解答
Q ：在哪里可以下載到 JIRA？
A ：JIRA的官方下載URL：http://www.fangwai.net/software/jira/jiradownloadcenter.htm
Q ：怎樣能直接看到該缺陷，而不是必須先登錄后可以看到該缺陷?
A ：該問題有兩種解決辦法：
第一種是設置用戶組 anyone 的權限為： Browse Projects ；
第二種是在登錄頁面，將“保持我在這臺計算機的登錄”復選框選中。
Q ：JIRA能和源代碼管理工具集成嗎？
A ：能。JIRA系統中內置了與CVS集成的配置界面；另外JIRA還可以和SVN（Subversion）、Perforce。
Q ：JIRA能和MS VSS集成嗎？
A ：JIRA目前支持和VSS集成。
Q ：JIRA能和目錄服務器集成進行用戶登錄認證嗎？
A ：能。如：JIRA可以和MS目錄服務器（Active Directory）、OpenLDAP集成。
Q ：JIRA的擴展性如何？
A ：JIRA具有很好的擴展性。Atlassian為開發者提供了豐富的“資源”，其中有開發文檔和教程、插件開發工具箱、開發者郵件列表、插件庫、JIRA API等等。
JIRA的在線演示站點URL：http://www.fangwai.net:8080/
JIRA的中文技術論壇URL：http://www.fangwai.net/bbs/
Atlassian的相關軟件介紹:
Confluence - 企業wiki,用于信息共享,知識管理.可以和JIRA集成;
Bamboo - 持續集成服務器（CI Build Server）
Crowd - 單點登錄工具（SSO - Simplified）,可以連接多個LDAP
Clover - 強大并高度可配置的代碼覆蓋分析工具
Crucible - 有效的代碼評審
FishEye - 源代碼庫深度查看