共用方式為


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

若要在工作項目類型中加入或移除資料欄位,您可以修改工作項目類型定義檔。 您必須在 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 Explorer中,以滑鼠右鍵按一下 Team 專案中含有您所修改之工作項目類型定義的節點,並按一下 [重新整理]。

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

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

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

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

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

請參閱

參考

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

FIELD (定義) 項目

Control XML 項目參考

概念

使用工作項目欄位

其他資源

定義工作項目欄位