共用方式為

管理工作項目欄位

  • 發行項

您可以使用下列 witadmin 命令，管理針對 Team 專案集合所定義的工作項目類型欄位。

  • deletefield：刪除指定的欄位。

  • listfields：列出所有欄位或指定欄位的屬性。

  • indexfield：將指定欄位的進行索引功能開啟或關閉。 啟用欄位的索引時，如果工作項目的查詢指定了該欄位，則尋找這些工作項目的效能可能會提高。 如果您加入會在許多工作項目查詢中使用的自訂欄位，則可以考慮啟用該欄位的索引。

  • changefield：變更一個或多個欄位的屬性 (如好記的欄位名稱、資料倉儲報告的屬性，或能夠同步處理包含人名的欄位)。 啟用同步處理時，欄位會隨著對 Active Directory 或工作群組進行更新而更新。 如需如何使用欄位進行報告的相關資訊，請參閱 使用工作項目欄位。

    重要事項重要事項

    當您從舊版本升級至目前版本時，所有包含人員名稱的 [字串] 欄位其 syncnamechanges 屬性所有內建的欄位會設定 true。 但是，您必須將手動將屬性指派給任何您用來儲存連絡人名稱和您想要有同步處理的自訂欄位。 如需詳細資訊，請參閱將自訂人員名稱欄位更新為與 Active Directory 或工作群組同步處理。

witadmin 命令列工具在執行 Team 總管 的用戶端電腦中位於 磁碟機：\Program Files\Microsoft Visual Studio 10.0\Common7\IDE 內。 

如需欄位的詳細資訊，請參閱定義工作項目欄位。

注意事項注意事項

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

必要的使用權限

對於定義工作項目類型欄位的 Team 專案集合，您必須已設定下列權限：

  • 您必須是 [Readers] 群組的成員，或是已將 [檢視此節點中的工作項目] 權限設為 [允許]，才能列出欄位

  • 若要刪除或重新命名欄位，或變更欄位的報告特性，您必須是 [Team Foundation Administrators] 安全性群組或 [Project Administrators] 安全性群組的成員。

如需詳細資訊，請參閱Team Foundation Server 使用權限和Team Foundation Server 預設群組、使用權限和角色。

注意事項注意事項

即使您使用系統管理權限登入，還是必須開啟較高權限的命令提示字元視窗，在執行 Windows Server 2008 的伺服器上執行此功能。 若要開啟更高權限的 [命令提示字元] 視窗，請按一下 [開始]，並以滑鼠右鍵按一下 [命令提示字元]，然後按一下 [以系統管理員身分執行]。 如需詳細資訊，請參閱 Microsoft 網站：使用者帳戶控制。

 
witadmin deletefield /collection:CollectionURL /n:RefName [/noprompt]

witadmin listfields /collection:CollectionURL /n:RefName [/unused]

witadmin indexfield /collection:CollectionURL /n:Name /index:on|off 

witadmin changefield /collection:CollectionURL /n:RefName [/name:NewName] [/syncnamechanges:true | false] [/reportingname:ReportingName] [/reportingrefname:ReportingRefName] [/reportingtype:Type] [/reportingformula:Formula] [/noprompt]

參數

參數

描述

/collection:CollectionURL

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

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

http://ServerName:Port/CollectionName

/n:RefName

/n:Name

工作項目類型欄位的參考名稱。

/index

指定啟用或停用指定欄位的索引功能。 指定 on 可啟用索引，off 可停用索引。

/name:NewName

指定欄位的新名稱。

/syncnamechanges

指定要使用工作項目欄位來儲存名稱，並隨著對 Active Directory 或工作群組所做的變更進行更新。 此選項只有在為 typename 指定資料型別為字串的欄位時才有效。

指定 true 可啟用資料欄位的同步處理，指定 false 可停用資料欄位的同步處理。

/reportingname:ReportingName

指定資料倉儲中要用來進行報告的欄位名稱。

/reportingrefname:ReportingRefName

指定資料倉儲中要用來進行報告的欄位參考名稱。

/reportingtype:Type

指定在倉儲中如何使用欄位進行報告。 下列是有效值：

  • dimension: 用於 Integer、String 或 DateTime 欄位。

  • detail: 用於 Integer、Double、String 或 DateTime 欄位。

  • measure: 用於 Integer 和 Double 欄位。 預設的彙總 (Aggregation) 類型為 sum。 您可以使用 formula 參數指定另一個彙總類型。

  • disable: 用於停用欄位上的報告功能。

如需詳細資訊，請參閱使用工作項目欄位。

/reportingformula:Formula

指定當欄位報告為 measure 時會使用彙總公式。 唯一支援的公式是 sum。

/unused

列出 Team 專案集合中定義的任何 Team 專案不使用的所有欄位。

/noprompt

停用確認提示。

/? or help

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

備註

當您將 syncnamechanges 屬性指派給 [字串] 欄位時，此欄位一律接受有效的使用者名稱。 但是，如果下列條件有任何一個為 true，則欄位不允許群組名稱儲存在 Team Foundation Server 或 Active Directory 中：

  • VALIDUSER 規則會在所有工作項目類型中指定

  • 會為工作項目類型指定 VALIDUSER 規則

  • ALLOWEDVALUES 規則已指定給工作項目類型，而且該規則的篩選準則已排除群組

如需詳細資訊，請參閱所有 FIELD XML 項目參考。

如需進行索引的系統欄位摘要，請參閱使用系統欄位和 MSF 流程範本所定義的欄位。

範例

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

  • Team 專案集合的 URI：http://AdventureWorksServer:8080/AWTeam/Collection1

  • 工作項目欄位名稱：AdventureWorks.Field

  • 預設的編碼方式：UTF-8

清單欄位

下列命令會顯示為 AdventureWorksServer 伺服器上 Collection1 定義的每個欄位其相關資訊：

witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1

下列命令會顯示指定之欄位 AdventureWorks.Field (由 Collection1 使用) 的欄位資訊：

witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field

下列命令會顯示 Collection1 未使用的所有欄位：

witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /unused

重新命名欄位

下列命令會將所參考之欄位 AdventureWorks.Field 的易記名稱變更為 Collection1 的 NewFieldName：

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field /name:NewFieldName

將報表變更為欄位值

下列命令會將 DateTime 欄位 AdventureWorks.CreatedOn 的報告功能類型指定為 dimension。 此欄位的資料會進入倉儲和 Analysis Services 資料庫，以便能夠用來篩選報告。

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.CreatedOn /reportingtype:dimension

下列命令會將 Double 欄位 AdventureWorks.Field 的報告功能類型指定為 measure。 所有 measure 值會使用 sum 來彙總 (Aggregate)。

witadmin reportfield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field /reportingtype:measure

啟用自訂名稱欄位的同步處理

下列命令可同步處理為 AdventureWorksServer 上的 Collection1 所定義的工作項目欄位 AW.CustomerName。

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AW.CustomerName /syncnamechanges:true

刪除欄位

下列命令會將欄位 AdventureWorks.Field 從 Collection1 刪除：

witadmin deletefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field

請參閱

工作

列出工作項目欄位和檢視指派給欄位的屬性

概念

使用系統欄位和 MSF 流程範本所定義的欄位

其他資源

解決資料倉儲中發生的結構描述衝突

定義工作項目欄位

加入和修改工作項目欄位以支援報告

定義工作項目欄位

witAdmin：管理追蹤工作項目的物件