共用方式為

逐步解說：管理工作項目類型中的欄位

  • 發行項

更新：2007 年 11 月

在本逐步解說中，您將會檢視、重新命名及刪除 Team Foundation Server 上的工作項目類型所用的欄位。欄位可以橫跨不同 Team 專案的許多工作項目類型。

本章節包括下列程序：

  • 檢視欄位：在這個程序中，您將會輸出工作項目類型的欄位，然後再檢視這些欄位。

  • 重新命名欄位：在這個程序中，您將會變更欄位的名稱，並查看變更出現在表單上的哪一個位置。

  • 刪除欄位：在這個程序中，您將會刪除前一個程序加入到工作項目表單中的欄位。

必要條件

完成逐步解說：對工作項目類型進行基本自訂和逐步解說：對工作項目類型進行進階自訂中的步驟。

如果您可以建立與 Team Foundation Server 之間的連接，且具有適當的權限，就可以在命令提示字元、批次檔或指令碼檔中管理工作項目類型中的欄位。若要這麼做，您必須使用 [Visual Studio 2008 命令提示字元] 公用程式，或是透過 vsvars32 在目前的命令提示字元中設定幾個環境變數，如下列範例所示。如需聯結 Team 專案的詳細資訊，請參閱逐步解說：聯結 Team 專案。

若要在命令提示字元中啟用 Team Foundation 命令

  • 依序按一下 [開始]、[所有程式]，並依序指向 [Microsoft Visual Studio 2008]、[Visual Studio Tools]，然後按一下 [Visual Studio 2008 命令提示字元]。

另外，您也可以在 Visual Studio 安裝路徑 (通常是 DriveLetter:\Program Files\Microsoft Visual Studio 9.0\Common7\Tools) 中執行 vsvars32。

必要權限

您必須是 [Team Foundation Administrators] 群組的成員或專案之 [Project Administrators] 群組的成員，才能執行此程序。如需詳細資訊，請參閱 Team Foundation Server 使用權限。

檢視欄位

若要檢視欄位

  1. 開啟 Visual Studio 命令提示字元。

  2. 在命令提示字元輸入下列命令並按 ENTER，將 Team Foundation Server 上所定義的所有欄位輸出到文字檔。

  3. witfields view /s:"Team Foundation Server 名稱"

    這樣會顯示欄位的清單，並包含下列資訊：

    欄位：

    欄位的參考名稱。

    名稱：

    欄位的易記名稱。

    型別：

    欄位的資料型別。

    可報告為：

    欄位的報告設定。

    使用：

    使用這個欄位的 Team 專案，以及此欄位出現所在的工作項目類型。

重新命名欄位

若要將欄位重新命名

  1. 在 Visual Studio 命令提示字元中，輸入下列命令，然後按 ENTER 鍵。

    witfields rename /s:"Team Foundation Server 名稱" Microsoft.VSTS.Common.Rank Importance

    這個命令會將 [Rank] 欄位重新命名為 [Importance]。

  2. 在確認提示中，輸入 y，並按 ENTER，然後等候下列訊息出現：

    Field renamed.

  3. 在 Visual Studio 的 Team 總管視窗中，按一下 [重新整理]，從伺服器下載最新的更新檔。

    等候數秒，直到載入所有節點為止。仍在載入中的節點會顯示 [正在執行] 一詞。

  4. 以滑鼠右鍵按一下 [工作項目] 節點，然後選取 [加入查詢]，建立新的查詢。

  5. 按一下標記為 [按一下這裡加入子句] 的區域，加入新的資料列，然後選取空白的 [欄位] 儲存格，在此儲存格中輸入 Rank。請注意出現在結果清單上方的下列訊息，這個訊息表示找不到 Rank。

    執行查詢以檢視查詢結果。TF51005: 查詢參考不存在的欄位。這個錯誤是因為 <<Rank>> 所造成。

  6. 從 [欄位] 儲存格刪除 Rank 值，然後將 Importance 輸入到儲存格中。

  7. 選取 [運算子] 儲存格中的 [<>]，然後將 1 輸入到 [值] 儲存格中。

  8. 在 [小組] 功能表上，按一下 [執行查詢]。

  9. 以滑鼠右鍵按一下結果中的任何資料列，並選取 [資料行選項]，然後向下捲動 [可用的欄] 清單。請注意，[Rank] 欄位將不再出現，但是可以看到 [Importance] 欄位。

  10. 選取 [可用的欄] 方塊中的 [Importance]，並按一下加入選取的欄按鈕 ([>])，然後按一下 [確定]。

    請注意，在整個查詢產生器和結果清單中，Microsoft.VSTS.Common.Rank 的易記名稱已經從 Rank 重新命名為 Importance。

  11. 按一下 [關閉]，關閉查詢。當您收到儲存此查詢的提示時，請按一下 [否]。

  12. 建立新的 Special Task 工作項目。若要這樣做，請以滑鼠右鍵按一下 [工作項目] 節點，並指向 [加入工作項目]，然後按一下 [SpecialTask]。

    此工作項目是根據您所變更並匯入的工作項目類型建立。

  13. 請注意在 [狀態] 方塊中，重新命名的欄位 [Rank] 之標籤並未變更，這是因為工作項目表單上的欄位標籤是以 Team 父專案為範圍，而且與剛剛指定的整個伺服器範圍的欄位名稱無關。

    注意事項：

    如需如何在工作項目表單上變更欄位標籤的詳細資訊，請參閱逐步解說：對工作項目類型進行進階自訂中的＜自訂欄位標籤＞程序。

  14. 按一下 [關閉] 關閉新的「特殊工作」。當您收到儲存工作項目的提示時，請按一下 [否]。

刪除欄位

必要條件：您已經完成逐步解說：對工作項目類型進行基本自訂中的＜加入欄位＞程序。

若要刪除欄位

  1. 嘗試刪除之前在加入欄位程序中所加入的 [分類] 欄位。若要這樣做，請在 Visual Studio 命令提示字元中輸入下列命令，然後按 ENTER 鍵。

    witfields delete /s:"Team Foundation Server 名稱" MyCompany.MyProcess.Category

    傳回的錯誤訊息指出，無法刪除此欄位，因為目前有 Team 專案正在使用它。

  2. 輸入下列命令，然後按 ENTER。

    witexport /f "File Path\specialtask.xml" /t "Team Foundation Server name" /p WITLab /n "Special Task"

    這樣會將 Special Task 的工作項目類型定義從 Team Foundation Server 重新匯出至 XML 檔，其中包括 Microsoft.VSTS.Common.Rank 欄位的新定義，而且使用的是它在重新命名欄位程序中重新命名之後新的易記名稱。

    注意事項：

    如果您是執行 Windows Vista，則可能沒有存取特定資料夾的權限。如果嘗試將工作項目類型匯出至您無法存取的位置，登錄模擬技術便會自動重新導向至已匯出的檔案，並將該檔案儲存在虛擬存放區中。如需詳細資訊，請參閱 https://msdn2.microsoft.com/zh-tw/library/aa965884.aspx 和 https://go.microsoft.com/fwlink/?LinkId=92323。若要避免此重新導向，可以將此檔案匯出至您能存取的位置。

    當匯出作業完成時，您會收到下列訊息：

    Work item type export complete.

  3. 在 Visual Studio 中，按一下 [檔案]、指向 [開啟]，然後按一下 [檔案]。

    如此會顯示 [開啟檔案] 對話方塊。

    注意事項：

    如果 SpecialTask.xml 已開啟，您可能會收到訊息，詢問您是否要將檔案重新載入 Visual Studio。按一下 [是] 重新載入檔案。

  4. 在 [查詢] 下，移至匯出檔案的位置。

  5. 按一下 specialtask.xml 檔案，然後再按 [開啟]。

  6. 如果出現行尾結束符號的提示，請按一下 [否]。

  7. 尋找並刪除 [分類] 欄位的定義，如下列 XML 中所示：

    <FIELD name="Category" refname="MyCompany.MyProcess.Category" type="String" reportable="dimension"><HELPTEXT>Describes the category to which this special task belongs.</HELPTEXT>  <WHEN field="Microsoft.VSTS.Common.Discipline" value="Business Analyst">    <ALLOWEDVALUES>      <LISTITEM value="Planning" />      <LISTITEM value="Review" />    </ALLOWEDVALUES>  </WHEN>  <WHENNOT field="Microsoft.VSTS.Common.Discipline" value="Business Analyst">    <ALLOWEDVALUES>      <LISTITEM value="Process Management" />      <LISTITEM value="Planning" />      <LISTITEM value="Execution" />      <LISTITEM value="Review" />    </ALLOWEDVALUES>  </WHENNOT></FIELD>

  8. 在 <Layout> 區段中，尋找下列 XML 程式碼，然後刪除粗體字的區段，移除此欄位：

    <Group Label="Classification">
  <Column PercentWidth="50">    <Group>
      <Column PercentWidth="100">
        <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
        <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
      </Column>
    </Group>  </Column>  <Column PercentWidth="50">    <Group>      <Column PercentWidth="100">        <Control Type="FieldControl" FieldName="MyCompany.MyProcess.Category" Label="Category" LabelPosition="Left" />      </Column>    </Group>  </Column>
</Group>

  9. 按一下 [儲存] 儲存對 XML 檔所做的變更。

  10. 將變更的 Special Task 工作項目類型匯入至 Team Foundation Server 中。若要這樣做，請在 Visual Studio 命令提示字元中輸入下列命令，然後再按 ENTER：

    witimport /f "File Path\specialtask.xml" /t "Team Foundation Server name" /p WITLab

    這會將 specialtask 工作項目類型匯入至 Team Foundation Server 中。當匯入作業完成時，您會收到下列訊息：

    Work item type import complete.

  11. 在命令提示字元中輸入下列命令，並按 ENTER，確認目前已經沒有任何工作項目類型使用此 [分類] 欄位。

    witfields view /s:"Team Foundation Server 名稱" MyCompany.MyProcess.Category

    witfields 工具會顯示 [分類] 為「未使用」。

    Field: MyCompany.MyProcess.Category

    Name: Category

    Type: String

    Reportable As: dimension

    Use: Not In Use

  12. 現在已經沒有任何工作項目類型使用此 [分類] 欄位，請在命令提示字元輸入下列文字並按 ENTER，即可永久從 Team Foundation Server 刪除此欄位。請在確認提示中輸入 y，即可完成這個步驟。

    witfields delete /s:"Team Foundation Server 名稱" MyCompany.MyProcess.Category

請參閱

工作

逐步解說：對工作項目類型進行基本自訂

逐步解說：對工作項目類型進行進階自訂

其他資源

自訂工作項目類型