管理工作項目類型的全域清單 [witadmin]
全域清單是可包含在工作項目的一或多個欄位和類型中的挑選清單。 您可以使用全域清單，將更新多個工作項目類型共用之清單時所需的工作減至最少。 由於全域清單是針對 Team 專案集合所定義，因此可以包含在集合內所有 Team 專案的工作項目類型之中。
您可以在全域清單本身的定義檔、工作項目類型的定義檔或全域工作流程中，定義全域清單。 全域清單定義會管理針對集合所定義的全域清單。 全域清單定義會在 witadmin 命令列工具中使用下列命令：
destroygloballist：終結全域清單。
exportgloballist：將全域清單匯出至 XML 檔案或 [命令提示字元] 視窗。 這會匯出單一檔案，其中包含針對 Team 專案集合所定義的所有全域清單。
importgloballist：從 XML 檔案匯入全域清單。 如果您嘗試匯入已存在於伺服器的全域清單，則會顯示警告詢問您是否要覆寫伺服器上的全域清單。 如果您嘗試匯入的全域清單已不存在，命令會建立新的全域清單。
listgloballist：顯示在伺服器上定義之每個全域清單的名稱。
若要執行 witadmin 命令列工具，請開啟安裝 Visual Studio 或 Team Explorer 的命令提示字元視窗，並輸入：
cd %programfiles%\Microsoft Visual Studio 12.0\Common7\IDE
在 Windows 64 位元版本中，將 %programfiles% 取代為 %programfiles(x86)%.。
.gif "注意事項") 注意事項 |
|---|
您可以使用 Visual Studio 的強大工具 [流程編輯器] 來建立及修改全域清單。如需詳細資訊，請參閱 Team Foundation Server 電源工具。 |
需求
對於定義全域清單所在的 Team 專案集合，您必須設定下列權限：
若要匯出或列出全域清單，您必須是 [Project Collection Valid Users] 群組的成員，或將您的 [檢視集合層級資訊] 權限必須設為 [允許]。
若要匯入全域清單，您必須是 [Project Administrators] 安全性群組的成員，或將 [編輯專案層級資訊] 權限設為 [允許]。
若要使用 witadmin destroygloballist 終結全域清單，您必須是 [Project Collection Administrators] 安全性群組的成員，或將 [編輯集合層級資訊] 權限設為 [允許]。
請參閱 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 定義檔的路徑和名稱。
|
||
/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
顯示全域清單的名稱
下列範例顯示在伺服器上定義的全域清單。 這個範例會使用預設 UTF-8 編碼方式匯出全域清單：
witadmin listgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
匯出全域清單的定義
下列範例會匯出全域清單：
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
匯入全域清單的定義
下列範例會匯入全域清單：
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