指導教學:探索 Rational Team Concert JUnit 範例專案

這本簡要手冊是 Rational Team Concert™ JUnit 範例專案的指南。它提供高階的概觀,以供您自行開始探索。
JUnit 專案是以實際可行的軟體開發專案為基礎,其目標是交付 JUnit 4.4 版。團隊使用 Rational Team Concert 來規劃、追蹤、協同和交付版本。一旦將範例 JUnit 專案建立在 Jazz™ Team Server 後,您將會看到現有的構件,如同團隊已開始工作。

學習目標

讀完本手冊,應足以讓您著手試驗並瞭解更多,但本手冊不會按步驟引導您完成專案。

    1. 建立 JUnit 範例專案

    2. JUnit 專案區域的使用者和用戶端存取授權

    3. JUnit 專案密集短期工作和規劃的工作

    4. JUnit 專案原始碼

    5. JUnit 專案建置

    6. JUnit 專案報告(僅適用於 Standard Edition)

    7. 在 Web 介面中探索 JUnit 專案

所需時間

20 分鐘

1. 建立 JUnit 範例專案

為了要在 Jazz Team Server 上建立 JUnit 範例專案,您必須具備 JazzAdmin 許可權,並獲指派為「開發人員用戶端存取授權」。
開啟「安裝 Team Concert 範例專案」精靈:按一下檔案 > 新建 > 範例,並遵循提示來安裝 Team Concert 範例專案

2. JUnit 專案區域的使用者和用戶端存取授權

JUnit 範例專案包含 8 位使用者。您可以使用任何這些團隊成員身分來登入 JUnit 專案,以便瞭解各種不同的角色和指派層面。不過,若想要藉由其中一種的使用者身分,便能完整探索 JUnit 專案,該使用者必須獲指派為「開發人員用戶端存取授權」。您可在本範例中指派的授權數,受您伺服器上所剩下的授權數限制。
提示: 每一個使用者的起始密碼和其使用者 ID 相同。例如,Bill 的密碼為 "bill"。如果您打算廣泛探索測試伺服器,可能需要變更這些起始密碼。
表 1. JUnit 專案區域中的使用者
使用者 使用者 ID / 密碼 角色/說明
Bill Cassavelli bill / bill JUnit 團隊領導人。Bill 是 JUnit 團隊的元件主管。他設定了計劃, 並且是版本的數個高階工作項目的擁有者。
Build build / build 執行建置的特殊使用者
Freddy Freund freddy / freddy  
Jason Mitchell jason / jason JUnit 團隊成員。Jason 獲指派了一些工作項目。
Jennifer Ginness jennifer / jennifer  
Markus Kent markus / markus JUnit 團隊成員。Markus 獲指派了一些工作項目。
Marlene Stamp marlene / marlene  
Rick Yuen rick / rick  
「用戶端存取授權」 用來控制哪些使用者獲授權存取 Jazz Team Server 上的某些特性。可用的「用戶端存取授權」數量取決於您使用的 Rational Team Concert 版本而定。一般而言,具備「開發人員用戶端存取授權」的使用者有權建立構件,而具備「貢獻者用戶端存取授權」的使用者可以建立工作項目,但只能檢視其他大部分的構件。

如需相關資訊,請參閱Rational Team Concert 2.0.0.2 版本與授權 and 管理用戶端存取授權

如果要指派授權給使用者,請執行下列動作:

  1. 以具備管理者專用權(以新伺服器安裝架構來說,是 ADMIN/ADMIN)的使用者身分,登入 JUnit 專案區域。
  2. 團隊組織視圖(視窗 > 顯示視圖 > 團隊組織)中,用滑鼠右鍵按一下 Markus Kent,然後按一下開啟
  3. 在使用者編輯器的用戶端存取授權下,選取 Rational Team Concert - 開發人員,並按一下儲存

    這個影像顯示使用者編輯器,而其中正在定義「用戶端存取授權」

團隊組織視圖只會顯示隸屬於 JUnit 團隊的使用者。如果要為其他使用者指派「用戶端存取授權」,請使用 Jazz Team Server Web 介面(按一下管理 > 使用者管理)。這個介面會列出伺服器上的所有使用者:

Jazz Team
Server Web 介面的「使用者管理」區段

提示:

如果要以不同的使用者身分登入,請修改您儲存庫連線的內容,並指定不同的使用者 ID:

變更連線內容,以使用不同的使用者身分登入

3. JUnit 專案密集短期工作和規劃的工作

JUnit 專案使用 Scrum 作為其程序。Scrum 是常見的一種靈活管理專案方式。在每一個稱為「密集短期工作」的疊代中, 團隊已建立一份計劃文件,並為該「密集短期工作」定義了一些工作項目。
  1. 您可以在專案區域編輯器中開啟 JUnit 專案,以查看程序的密集短期工作:

    JUnit 程序的疊代

  2. 如果要檢查疊代計劃,請從「團隊構件」視圖開啟計劃:

    「團隊構件」視圖中的計劃節點,其中顯示 JUnit 計劃

  3. 查看 JUnit 4.4 s2 密集短期工作待辦事項計劃。在規劃的項目標籤中, 計劃編輯器含有工作項目預覽模式,可提供一個行內工作項目編輯器來顯示規劃的重要屬性。

    JUnit
4.4 s2 密集短期工作待辦事項計劃

    提示: 在「計劃」編輯器中,透過下拉功能表,即可迅速變更工作項目的某些屬性:

    從「計劃」編輯器來變更工作項目的優先順序

  4. 如果要查看工作項目的詳細資料,請從規劃的項目頁面中按兩下該項目。它會在工作項目編輯器中開啟,而您可以根據自己的角色和程序配置來進行變更。

    舉例來說,如果您以 JUnit 團隊成員 Markus Kent 身分登入,可嘗試使用討論區段,在工作項目中加入註解:

    顯示討論的工作項目編輯器

4. JUnit 專案原始碼

JUnit 程式碼受 Jazz Team Server 儲存庫中的來源控制。Markus 以及其他被您指派為「開發人員用戶端存取授權」的團隊成員能夠將變更交付至串流。

團隊構件視圖中,您可以看到 JUnit 專案中含有單一來源控制串流(名為 JUnit),其擁有者為 JUnit 團隊。串流含有單一元件,其名稱亦為 JUnit。在以下的畫面中,JUnit 元件位於起始基準線。

顯示在「團隊構件」視圖中的 JUnit
串流、元件和載入的儲存庫工作區

在以上的畫面中,現行使用者已載入一個名為 JUnit 的儲存庫工作區。您可以搜尋其他使用者的儲存庫工作區, 然後複製並載入它們;或是建立自己的儲存庫工作區。

當載入儲存庫工作區時,凡屬於所載入元件中的專案,您都可以在您的開發環境中使用。以 JUnit 元件來說,其中含有三個專案:

載入並顯現在「套件瀏覽器」中的 JUnit 原始碼專案
在初步探索後,您或許會想進一步瞭解 Jazz Source Control 的一些概念和作業。

若想進一步瞭解串流、元件、儲存庫工作區和其他概念,請閱讀Rational Team Concert Source Control 概觀一節。

對 Java™ 檔進行變更,並在擱置的變更視圖中交付該項變更,以進行試驗。最佳作法是讓該變更和相關的工作項目產生關聯。
在「擱置的變更」視圖中交付變更集

5. JUnit 專案建置

JUnit 專案含有一項建置定義和一個建置引擎。如果要透過 JUnit 建置來探索和試驗,您必須使用另行安裝的建置工具箱來設定和啟動建置引擎。
  • 如果要執行建置引擎,您必須已安裝Build System Toolkit。您可以從安裝啟動程式來安裝這個工具箱,或者從 jazz.net 下載。若已安裝,會有一個 installdir/buildsystem 資料夾。
  • 在本 JUnit 範例中,必須指派「建置系統用戶端存取授權」給使用者 ID "build"。
如果要啟動 JUnit 專案的建置引擎,請執行下列動作:
  1. 從指令行導覽至 installdir/buildsystem/buildengine/eclipse,其中 installdir 是安裝目錄。
  2. 輸入下列指令:
    jbe -repository https://localhost:9443/jazz -userId build -pass build -engineId junit -sleeptime 5
    當您以建置工具箱順利啟動引擎時,它會等待要求的傳入。它只支援定義成在這個特定建置引擎上執行的建置定義。

    指令視窗顯示建置引擎正在執行,並等待要求的傳入

  3. 要求 junit 建置:

    要求建置

  4. 當建置完成時,請從建置視圖中開啟建置結果。 檢視建置結果的概觀編譯JUnit 標籤,以瞭解您從建置結果中可以看到的資訊類型。
  5. 選擇性的: 如果要排定每隔 30 分鐘自動執行一次 junit 建置,請執行下列動作:
    1. 團隊構件視圖中,用滑鼠右鍵按一下 junit 建置,然後按一下開啟建置定義
    2. 在「建置定義」編輯器中,按一下排程標籤。
    3. 選取啟用勾選框。
    4. 連續間隔(分鐘)欄位中,輸入 30
    5. 按一下儲存
    「建置定義」的「排程」標籤
若想進一步瞭解「團隊建置」、如何經營和管理建置,請閱讀「說明」中的使用 Jazz Team Build 來建置區段。您也可以開始學習如何建置 Ant 作業,以便在您自行撰寫建置 Script 時派上用場。

6. JUnit 專案報告(僅適用於 Standard Edition)

如果您打算深入探索 JUnit 專案,您可以使用報告來追蹤進度,並監視 JUnit 專案區域與團隊。但是報告需要歷程的聚集資料,而 JUnit 專案並無任何起始資料點可藉以啟動建置報告。
報告採用資料倉儲,這通常是擷取儲存庫資料每日的 Snapshot。這些 Snapshot 提供報告所需的歷程資料點。如果您想查看 JUnit 的相關報告,必須隨著時間推移起始一或多個 Snapshot。舉例來說,您可以立即擷取一份 Snapshot,然後交付部分的程式碼變更,執行某些建置,或開啟某些工作項目,然後再擷取另一份 Snapshot。

如果要手動起始資料的 Snapshot,請執行下列動作:

  1. 確定 Markus Kent 具備 JazzDWAdmin 許可權,然後以 Markus 身分登入 Rational Team Concert Web 介面。
    註: 如果您授與 Markus Kent JazzAdmin 許可權,他可以指派 JazzDWAdmin 許可權給自己。否則,您必須以自己的使用者 ID 登入,以指派 JazzDWAdmin 許可權給 Markus。
  2. 跳至報告頁面,並按一下管理資料倉儲
  3. 按一下更新所有 Snapshot 資料
在您取得數份代表幾個時間點的 Snapshot 後,您將可從您所檢視的 JUnit 專案報告中發掘更多的價值。
您可以從下列兩處來執行報告:
  • Web 介面的報告頁面:

    Web 介面的「報告」頁面

  • 團隊構件視圖中,在 JUnit 專案的「報告」節點下,請執行下列動作:

    從「團隊構件」視圖開啟的報告

若想進一步瞭解產生報告特性,請閱讀「說明」中的利用報告追蹤資料一節。

7. 在 Web 介面中探索 JUnit 專案

在本手冊中,大部分是引導您執行 Rich 用戶端。Rational Team Concert Web 介面亦提供豐富多樣的環境,同樣能達到眾多相同的團隊協同目標。

Web 介面中的 JUnit 專案

如果要在 Web 介面中探索 JUnit 專案區域,請執行下列動作:
  1. 開啟瀏覽器並移至 Web 介面。如果您是在本端執行,預設 URL 為:

    https://localhost:9443/jazz/web/projects/JUnit%20Project

  2. 導覽 Web 介面。例如:
    • 工作項目頁面上,尋找和建立工作項目。
    • 來源控制頁面上,瀏覽儲存庫中的原始碼。
    • 計劃頁面上,檢閱專案計劃。
    • 儀表板頁面上,操作團隊儀表板和個人儀表板(僅適用於 Standard Edition)。
    • 建置頁面中,檢視建置定義與結果,並且要求建置。
    • 報告頁面上,檢視專案狀態和進度(僅適用於 Standard Edition)。

摘要

從這個迷你的指導教學中,您應已瞭解 JUnit 範例專案的基本觀念。就探索和開始學習如何使用 Rational Team Concert 來和團隊協同進行軟體開發專案來說,JUnit 專案是一個很好的途徑。
記住: 當您完成使用 JUnit 範例專案時,請將「用戶端存取授權」從範例使用者中移除。這會釋放授權以便指派給實際的使用者。

意見

以上說明對您有幫助嗎?您可以在 Jazz.net 網站中提供意見(需要登錄):在討論區中提供意見提交錯誤