共用方式為

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

  • 發行項

全域清單是可包含在工作項目的一個或多個欄位及類型中的挑選清單。 使用它們來減少更新多個工作項目類型共用之清單所需的工作。 由於全域清單是針對 Team 專案集合所定義，因此可以包含在集合內所有 Team 專案的工作項目類型之中。

注意事項注意事項

全域清單不得包含以專案當做範圍的安全性群組，因為全域清單的範圍與 Team 專案範圍不相同。

您可以在全域清單本身、工作項目類型或全域工作流程的定義檔中定義全域清單。 全域清單定義會管理針對集合所定義的全域清單。 全域清單定義會在 witadmin 命令列工具中使用下列命令：

  • destroygloballist：終結全域清單。

  • exportgloballist：將全域清單匯出至 XML 檔案或 [命令提示字元] 視窗。 這會匯出單一檔案，其中將包含針對 Team 專案集合所定義的所有全域清單。

  • importgloballist：從 XML 檔案匯入全域清單。 如果您嘗試匯入已存在於伺服器的全域清單，則會顯示警告詢問您是否要覆寫伺服器上的全域清單。 如果您嘗試匯入的全域清單已不存在，則命令會建立新的全域清單。

  • listgloballist：顯示伺服器上定義的每個全域清單的名稱。

請參閱定義全域清單和自訂全域工作流程。

若要執行 witadmin 命令列工具，請在安裝 Visual Studio 或 Team Explorer 的系統中開啟命令提示字元視窗，並輸入：

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

在 Windows 64 位元版本中，將 %programfiles% 取代為 %programfiles(x86)%.

注意事項注意事項

您可以使用 Visual Studio 的強大工具 [處理序編輯器]，建立和修改全域清單。不支援此工具。如需詳細資訊，請參閱下列 Microsoft 網站的網頁：Team Foundation Server Power Tools (英文)。

需求

對於定義全域清單的 Team 專案集合，您必須已設定下列權限：

  • 若要匯出或列出全域清單，您必須是 [Project Collection Valid Users] 群組的成員，或是您的 [檢視集合層級資訊] 使用權限已設為 [允許]。

  • 若要終結或匯入全域清單，您必須是 [Team Foundation Administrators] 安全性群組或 [Project Administrators] 安全性群組的成員。

請參閱Team Foundation Server 使用權限和Team Foundation Server 預設群組、使用權限和角色。

注意事項注意事項

即使您使用系統管理權限登入，還是必須開啟較高權限的命令提示字元視窗，在執行 Windows Server 2008 的伺服器上執行此功能。若要開啟較高權限的 [命令提示字元] 視窗，請選取 [開始]，開啟 [命令提示字元] 捷徑視窗，然後選取 [以系統管理員身分執行。]。如詳細資訊，請參閱 Microsoft 網站上的這個頁面：使用者存取控制 (英文)。

 
witadmin destroygloballist /collection:CollectionURL /n:GlobalListName [/noprompt] [/force]

witadmin exportgloballist /collection:CollectionURL [/f:FileName] [/e:Encoding] 

witadmin importgloballist /collection:CollectionURL /f:FileName [/e:Encoding]

witadmin listgloballist /collection:CollectionURL

參數

參數

描述

/collection:CollectionURL

指定 Team 專案集合的 URI。 URI 的格式如下： http://ServerName:Port/VirtualDirectoryName/CollectionName

如果不使用任何虛擬目錄，則 URI 格式如下：

http: / /ServerName:Port / CollectionName。

/n:GlobalListName

要終結之全域清單的名稱。

/f:FileName

要匯出或匯入的全域清單 XML 定義檔案其路徑與名稱。

注意事項注意事項
如果用戶端電腦執行 Windows Vista，您可能沒有一些特定資料夾的權限。如果嘗試將全域清單匯出至您沒有權限的位置，登錄模擬技術便會自動重新導向至已匯出的檔案，並將該檔案儲存在虛擬存放區中。如需詳細資訊，請參閱 Microsoft 網站的下列頁面：登錄虛擬化 (英文) 和 Windows Vista 中常見的檔案及登錄模擬問題。若要避免此重新導向，您可以將此檔案匯出至您已擁有權限的位置。

/e:Encoding

.NET Framework 2.0 編碼格式的名稱。 指定的編碼方式將會用來匯出或匯入 XML 資料。 例如 /e utf-7 會指定 Unicode (UTF-7) 編碼方式。 如果您省略這個參數，witadmin 會嘗試偵測編碼，如果偵測失敗，witadmin 會使用 UTF-8。

/noprompt

停用確認提示。

/? 或 help

顯示 [命令提示字元] 視窗中命令的說明。

備註

如果清單不存在的話，匯入全域清單會建立一個清單。 如果此清單已經存在，witadmin importgloballist 命令將會警告您，將要覆寫目前的清單。 您可以撰寫自己的程式來更新現有的全域清單，或是自行以新的資料來更新全域清單。

若要建立新的全域清單，請從下列程式碼開始並依需要進行修改。 這個範例會定義您可以指派給工作之專業領域的全域清單。

<?xml version="1.0" encoding="utf-8"?>
<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/globallists">
    <GLOBALLIST name="Disciplines">
        <LISTITEM value="Architecture" />
        <LISTITEM value="Requirements" />
        <LISTITEM value="Development" />
        <LISTITEM value="Release Management" />
        <LISTITEM value="Project Management" />
        <LISTITEM value="Test" />
    </GLOBALLIST>
</gl:GLOBALLISTS>

若要將全域清單加入至欄位，請匯出包含欄位之工作項目類型的定義，並將其加入至欄位定義，如下列範例所示：

<FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES>
     <GLOBALLIST name="Disciplines" />
  </ALLOWEDVALUES>
</FIELD>

若要檢視變更，請匯入型別定義並重新整理瀏覽器或用戶端快取。 您可能必須關閉所有參考欄位的工作項目，然後再重新開啟。

如需有關匯出和匯入型別定義的詳細資訊，請參閱自訂和管理工作項目類型 [witadmin]。

範例

除非另行指定，下列的值會套用在每個範例：

  • Team 專案集合的 URI：http://AdventureWorksServer:8080/tfs/DefaultCollection

  • 伺服器網站連接埠號碼：8080

Dd236912.collapse_all(zh-tw,VS.110).gif顯示全域清單名稱

下列範例顯示在伺服器上定義的全域清單。 這個範例會使用預設 UTF-8 編碼方式匯出全域清單：

witadmin listgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Dd236912.collapse_all(zh-tw,VS.110).gif匯出全域清單定義

下列範例會匯出全域清單：

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml

下列範例會將相同的全域清單匯出到同一部伺服器，但使用 Unicode (UTF-7) 編碼方式：

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml /e:utf-7

Dd236912.collapse_all(zh-tw,VS.110).gif匯入全域清單定義

下列範例會匯入全域清單：

witadmin importgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml

下列範例會將相同的全域清單匯入到同一部伺服器，但使用 Unicode (UTF-7) 編碼方式：

witadmin importgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml /e utf-7

請參閱

概念

定義全域清單

其他資源

自訂全域工作流程

witAdmin：自訂和管理用於追蹤工作項目的物件