使用指南(專案跟蹤管理工具)
第一章、前言
JIRA 是澳大利亞 Atlassian 公司開發的一款優秀的問題跟蹤管理軟體工具，可以對各種型別的問題進行跟蹤管理，包括缺陷、任務、需求、改進等。JIRA採用J2EE技術，能夠跨平臺部署。它正被廣泛的開源軟體組織，以及全球著名的公司使用。
JIRA產品非常完善且功能強大，安裝配置簡單，多語言支援、介面十分友好，和其他系統如CVS、Subversion（SVN）、VSS、LDAP、郵件服務整合得相當好，文件齊全，可用性以及可擴充套件性方面都十分出色，擁有完整的使用者許可權管理。
您可在JIRA中國網站 http://www.fangwai.net/ 上了解到JIRA 更為詳細的資訊。
此文件主要介紹了JIRA產品的特性、安裝配置、基本概念及操作。為您評估使用JIRA提供一個基本的指南。另外，本文件中介紹的部分功能是JIRA企業版獨有的，如：專案類別管理功能、設定模組負責人。
第二章、JIRA介紹
跟蹤並管理在專案開發和維護過程中出現的問題（如：缺陷、新特性、任務、 改進等）是專案管理很重要的任務，但是很少有團隊能做的很好。 JIRA作為一個專業的問題跟蹤系統可以幫助您把缺陷管理起來，讓跟蹤和管理在專案中發現的問題變得簡單，而且充分利用JIRA的靈活配置和擴充套件特性，可以將JIRA作為一個專案管理系統或者IT支援系統。
1) 管理缺陷，新特性、任務、改進或者其他任何問題
2) 乾淨和強大的使用者介面 3) 靈活的工作流定製 4) 全文搜尋和強大的過濾器 5) 企業級的許可權和安全控制 6) 非常靈活的郵件通知配置 7) 可以建立子任務 8) 方便的擴充套件及與其他系統整合：包括 email 、LDAP 和原始碼控制工具等； 9) 豐富外掛庫 10) 專案類別和元件/模組管理 11) 可以在幾乎所有硬體、
2.2 JIRA 的版本
為了適應不同使用者的使用需求，JIRA產品提供三種版本，分別為：標準版，專業版和企業版，這三種版本在功能上有區別。企業版的功能最全，含蓋了標準版和專業版的全部功能並有較多增強的功能，專業版則包含了標準版的全部功能並有一些增強功能，標準版本是JIRA的基礎版本。
2.2.1 企業版
是為企業級使用者設計的，它與標準版，專業版相比，具有以下一些獨有的、重要的功能：
2)元件/模組負責人功能：可以將專案的不同元件/模組指派相應的負責人，來處理所負責的元件的Issues。 3)專案email地址功能：每個專案可以有不同的email（該專案的通知郵件從該地址發出）。 4)LDAP配置器：用於將JIRA連線到公司的LDAP目錄上。 5)Issue安全級別：在一個專案裡可以精確地控制對Issue的訪問。 6)無限制的工作流：可以建立多個工作流為不同的專案使用；
2.2.2 專業版
是為部門級設計的。它不具備JIRA企業版獨有的功能，但是它與JIRA標準版相比多出瞭如下幾個方面的功能：
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位)。
1)OrionServer
2)Resin 3)Tomcat 4)JBoss 5)Jetty 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，功能請求或者任何其他您想要跟蹤的的任務；每一個問題有一些關聯的資訊：
-摘要（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。
-影響版本，如一個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）進一步配置專案級別的許可權。下面將分別介紹全域性許可權和基於專案的許可權模型。
設定步驟：
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等等。