定義全域清單

發行項
06/09/2015

在 Team Foundation Server (TFS) 中使用全域清單，您可以將更新數個工作項目類型 (WIT) 定義中出現之清單所需的工作減到最少。全域清單為挑選清單，您可以將其併入一或多個欄位及 WIT 定義中。您可以在您新增至 Team 專案的 WIT 中，將全域清單定義為 Team 專案集合的全域清單或全域工作流程中的全域清單。您可以將清單項目併入一或多個 GLOBALLIST 項目中，即可針對集合，在數個 WIT 中共用清單項目。

定義 WIT 時，您可能會發現部分欄位共用相同的值。您通常可以跨數個 WIT 甚至 Team 專案共用相同的值。這些值當中，有一部分 (如夜間組建的組建編號) 經常變更，需要系統管理員頻繁地在許多位置更新這些清單。從外部系統衍生清單時，全域清單特別實用。例如，假設公司維護個別客戶資料庫。當您提報客戶發現的 Bug 時，該客戶的名稱會輸入自訂 Found By Customer 欄位。

您可以管理集合的全域清單，將其視為您能夠列出、匯入、匯出及刪除的 XML 檔案。每個全域清單的名稱最多可有 254 個 Unicode 字元，而且在集合內必須是唯一的名稱。

注意事項
在 TFS 提供的預設流程範本中，沒有系統定義的全域清單，也沒有預先定義的全域清單。

需求

若要匯出或列出全域清單，您必須是 Project Collection Valid Users 群組的成員，或者您的「檢視集合層級資訊」權限必須設為「允許」。
若要定義或編輯全域清單，您必須是 Project Administrators 群組的成員，或者您的「編輯專案層級資訊」權限必須設為「允許」。
若要新增或修改全域清單，請使用 witadmin 命令列工具匯入及匯出全域清單的定義。請參閱管理工作項目類型的全域清單 [witadmin]。若要使用全域清單，請將其加入工作項目類型中的 FIELD 定義。請參閱所有 FIELD XML 項目參考。

新增及管理全域清單

全域清單是一組 LISTITEM 項目，由集合內的所有 Team 專案在全域儲存及使用。如果欄位在數個工作項目類型 (如作業系統、發現的組建及修正的組建) 中定義，則全域清單對於欄位非常實用。

您可以使用下列其中一種方法定義全域清單及其項目：

Team 專案集合：您可以匯出、修改、刪除及匯入針對 Team 專案集合定義的全域清單。這些全域清單可用於集合中的所有 Team 專案。
工作項目類型定義：建立 Team 專案之後，您可以將要用於某個工作項目類型的全域清單加入其定義。
全域工作流程定義：建立 Team 專案之後，您可以將要用於所有工作項目類型的全域清單加入 Team 專案或集合的全域工作流程定義。如需詳細資訊，請參閱自訂全域工作流程。

語法結構

下表描述 GLOBALLIST 及 LISTITEM 項目。您可以使用這些項目，將呈現給使用者的值清單列舉為項目的挑選清單或下拉式功能表。

項目

語法

描述

GLOBALLIST

<GLOBALLIST name="globalListName">
    <LISTITEM> . . . </LISTITEM>
</GLOBALLIST>

定義一組為集合儲存，且集合中所有 Team 專案都可使用的 LISTITEM 項目。

globalListName：包含 1 到 255 個字元的文字字串。

GLOBALLIST 是 GLOBALLISTS 項目的必要子項目，是 ALLOWEDVALUES、SUGGESTEDVALUES 及 PROHIBITEDVALUES 項目的選用子項目。如需詳細資訊，請參閱定義挑選清單。

LISTITEM

<LISTITEM value="Name" />

定義有效的清單值。

注意事項
全域清單不得包含專案範圍的群組，因為清單不在專案範圍內。

LISTITEM 是 GLOBALLIST 的必要子項目，是 ALLOWEDVALUES、SUGGESTEDVALUES 及 PROHIBITEDVALUES 項目的選用子項目。

全域清單範例

加入下列語法，您就可以在某個工作項目類型或全域工作流程的 XML 定義檔中定義全域清單：

<GLOBALLISTS>
    <GLOBALLIST name="name of global list">
        <LISTITEM value="List item 1" />
        <LISTITEM value="List item 2" />
        <LISTITEM value="List item 3" />
        <LISTITEM value="List item 4" />
        . . .
        <LISTITEM value="List item n" />
    </GLOBALLIST>
</GLOBALLISTS>

使用下列語法，您就可以參考某個工作項目類型之 XML 定義檔中的全域清單：

<GLOBALLISTS>
   <GLOBALLIST name=" name of global list 1" />
   <GLOBALLIST name=" name of global list 2" />
   . . .
   <GLOBALLIST name=" name of global list n" />
</GLOBALLISTS>

如需工作項目類型或全域工作流程之定義檔的結構與位置等詳細資訊，請分別參閱所有 WITD XML 項目參考或全域工作流程 XML 項目參考。

為專案集合維護的全域清單範例

若要將全域清單加入專案集合，您可以使用 witadmin importgloballist 命令，即可匯入下列語法：

<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/globallists">
    <GLOBALLIST name="NameOfGlobalList">
        <LISTITEM value="ListItem1" />
        <LISTITEM value="ListItem2" />
        <LISTITEM value="ListItem3" />
        <LISTITEM value="ListItem4" />
        . . .
        <LISTITEM value="ListItemN" />
    </GLOBALLIST>
</gl:GLOBALLISTS>

全域清單不能是空的。每個 GLOBALLIST 項目都至少必須定義一個 LISTITEM 項目。

問與答

問：所有全域清單都會自動填入資料嗎？

答：可以。每次執行組建時，都會附加名為「組建 –TeamProjectName」的全域清單。經過一段時間之後，該清單可能會變得非常長。最佳作法是定期從清單中移除不使用的項目。

若要進一步了解如何使用此清單，請參閱支援整合測試、組建與版本控制的欄位.