閱讀英文

共用方式為


匯入、匯出和管理工作項目類型 [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:自訂及管理追蹤工作的物件