在工作項目類型中加入欄位或移除欄位
若要在工作項目類型中加入或移除資料欄位,您可以修改工作項目類型定義檔。 您必須在 FIELDS 區段中加入或移除 FIELD 項目,也要加入或移除 FORM 區段中定義的配置和控制項。 在您修改工作項目類型之後,就可以匯入這個 XML 檔,開始使用更新的工作項目類型。
重要
工作項目類型欄位是以 Team 專案集合為單位來管理。如需詳細資訊,請參閱管理工作項目欄位 [witadmin]。
本主題內容
匯出和開啟工作項目類型定義檔
加入欄位
移除欄位
匯入工作項目類型定義檔
確認您的變更出現在工作項目表單中
必要的使用權限
您必須是 [Team Foundation Administrators] 群組的成員或專案之 [Project Administrators] 群組的成員,才能執行此程序。 如需詳細資訊,請參閱Team Foundation Server 使用權限。
匯出和開啟工作項目類型定義檔
若要匯出和開啟工作項目類型定義檔
根據您想要執行的自訂範圍,執行下列其中一個步驟:
如果您要修改單一專案的工作項目類型:
執行 witadmin exportwitd,針對想要修改的工作項目類型匯出 XML 檔。 輸入下列命令,並將顯示的引數改為您的資料:
witadmin exportwitd /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /p:project /n:typename /f:filename
如需詳細資訊,請參閱從現有專案匯出和匯入工作項目類型。
在 Visual Studio 中,依序按一下 [檔案]、[開啟] 和 [檔案]。
[開啟檔案] 對話方塊隨即出現。
在 [查詢] 下,移至匯出檔案的位置。
如果您要修改工作項目類型以自訂流程範本:
尋找已下載流程範本的位置。
選取您想要更新的工作項目類型 XML 檔,然後按一下 [開啟]。 然後在收到關於行尾結束符號的提示時,按一下 [否]。
加入欄位
若要將欄位加入至工作項目類型
尋找 XML 檔的下列區段:
<FIELDS>
輸入下列範例中粗體顯示的 XML 程式碼來建立字串欄位:
<FIELDS> <FIELD name="Issue Level" refname="MyCompany.MyProcess.IssueLevel" type="String" reportable="Dimension"> </FIELD>
注意事項 參考名稱 (或 refname) 為此欄位的程式設計名稱,所有其他規則都應該要參考這個 refname。如需詳細資訊,請參閱工作項目追蹤物件的命名慣例。
尋找 XML 檔中描述此工作項目表單的區段:
<FORM>
在 <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>
輸入下列範例中粗體顯示的 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>
在 [檔案] 功能表上,按一下 [儲存 <檔案名稱>.xml],即可儲存對此 XML 檔案的變更。
若要將新的工作項目類型匯入至單一專案,請參閱匯入工作項目類型定義檔。 若要將工作項目類型加入至流程範本,請參閱將工作項目的類型定義加入至流程範本。
移除欄位
若要從工作項目類型表單移除欄位
尋找並刪除您想要從工作項目類型中移除之欄位的定義。 下列範例會顯示名為 "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>
尋找定義工作項目欄位控制項的 <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>
在 [檔案] 功能表上,按一下 [儲存 <檔案名稱>],儲存對 XML 檔所做的變更。
匯入工作項目類型定義檔
若要匯入工作項目類型定義檔
執行 witadmin importwitd,針對您已修改的工作項目類型匯入 XML 檔案。 輸入下列命令,並將顯示的引數改為您的資料:
witadmin importwitd /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /p:project /n:typename /f:filename
如需詳細資訊,請參閱從現有專案匯出和匯入工作項目類型。
確認您的變更出現在工作項目表單中
若要驗證匯入單一專案的變更
在 Team Explorer中,以滑鼠右鍵按一下 Team 專案中含有您所修改之工作項目類型定義的節點,並按一下 [重新整理]。
會從伺服器下載最新的更新 (包括您剛剛匯入的變更)。 在重新整理 [工作項目] 節點之前,請等候數秒。 仍在載入中的節點會顯示 [正在執行] 一詞。
以滑鼠右鍵按一下 [工作項目] 節點,並指向 [加入工作項目],然後按一下修改過的工作項目類型,就可以使用該工作項目類型建立工作項目。
此工作項目是根據您所變更的工作項目類型而建立。
確認您所做的變更出現在工作項目表單中。
按一下 [關閉] 關閉新的工作項目。 當您收到儲存工作項目的提示時,請按一下 [否]。