共用方式為

在工作項目類型中加入欄位或移除欄位

  • 發行項

若要在工作項目類型中加入或移除資料欄位，您可以修改工作項目類型定義檔。 您必須在 FIELDS 區段中加入或移除 FIELD 項目，也要加入或移除 FORM 區段中定義的配置和控制項。 在您修改工作項目類型之後，就可以匯入這個 XML 檔，開始使用更新的工作項目類型。

重要事項重要事項

工作項目類型欄位是以 Team 專案集合為單位來管理。 如需詳細資訊，請參閱管理工作項目欄位 [witadmin]。

本主題內容

  • 匯出和開啟工作項目類型定義檔

  • 加入欄位

  • 移除欄位

  • 匯入工作項目類型定義檔

  • 確認您的變更出現在工作項目表單中

必要的使用權限

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

匯出和開啟工作項目類型定義檔

若要匯出和開啟工作項目類型定義檔

  • 根據您想要執行的自訂範圍，執行下列其中一個步驟：

    如果您要修改單一專案的工作項目類型：

    1. 執行 witadmin exportwitd，針對想要修改的工作項目類型匯出 XML 檔。 輸入下列命令，並將顯示的引數改為您的資料：

      witadmin exportwitd /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /p:project /n:typename /f:filename

      如需詳細資訊，請參閱 從現有專案匯出和匯入工作項目類型。

    2. 在 Visual Studio 中，依序按一下 [檔案]、[開啟] 和 [檔案]。

      [開啟檔案] 對話方塊隨即出現。

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

    如果您要修改工作項目類型以自訂流程範本：

    1. 尋找已下載流程範本的位置。

    2. 選取您想要更新的工作項目類型 XML 檔，然後按一下 [開啟]。 然後在收到關於行尾結束符號的提示時，按一下 [否]。

加入欄位

若要將欄位加入至工作項目類型

  1. 尋找 XML 檔的下列區段：

    <FIELDS>

  2. 輸入下列範例中粗體顯示的 XML 程式碼來建立字串欄位：

    <FIELDS>
<FIELD name="Issue Level" refname="MyCompany.MyProcess.IssueLevel" type="String" reportable="Dimension">
</FIELD>
    注意事項注意事項

    參考名稱 (或 refname) 為此欄位的程式設計名稱， 所有其他規則都應該要參考這個 refname。 如需詳細資訊，請參閱 工作項目追蹤物件的命名慣例。

  3. 尋找 XML 檔中描述此工作項目表單的區段：

    <FORM>

  4. 在 <FORM> 區段中尋找下列程式碼行：

    <Group Label="Classification">
  <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>

  5. 輸入下列範例中粗體顯示的 XML 程式碼來插入要顯示欄位的控制項：

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

  6. 在 [檔案] 功能表上，按一下 [儲存 <檔案名稱>.xml]，即可儲存對此 XML 檔案的變更。

  7. 若要將新的工作項目類型匯入至單一專案，請參閱匯入工作項目類型定義檔。 若要將工作項目類型加入至流程範本，請參閱將工作項目的類型定義加入至流程範本。

移除欄位

若要從工作項目類型表單移除欄位

  1. 尋找並刪除您想要從工作項目類型中移除之欄位的定義。 下列範例會顯示名為 "Issue Level" 的欄位。 若要移除這個欄位，您可以刪除下列欄位區段：

    注意事項注意事項

    XML 檔中的欄位區段可能不會包含下列程式碼中的所有項目。 不過，如果您已自訂工作項目類型欄位來包含這些項目，您也必須刪除這些項目。

    		 
    <FIELDS>
. . .
<FIELD name="Issue Level" refname="MyCompany.MyProcess.IssueLevel" type="String" reportable="dimension">
<HELPTEXT>Describes the issue level 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>
…
</FIELDS>

  2. 尋找定義工作項目欄位控制項的 <Layout> 區段，然後刪除適當的區段以移除欄位。 下列粗體顯示的區段為您應該尋找之部分的範例。

    <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.IssueLevel" Label="IssueLevel" LabelPosition="Left" />
      </Column>
    </Group>
  </Column>
</Group>

  3. 在 [檔案] 功能表上，按一下 [儲存 <檔案名稱>]，儲存對 XML 檔所做的變更。

匯入工作項目類型定義檔

若要匯入工作項目類型定義檔

  • 執行 witadmin importwitd，針對您已修改的工作項目類型匯入 XML 檔案。 輸入下列命令，並將顯示的引數改為您的資料：

    witadmin importwitd /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /p:project /n:typename /f:filename

    如需詳細資訊，請參閱 從現有專案匯出和匯入工作項目類型。

確認您的變更出現在工作項目表單中

若要驗證匯入單一專案的變更

  1. 在 Team 總管中，以滑鼠右鍵按一下 Team 專案中含有您所修改之工作項目類型定義的節點，並按一下 [重新整理]。

    會從伺服器下載最新的更新 (包括您剛剛匯入的變更)。 在重新整理 [工作項目] 節點之前，請等候數秒。 仍在載入中的節點會顯示 [正在執行] 一詞。

  2. 以滑鼠右鍵按一下 [工作項目] 節點，並指向 [加入工作項目]，然後按一下修改過的工作項目類型，就可以使用該工作項目類型建立工作項目。

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

  3. 確認您所做的變更出現在工作項目表單中。

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

請參閱

參考

自訂和管理工作項目類型 [witadmin]

FIELD (定義) 項目

Control XML 項目參考

概念

使用工作項目欄位

其他資源

定義工作項目欄位