在工作項目類型中加入整合欄位

發行項
08/21/2008

更新：2007 年 11 月

Team Foundation 工作項目追蹤系統會和 Team Foundation Server 與 Visual Studio Team System 的其他元件整合在一起。為了在元件之間的整合中獲取最大益處，您可以在工作項目類型中使用特定欄位與動作。本主題將在下列章節中說明如何使用這些必要欄位與動作：

與 Team Build 整合
與 Visual Studio 測試工具整合
與 Team Foundation 原始檔控制整合

與 Team Foundation Build 整合

Team Foundation Build 是 Team Foundation Server 的自動化建置系統。您可以使用 Team Foundation Build 設定建置流程。建置失敗時，Team Foundation Build 可以產生工作項目，也可以將建置資訊加入至在某特定組建中已解決的工作項目。若要產生這種效用，Team Foundation Build 需要下列兩個欄位：Found In 和 Integration Build。

加入 Found In 欄位

Team Foundation Build 會在建置失敗時建立一個新的工作項目，並將 Found In 欄位設為剛才失敗之組建的組建編號。當建置失敗時，Found In 欄位必須位於您要 Team Foundation Build 建立的工作項目類型中，如果沒有 Found In 欄位，Team Foundation Build 就不會替失敗的組建建立工作項目，所有其他項目也會如預期般運作。

下表摘要列出 Found In 欄位屬性的名稱與值。

屬性名稱	屬性值
RefName	Microsoft.VSTS.Build.FoundIn
Name	可以設定為任何項目，因為整合是根據欄位參考名稱 (而非欄位名稱) 運作。
類型	String

Found In 欄位範例

<FIELD name="Found In" refname="Microsoft.VSTS.Build.FoundIn" type="String" reportable="dimension">
    <HELPTEXT>Product build number (revision) in which this item was found</HELPTEXT>
</FIELD>

加入 Integration Build 欄位

Team Foundation Build 會識別每個組建已解決的工作項目，然後更新這些工作項目，以設定工作項目獲得解決的組建編號。它是在 Integration Build 欄位中設定組建編號。如果沒有 Integration Build 欄位，Team Foundation Build 就不會儲存工作項目中的組建編號，所有其他項目也會如預期般運作。

下表摘要列出 Integration Build 欄位屬性的名稱與值。

屬性名稱	屬性值
RefName	Microsoft.VSTS.Build.IntegrationBuild
Name	可以設定為任何項目，因為整合是根據欄位參考名稱 (而非欄位名稱) 運作。
類型	String

Integration Build 欄位範例

<FIELD name="Integration Build" refname="Microsoft.VSTS.Build.IntegrationBuild" type="String" reportable="dimension">
    <HELPTEXT>Product build number this bug was fixed in</HELPTEXT>
</FIELD>

與 Visual Studio 測試工具整合

Visual Studio 的某些版本包含已整合至開發環境的測試工具。測試工具中有一個可以在測試失敗時建立新工作項目的功能。若要使用這項功能，請在 [測試結果] 視窗中，以滑鼠右鍵按一下您要用來建立 Bug 的測試結果，指向 [建立工作項目]，然後按一下您要建立的工作項目類型，例如 [Bug]。如需詳細資訊，請參閱 HOW TO：從測試結果建立工作項目。

以這種方式建立工作項目時，會自動填入三個欄位以提供有關測試失敗的資訊。這三個欄位是 TestName、TestId 和 TestPath。Visual Studio Test 版會以失敗測試的特定資訊來設定這三個欄位。如果工作項目沒有 TestName、TestId 和 TestPath 欄位，就無法進行設定，所有其他項目也會如預期般運作。

下表摘要列出這三個欄位之屬性的名稱與值。

屬性名稱	屬性值
RefName	Microsoft.VSTS.Test.TestName、Microsoft.VSTS.Test.TestId、Microsoft.VSTS.Test.TestPath
Name	可以設定為任何項目，因為整合是根據欄位參考名稱 (而非欄位名稱) 運作。
類型	字串

TestName、TestId 和 TestPath 欄位的範例

<FIELD name="Test Name" refname="Microsoft.VSTS.Test.TestName" type="String" reportable="detail">
    <HELPTEXT>The name of the test that found this bug</HELPTEXT>
</FIELD>
<FIELD name="Test Id" refname="Microsoft.VSTS.Test.TestId" type="String" reportable="detail">
    <HELPTEXT>The Id of the test that found this bug</HELPTEXT>
</FIELD>
<FIELD name="Test Path" refname="Microsoft.VSTS.Test.TestPath" type="String" reportable="detail">
    <HELPTEXT>The full pathname of the test that found this bug</HELPTEXT>

與 Team Foundation 原始檔控制整合

Team Foundation 版本控制有一個功能可讓您在簽入程式碼時關聯或解決工作項目。您在變更特定程式碼時可能處理了某特定工作項目，完成程式碼變更後，您可以從原始檔控制簽入視窗內設定該關聯。

工作項目必須包含某特定動作，Team Foundation 版本控制才能解決工作項目，然後原始檔控制系統會查詢工作項目追蹤，以判斷工作項目是否支援該動作，如果支援該動作，它還會查詢轉換的來源與目的狀態。如果找到動作，原始檔控制系統就可以在簽入程式碼時依據設定轉換來轉換工作項目。

注意事項：
使用 Checkin 動作時，您必須設定適當的 'from' 和 'to' 狀態，以反映您要的狀態轉換。

如需動作的詳細資訊，請參閱使狀態轉換與動作產生關聯和轉換動作詳細資料。

Checkin 動作的範例

<TRANSITION from="Active" to="Resolved">
....
    <ACTIONS>
        <ACTION value="Microsoft.VSTS.Actions.Checkin"/>
    </ACTIONS>
....  
</TRANSITION>

請參閱

共用方式為