匯入、匯出和管理工作項目類型 [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 會在命令提示字元視窗中顯示。
|
||
/e:編碼 |
.NET Framework 2.0 編碼格式的名稱。 該命令會使用指定的編碼匯出或匯入 XML 資料。 例如,/e:utf-7 會指定 Unicode (UTF-7) 編碼。 如果您省略這個參數,witadmin 會嘗試偵測編碼,如果偵測失敗,witadmin 就會使用 UTF-8。 |
||
/exportgloballists |
匯出工作項目類型所參考的全域清單定義。 全域清單定義會內嵌至工作項目類型定義 XML 中。 如果未指定,則會省略全域清單定義。 |
||
/v |
驗證定義工作項目類型的 XML,但不匯入 XML 定義檔。
|
||
/new:NewName |
工作項目類型的新名稱。 |
||
/noprompt |
停用確認提示。 |
||
/? 或help |
顯示 [命令提示字元] 視窗中命令的說明。 |
當您使用 destroywitd 命令時,它會終結下列所有物件:
工作項目類型
該類型的所有工作項目
工作項目資料表、長文字資料表及連結資料表中的對應項目
工作項目類型轉移狀態快取中的物件
除非另行指定,下列的值會套用在每個範例:
Team 專案集合的 URI:http://AdventureWorksServer:8080/tfs/DefaultCollection
專案名稱:AdventureWorks
輸入或輸出檔案名稱:myworkitems.xml
工作項目類型名稱:myworkitem
預設編碼:UTF-8
下列命令會將 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
下列範例會匯出工作項目類型及其參考的全域清單。
witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /exportgloballists
下列範例在命令提示字元視窗中顯示工作項目類型的定義。
witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /n:myworkitem
下列範例會從 XML 檔案匯入工作項目定義。
witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks
下列範例會驗證定義工作項目類型的 XML,但不會匯入定義。
witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks /v
**答:**您可以加入自訂 WIT 並變更表單配置。 設定功能精靈會更新您的 Team 專案,且您可以存取最新的功能。
如果變更工作流程或重新命名 WIT,則在更新 Team 專案時可能需要您執行一些手動作業。 若要了解您可以安全地進行哪些自訂,以及您應該避免哪些自訂的詳細資訊,請參閱自訂工作追蹤經驗:請先了解維護和升級的含意再進行自訂。
**答:**在 Team Web Access 中,工作項目會出現於查詢結果,以及出現在 Agile 規劃工具的待處理項目 (Backlog) 和面板頁面上。 若要變更與現有 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 建立工作項目,您可以從 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]。