共用方式為

定義全域清單

  • 發行項

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

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

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

注意事項注意事項

沒有系統定義的全域清單，也不在預設的預先定義全域清單處理 TFS 提供的範本。

本主題內容

  • 加入及管理全域清單

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

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

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

注意事項注意事項

加入或修改全域清單，使用 witadmin 命令列工具匯入和匯出全域清單的定義。請參閱 管理工作項目類型的全域清單 [witadmin]。若要使用全域清單，請將它加入至工作項目類型內定義的 FIELD 。請參閱 所有 FIELD XML 項目參考。

加入及管理全域清單

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

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

  • 流程範本:您可以在定義的全域清單在流程範本中的工作項目類型。 從該範本建立的每個 Team 專案都可以存取全域清單。

  • 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]

概念

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

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

其他資源

自訂全域工作流程