共用方式為

匯入、匯出和管理工作項目類型 [witadmin]

  • 發行項

您可以使用下列 witadmin 命令管理 Team 專案的工作項目類型：

  • destroywitd：終結工作項目類型，並永久終結該類型的每一個工作項目，令其無法復原。

  • exportwitd：將工作項目類型的定義匯出至 XML 檔案或命令提示字元視窗。

  • importwitd：將工作項目類型從 XML 定義檔匯入至執行 Team Foundation Server 之伺服器上的 Team 專案。 如果已經存在具有相同名稱的工作項目類型，則新工作項目類型定義會覆寫現有的類型。 如果工作項目類型不存在，則這個命令會建立新的工作項目類型。 若要驗證定義工作項目類型的 XML 而不匯入檔案，請使用 /v 選項。

  • listwitd：在命令提示字元視窗中顯示指定專案內工作項目類型的名稱。

  • renamewitd：變更特定專案內工作項目類型的顯示名稱。 執行這個命令之後，此類型的工作項目會顯示新名稱。

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

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

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

如需工作項目類型的相關資訊，請參閱 將工作項目的類型定義加入至流程範本。

注意事項注意事項

您可以使用流程編輯器 (Visual Studio 的強大工具)，建立及修改工作項目類型。不支援此工具。如需相關資訊，請參閱 Microsoft 網站上的下列頁面：Team Foundation Server Power Tools (英文)。

需求

對於定義工作項目類型所在的 Team 專案，您必須設定下列權限：

  • 若要匯出或列出工作項目類型，您必須是 [Project Administrators] 群組的成員，或將 [檢視專案層級資訊] 權限設定為 [允許]。

  • 若要終結、匯入或重新命名工作項目類型，您必須是 [Team Foundation Administrators] 安全性群組或 [Project Administrators] 安全性群組的成員。

如需詳細資訊，請參閱Team Foundation Server 的權限參考。

注意事項注意事項

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

 
witadmin destroywitd /collection:CollectionURL /p:Project /n:TypeName [/noprompt]

witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName [/f:FileName] [/e:Encoding] [/exportglobalists]

witadmin importwitd /collection:CollectionURL [/p:Project] /f:FileName [/e:Encoding] [/v]

witadmin listwitd /collection:CollectionURL /p:Project

witadmin renamewitd /collection:CollectionURL /p:Project /n:TypeName /new:NewName [/noprompt]

參數

參數

描述

/collection:CollectionURL

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

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

http://ServerName:Port/CollectionName

/p:Project

要為其管理工作項目類型的 Team 專案。 這個 Team 專案必須在 /collection 參數所指定的專案集合中定義。

除非您搭配 /v 選項執行 importwitd 命令，否則必須使用 /p 參數。

/n:TypeName

要終結、匯出、匯入或重新命名的工作項目類型名稱。

/f:FileName

包含要匯出或匯入之工作項目類型的 XML 定義檔路徑和檔案名稱。 如果您省略這個參數，在您使用 exportwitd 命令時，XML 會在命令提示字元視窗中顯示。

注意事項注意事項

如果您使用 Windows Vista，則您可能沒有某些資料夾的權限。如果您嘗試將工作項目類型匯出至您沒有權限的位置，登錄模擬技術會自動重新導向已匯出的檔案，並將其儲存至虛擬存放區。若要避免重新導向，您可以將檔案匯出至您有權限的位置。如需登錄模擬的相關資訊，請參閱 Microsoft 網站：登錄模擬 (英文) 及 Windows Vista 中常見的檔案及登錄模擬問題。

/e:編碼

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

/exportgloballists

匯出工作項目類型所參考的全域清單定義。 全域清單定義會內嵌至工作項目類型定義 XML 中。 如果未指定，則會省略全域清單定義。

/v

驗證定義工作項目類型的 XML，但不匯入 XML 定義檔。

注意事項注意事項

您可以驗證類型定義而不指定 Team 專案。專案範圍群組的參考會被忽略。

/new:NewName

工作項目類型的新名稱。

/noprompt

停用確認提示。

/? 或help

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

備註

當您使用 destroywitd 命令時，它會終結下列所有物件：

  • 工作項目類型

  • 該類型的所有工作項目

  • 工作項目資料表、長文字資料表及連結資料表中的對應項目

  • 工作項目類型轉移狀態快取中的物件

範例

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

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

  • 專案名稱：AdventureWorks

  • 輸入或輸出檔案名稱：myworkitems.xml

  • 工作項目類型名稱：myworkitem

  • 預設編碼：UTF-8

匯入 WIT 的定義

下列命令會將 myworkitem 的定義匯出至檔案 myworkitems.xml。

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem

下列範例會使用 Unicode (UTF-7) 編碼匯出工作項目。

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /e:utf-7

匯出 WIT 的定義及其參考的全域清單

下列範例會匯出工作項目類型及其參考的全域清單。

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /exportgloballists

列出 WIT 的定義

下列範例在命令提示字元視窗中顯示工作項目類型的定義。

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /n:myworkitem

匯入 WIT 的定義

下列範例會從 XML 檔案匯入工作項目定義。

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks

驗證 WIT 的 XML 定義

下列範例會驗證定義工作項目類型的 XML，但不會匯入定義。

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks /v

問與答

問：在 TFS 升級之後，我如何進行自訂且仍使用設定功能精靈更新我的 Team 專案？

**答：**您可以加入自訂 WIT 並變更表單配置。 設定功能精靈會更新您的 Team 專案，且您可以存取最新的功能。

如果變更工作流程或重新命名 WIT，則在更新 Team 專案時可能需要您執行一些手動作業。 若要了解您可以安全地進行哪些自訂，以及您應該避免哪些自訂的詳細資訊，請參閱自訂工作追蹤經驗：請先了解維護和升級的含意再進行自訂。

問：我要如何變更與 WIT 相關聯的色彩？

**答：**在 Team Web Access 中，工作項目會出現於查詢結果，以及出現在 Agile 規劃工具的待處理項目 (Backlog) 和面板頁面上。 若要變更與現有 WIT 相關聯的色彩，或加入要用於新 WIT 的色彩，請編輯流程組態。

指派給不同工作項目類型的色彩

問：如何停用或關閉 WIT？如何限制使用者避免建立特定類型的工作項目？

**答：**如果您有要淘汰的 WIT，但是仍需維護根據該類型建立的工作項目，您可以加入讓所有有效使用者無法儲存工作項目類型的規則。

<TRANSITION from=" " to="New">
   <FIELDS>
     <FIELD refname="System.CreatedBy">
         <VALIDUSER not="[Team Project Name]Project Valid Users" />
     </FIELD>
   </FIELDS>
</TRANSITION>

如果您要限制特定 WIT 只能由某個使用者群組建立，有兩種限制存取的方式：

  • 將 WIT 加入至隱藏分類群組可以防止大多數參與者建立它們。 如果您想要允許使用者群組存取，您可以建立範本的超連結開啟工作項目表單，並與那些您希望來建立工作項目的小組成員共用該連結。

  • 將欄位規則加入至 System.CreatedBy 欄位的工作流程，可以有效地限制使用者群組以避免建立特定類型的工作項目。 如下列範例所示，建立工作項目的使用者必須屬於 Allowed Group 才能儲存工作項目。

    <TRANSITION from=" " to="New">
   <FIELDS>
     <FIELD refname="System.CreatedBy">
         <VALIDUSER for="Allowed Group" not="Disallowed Group" />
     </FIELD>
   </FIELDS>
</TRANSITION>

問：如何刪除 WIT？

**答：**若要防止小組成員使用特定 WIT 建立工作項目，您可以從 Team 專案將其移除。 當您使用 witadmin destroywitd 時，會永久移除使用該 WIT 及 WIT 本身建立的所有工作項目。 例如，如果您的小組不會使用「阻礙」，則可以從 Fabrikam 網站專案刪除標示為「阻礙」的 WIT。

witadmin destroywitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"Impediment"

當您刪除屬於某個分類的 WIT 時，必須更新 Team 專案的分類定義以反映新的名稱。 特別是，若您未更新分類定義，則Agile 規劃工具將無法運作。

如需詳細資訊，請參閱匯入和匯出分類 [witadmin]。

請參閱

工作

建立工作項目類型

概念

自訂工作追蹤物件以支援小組的流程

其他資源

witAdmin：自訂及管理追蹤工作的物件