組建摘要報表
[組建摘要] 會列出組建,並提供每個組建的測試結果、測試涵蓋範圍、程式碼變換和品質附註的相關資訊。
如需如何存取、重新整理或管理報表的詳細資訊,請參閱報表 (Agile)。
注意事項 |
---|
這份報表會要求您必須使用 SQL Server Reporting Services 來佈建包含 Team 專案的 Team 專案集合。當您開啟 Team Explorer並展開 Team 專案節點時,如果沒有顯示 [ 報表],就無法使用這份報表。 |
本主題內容
|
您可以使用這份報表來回答下列問題:
|
必要的使用權限
若要檢視此報表,您必須在 Reporting Services 中具有 [瀏覽] 角色,或屬於具有該角色的群組。 如需詳細資訊,請參閱 將使用者加入至 Team 專案或 管理使用權限。
報表中的資料
[組建摘要] 報表中顯示的資料是衍生自資料倉儲。 這份報表會以視覺化方式顯示成功的測試百分比、受到測試的程式碼,以及程式碼在組建之間歷經的變更。
除了檢閱最近的組建和連續或頻繁組建之外,您還可以檢閱手動和自動建置的結果。 這份報表會根據您對報表指定的篩選條件,最先列出最新的組建,且包含在指定時間間隔內針對所有已執行之組建所擷取的組建結果。
只要看一下,您就能判斷在所檢閱的時間週期內,數個組建定義是成功還是失敗,如下圖所示。
下表說明每個品質指標所顯示的資訊:
品質指標 |
說明 |
---|---|
建置進度 |
指定組建的狀態。 組建可能處於下列其中一種狀態:
|
組建品質 |
指出對於組建品質的手動指派評價。 您可以加入或移除針對 Team 專案所定義的組建品質。 如需詳細資訊,請參閱 加入或移除組建品質值。 如果未評比組建品質,則這個資料行為空白。 |
% 測試成功 |
顯示水平堆疊長條圖,並於綠色長條上加註成功的測試百分比。 其餘長條區段是紅色,表示失敗的測試百分比。 圖表的總長度一律等於資料行寬。 |
% 程式碼涵蓋範圍 |
顯示水平堆疊長條圖,並於綠色長條上加註涵蓋的程式碼百分比。 其餘長條區段是淺藍色,表示組建中未測試的程式碼百分比。 圖表的總長度一律等於資料行寬。 |
% 程式碼變換 (行) |
顯示水平長條圖,並於灰色長條上加註程式碼變換的百分比。 程式碼變換的計算方式是先判斷小組已加入、刪除或修改的程式碼行數,再除以組建中的總行數。 長條長度會依照百分比數據的比例隨整個報表縮放,使得所有組建間的最大程式碼變換數量等於資料行寬。 |
您可以用下列方式篩選 [組建摘要] 報表:
變更報表的開始和結束日期。
指定要納入報表中的平台、組態、組建定義、組建品質或組建進度,以篩選組建定義。
如需詳細資訊,請參閱本主題後面的篩選報表。
必要的組建管理活動
若要讓 [組建摘要] 報表變得更加實用,小組成員必須執行下列活動來管理組建:
設定建置系統: 您必須設定建置系統,才能使用 Team Foundation Build。
如需詳細資訊,請參閱 Configuring Your Build System。
建立組建定義: 您可以建立數個組建定義,以用每個定義產生不同平台適用的程式碼。 此外,您也可以針對不同的組態執行每個組建。
如需詳細資訊,請參閱 定義您的建置流程。
定義要隨組建自動執行的測試: 在組建定義中,您可以定義測試以隨組建一起執行,或在測試失敗時失敗。
如需詳細資訊,請參閱 根據預設範本定義建置流程。
設定測試來收集程式碼涵蓋範圍資料: 若要在報表中顯示程式碼涵蓋範圍資料,小組成員必須設定測試來收集該資料。
如需詳細資訊,請參閱 使用測試設定來設定程式碼涵蓋範圍的方式已被取代和 How to: Gather Code-Coverage Data with Generic Tests。
定期執行組建: 組建可以在固定間隔或是在每次簽入之後執行。 當您使用排程觸發程序時,您可以排定定期執行組建。
如需詳細資訊,請參閱建立組建定義和執行、監視和管理組建。
(選擇性) 評比已完成的組建: 小組成員可以使用 Build 總管來手動評比組建。
如需詳細資訊,請參閱 評比已完成組建的品質。
設定反覆項目的持續期間
若要了解小組在目前反覆項目中執行的進度,您必須將報表的開始日期和結束日期設為符合目前反覆項目週期的日期。
若要變更反覆項目的持續期間
按一下 [反覆項目開始 (日期)] 或 [反覆項目結束 (日期)] 旁的行事曆圖示,然後按一下日期。
按一下 [檢視報告]。
解譯報表
您可以檢閱 [組建摘要] 報表來回答有關最近組建的問題。 這份報表包含比 [組建成功率] 報表更多的資訊。
報表所回答的問題
您可以使用這份報表找出下列問題的答案:
所有組建隨著時間過去的狀態為何?
哪些組建成功了?
哪些組建的程式碼經過大幅變更?
哪些組建已可以安裝?
多少部分的程式碼已執行過測試?
[組建摘要] 報表不會指出問題的原因,但會指出您可以到哪裡查看問題的根本原因。 這份報表也不會指出組建問題的規模或嚴重性。
狀況良好的報表版本
狀況良好的 [組建摘要] 報表會顯示下列跡象:
大部分組建都成功。
大部分測試都成功。
程式碼涵蓋範圍很高。
程式碼變換數量爆增情形很少。
狀況不良的報表版本
狀況不良的 [組建摘要] 報表會顯示下列一個或多個跡象。 您應該根據下列指引進行調查:
有許多組建失敗: 調查組建失敗的原因。
有許多測試失敗: 調查並修正失敗的測試。
程式碼涵蓋範圍大部分是藍色: 您應該撰寫更多自動化測試。
程式碼變換數量有爆增情形: 您應該確認是否有不尋常的數量報增情形。
篩選報表
您可以用下列方式篩選 [組建摘要] 報表:
變更報表的開始和結束日期。
指定要納入報表中的平台、組態、組建定義、組建品質和組建進度,以篩選報表中呈現的組建集。
注意事項 您可以將組建定義設定為不執行測試、只執行部分測試或執行所有測試。此報表將根據組建定義的組態而大不相同。
下圖顯示可用的篩選:
您必須依照下列程序所指定的順序套用篩選條件。 有些篩選條件的可用選項取決於您先前設定的篩選條件。
若要篩選報表中顯示的組建
在 [平台] 清單中,選取每個要納入之平台的核取方塊。
在 [組態] 清單中,選取每個要納入之組態的核取方塊。
在 [組建定義] 清單中,選取每個要納入之組建定義的核取方塊。
在 [組建品質] 清單中,選取每個要納入之組建品質的核取方塊。
在 [進度] 清單中,選取每個要納入之組建進度的核取方塊。
按一下 [檢視報告]。