變更工作項目表單配置

您可以透過匯出 XML 檔並修改 FORM 區段的內容，變更工作項目表單配置。 在您修改並匯入 XML 檔之後，就可以確認您在更新之工作項目類型中所做的變更。 您可以變更的配置類型包括但不限於下列各項：

• 變更表單上欄位的標籤或位置。

• 將欄位群組從某個索引標籤移動到另一個索引標籤

• 加入新的索引標籤或資料行

如需可以在工作項目表單中放置之控制項的概觀，請參閱指定工作項目表單控制項。 如需 FORM 區段之最上層結構項目的概觀，請參閱 設計工作項目表單的配置.

本主題內容

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

• 變更定義檔 FORM 區段的配置

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

必要的使用權限

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

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

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

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

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

  1. 執行 witadmin exportwitd，以針對您想要修改的工作項目類型匯出 XML 檔。 如需詳細資訊，請參閱自訂和管理工作項目類型 [witadmin]。

     注意事項
     如果您是執行 Windows Vista，則可能沒有存取特定資料夾的權限。 如果嘗試將工作項目類型匯出至您無法存取的位置，登錄模擬技術便會自動重新導向至已匯出的檔案，並將該檔案儲存在虛擬存放區中。 若要避免此重新導向，可以將此檔案匯出至您能存取的位置。 如需登錄模擬的詳細資訊，請參閱 Microsoft 網站的下列頁面：登錄模擬 (英文) 和 Windows Vista 中常見的檔案及登錄模擬問題。

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

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

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

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

  1. 移至已下載流程範本的位置。

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

回到頁首

變更定義檔 FORM 區段的配置

若要變更表單配置

1. 尋找 XML 檔的 <TabGroup> 區段。 請注意，Links 和 File Attachments 這類項目 (Item) 含有 <Tab> 項目 (Element)，其中的每個 <Tab> 項目 (Element) 都包含可呈現各自控制項的 <Control> 項目 (Element)。

   <Tab Label="Links">
     <Control Type="LinksControl" />
   </Tab>
   <Tab Label="File Attachments">
     <Control Type="AttachmentsControl" />
   </Tab>
   

2. 將上一個步驟中所示的 XML 程式碼取代成下列範例中所示的新 XML 程式碼，即可將兩個 <Tab> 項目合併成包含兩個控制項的單一 Links and Attachments <Tab> 項目：

   <Tab Label="Links and Attachments">
     <Control Type="LinksControl" Label="Links" LabelPosition="Top" />
     <Control Type="AttachmentsControl" Label="Attachments" LabelPosition="Top" />
   </Tab>
   

3. 尋找 <FORM>、<Layout> 定義的區段，其中描述您想要修改的群組，例如 Classification 群組。

   <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>
   

   注意事項
   為了得到最佳結果，即使資料行橫跨表單的整個寬度，每個控制項或群組還是應該會顯示在資料行中。 因此，即使群組沒有可見的標籤或界限，每個資料行也都應該會顯示在群組中。

4. 選取下列範例中粗體顯示的程式碼行，然後按一下 [編輯] 功能表上的 [複製]，將此內容複製到剪貼簿供之後使用。

     <Column PercentWidth="70">
       <Group>
         <Column PercentWidth="100">
           <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>
         </Column>
       </Group>
     </Column>
   

5. 刪除下列 XML 程式碼中粗體顯示的程式碼行，即可從表單上的目前位置中移除 Classification 群組。

   <Layout>
     <Group>
       <Column PercentWidth="70">
         <Control Type="FieldControl" FieldName="System.Title" Label="&amp;Title:" LabelPosition="Left" />
       </Column>
       <Column PercentWidth="30">
         <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Discipline" Label="&amp;Discipline:" LabelPosition="Left" />
       </Column>
     </Group>
     <Group Label="Classification">
       <Column PercentWidth="100">
         <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="&amp;Area:" LabelPosition="Left" />
         <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="&amp;Iteration:" LabelPosition="Left" />
       </Column>
     </Group>
   

6. 在 <TabGroup> 區段中，尋找下列定義 [詳細資料] 索引標籤的程式碼行：

   <Tab Label="Details">
     <Group>
       <Column PercentWidth="50">
         <Group Label="General">
           <Column PercentWidth="100">
             <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Iss&amp;ue:" LabelPosition="Left" />
             <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.ExitCriteria" Label="E&amp;xit criteria:" LabelPosition="Left" />
             <Control Type="FieldControl" FieldName="Microsoft.VSTS.Build.IntegrationBuild" Label="Integration &amp;build:" LabelPosition="Left" />
             <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.TaskHierarchy" Label="Task C&amp;ontext:" LabelPosition="Left" ReadOnly="True" />
           </Column>
         </Group>
       </Column>
       <Column PercentWidth="50">
         <Group Label="Schedule">
           <Column PercentWidth="100">
             <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.RemainingWork" Label="Remaining &amp;work (hours):" LabelPosition="Left" />
             <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.CompletedWork" Label="Com&amp;pleted work (hours):" LabelPosition="Left" />
             <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.StartDate" Label="Start Dat&amp;e:" LabelPosition="Left" ReadOnly="True" />
             <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.FinishDate" Label="&amp;Finish Date:" LabelPosition="Left" ReadOnly="True" />
           </Column>
         </Group>
       </Column>
     </Group>
   </Tab>
   

7. 將剪貼簿的內容貼到下列位置，即可將這些控制項移到 [Details] 索引標籤。

   <Tab Label="Details">
     <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
     <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
     <Group>
       <Column PercentWidth="50">
         <Group Label="General">
           <Column PercentWidth="100">
             <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Iss&amp;ue:" LabelPosition="Left" />
   ...
   

8. 進行下列範例中粗體顯示的變更，在移動的欄位周圍建立群組，並將這些欄位分成兩個資料行。

   <Tab Label="Details">
     <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>
     <Group>
       <Column PercentWidth="50">
         <Group Label="General">
           <Column PercentWidth="100">
             <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Iss&amp;ue:" LabelPosition="Left" />
   ...
   

9. 在工具列上，按一下 [儲存] 儲存對 XML 檔所做的變更。

10. 若要將新的工作項目類型匯入單一專案，請參閱自訂和管理工作項目類型 [witadmin]。 若要將工作項目類型加入至流程範本，請參閱將工作項目的類型定義加入至流程範本。

回到頁首

確認網頁或 HTML 內容出現在工作項目表單中

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

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

   這些更新檔含有您剛匯入的變更。 等候數秒，直到載入 [工作項目] 節點為止。 仍在載入中的節點會顯示 [正在執行] 一詞。

2. 使用您所修改的工作項目類型，建立新的工作項目。 若要這樣做，請以滑鼠右鍵按一下 [工作項目] 節點、指向 [加入工作項目]，然後按一下工作項目類型。

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

   請注意，類別 (Classification) 群組不再顯示於主要表單上。 按一下 [連結和附件] (Links and Attachments) 索引標籤和 [詳細資料] (Details) 索引標籤，查看您所做的變更結果。

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

回到頁首

請參閱

工作

變更欄位的標籤

加入和自訂工作項目的類型

參考

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

概念

設計工作項目表單的配置

指定工作項目表單控制項

設計和自訂工作項目表單