定義全域清單

更新：2011 年 1 月

透過使用全域清單，您將可以減少更新多個工作項目類型共用的清單所需的工作。 全域清單是可包含在一個或多個工作項目類型和欄位的挑選清單。 您可以在加入至 Team 專案或流程範本的工作項目類型內定義全域清單、將全域清單定義為 Team 專案集合的全域清單，或在全域工作流程內定義全域清單。 您只需將清單項目加入至一個或多個 GLOBALLIST 項目中，即可讓集合的多個工作項目類型共用清單項目。

注意事項
在定義全域工作流程之前，應用程式層伺服器必須啟用此功能。 因此，伺服器必須執行支援此功能的 Visual Studio Team Foundation Server 版本，例如 Team Foundation Server 2010 Service Pack 1 (SP1)。 您可以從下列 Microsoft 網站的網頁下載 Service Pack：Visual Studio Team Foundation Server 2010 Service Pack 1，Beta 版 (英文)。 如需詳細資訊，請參閱自訂全域工作流程。

當您定義工作項目類型時，可能會發現某些欄位共用相同的值。 您通常會讓數個工作項目類型，甚至讓數個 Team 專案共用清單。 其中某些值可能會經常變更，例如夜間組建的組建編號，而系統管理員需要經常在許多位置更新這類清單。 如果必須從外部系統衍生清單，全域清單可能會特別實用。 例如，假設某個公司另外維護一個分開的客戶資料庫， 當您提出客戶發現的 Bug 時，您會在自訂的 Found By Customer 欄位中輸入客戶的名稱。

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

注意事項
在 Microsoft Solutions Framework (MSF) 流程範本中，沒有系統定義的全域清單，也沒有預先定義的全域清單。

本主題內容

• 加入及管理全域清單

• 定義全域清單的語法結構

• 加入至工作項目類型定義或全域工作流程之全域清單的語法結構

• 集合所維護之全域清單的語法結構

加入及管理全域清單

全域清單是一組 LISTITEM 項目，由集合中所有 Team 專案共同儲存和使用。 對於在數個工作項目類型內定義的欄位，例如 [作業系統]、[發現的組建] 和 [修正的組建]，全域清單很有用。

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

• 流程範本：您可以定義流程範本的全域清單。 從該範本建立的每個 Team 專案都可以存取全域清單。

• Team 專案集合：您可以匯出、修改、刪除及匯入針對 Team 專案集合所定義的全域清單。 這些全域清單可供集合中所有 Team 專案使用。

• 工作項目類型定義：當您要將全域清單供某個工作項目類型使用時，可以將它加入至該工作項目類型的定義中。

• 全域工作流程定義：當您要將全域清單供所有工作項目類型使用時，可以將它加入至 Team 專案或集合的全域工作流程定義中。 如需詳細資訊，請參閱自訂全域工作流程。

回到頁首

定義全域清單的語法結構

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

項目	語法	描述
GLOBALIST	<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 項目。

回到頁首

請參閱

工作

加入、使用和管理全域清單

參考

管理工作項目類型的全域清單 [witadmin]

概念

自訂專案追蹤資料、表單、工作流程和其他物件

定義並使用清單、挑選清單和全域清單

其他資源

自訂全域工作流程

變更記錄