共用方式為

定義全域清單

  • 發行項

您可以在 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]

概念

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

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

其他資源

自訂全域工作流程