編輯 WIT 定義以便將 Web 內容加入至工作項目表單

發行項
06/10/2015

匯出類型定義 XML 檔，並在 WebpageControl 區段中加入 FORM，就可以將 Web 內容或 HTML 內容加入工作項目表單。在您修改並匯入 XML 檔之後，就可以確認 Web 內容在更新之工作項目類型中的顯示。

您可以使用下列其中一種方法指定顯示的 Web 內容：

網頁的 URL
根據一個或多個針對工作項目定義的欄位值，在執行階段動態決定的 URL 路徑
HTML 內容

如需有關用來將 Web 內容加入工作項目類型 (WIT) 之項目 (Element) 語法結構的詳細資訊，請參閱 WebpageControlOptions XML 項目參考和Link 和 Param XML 項目參考。

需求

您必須是 Team 專案的 [Project Administrators] 群組成員。請參閱將使用者加入至 Team 專案。

匯出並開啟 WIT 定義檔

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

如果您要修改單一專案的工作項目類型：
1. 執行 witadmin exportwitd，針對想要修改的工作項目類型匯出 XML 檔。如需詳細資訊，請參閱匯入、匯出和管理工作項目類型 [witadmin]。
2. 在 Visual Studio 中，依序選擇 [檔案]、[開啟]、[檔案]。
3. 在 [查詢] 下，移至匯出檔案的位置。
如果您要修改工作項目類型以自訂流程範本：
1. 尋找已下載流程範本的位置。
2. 選取您想要更新的工作項目類型 XML 檔，然後選擇 [開啟]。然後在收到關於行尾結束符號的提示時，按一下 [否]。

將 Web 內容加入定義檔的 FORM 區段

尋找 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>
```

加入新的 <Tab> 項目 (Element)，內含想要顯示在工作項目 (Item) 表單的 Web 或 HTML 內容。根據您定義 Web 內容的方式，將下列程式碼複製到檔案的 <TabGroup> 區段中。

若要指定網頁的 URL：

<Tab Label="Tab Label">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl" Name="Webpage" Label=" Name of Web Page" LabelPosition="Top" >
            <WebpageControlOptions AllowScript="false">
               <Link UrlRoot="URL of Web Page" />
            </WebpageControlOptions>
         </Control>
      </Column>
   </Group>
</Tab>

使用您想在工作項目表單上顯示的資訊，來取代 Tab Label 和 URL of Web Page。

若要指定在執行階段決定的動態 URL：

<Tab Label="Tab Label">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl" Name="Webpage" Label=" Name of Web Page" LabelPosition="Top" >
            <WebpageControlOptions AllowScript="false">
               <Link UrlRoot="URL of Web Page" URLPath="URL path with parameters >
      <Param Index="0" Value="Param Value 0"/>
      <Param Index="1" Value="Param Value 1"/>
      <Param Index="2" Value="Param Value 2"/>
               </Link>
            </WebpageControlOptions>
         </Control>
      </Column>
   </Group>
</Tab>

使用您想在工作項目表單上顯示的資訊，來取代 Tab Label、URL of Web Page、URL path with parameters，以及 Param Value 1、2 and 3。

若要指定 HTML 內容：

<Tab Label="Tab Label">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl">
            <Content>
               <![CDATA[HTML Content]]>
            </Content>
         </Control>
      </Column>
   </Group>
</Tab>

使用您想在工作項目表單上顯示的資訊，來取代 Tab Label 和 HTML Content。

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

將您的變更儲存到 XML 檔案。
使用 witadmin importwitd 將新的工作項目類型匯入單一專案。若要將工作項目類型加入至流程範本，請參閱將工作項目的類型定義加入至流程範本。

確認網頁或 HTML 內容出現在表單中

在 Team Explorer 中，開啟 Team 專案中含有您所修改之 WIT 定義的工作項目，並選擇 [ 重新整理]。

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

請確認網頁或 HTML 內容依預期顯示在表單上。
選擇 [關閉] 即可關閉新的工作項目。