编辑 WIT 定义以向工作项窗体添加 Web 内容

项目
06/09/2015

您可以通过导出类型定义 XML 文件并在 WebpageControl 节中添加 FORM 来向工作项窗体添加 Web 内容或 HTML 内容。修改并导入 XML 文件之后，可以验证 Web 内容在更新的工作项类型中的显示。

可以采用以下方式之一来指定所显示的 Web 内容：

网页的 URL
在运行时根据为工作项定义的一个或多个字段值动态确定的 URL 路径
HTML 内容

有关用于向工作项类型 (WIT) 中添加 Web 内容的元素的语法结构的信息，请参阅 WebpageControlOptions XML 元素引用和 Link 和 Param XML 元素引用。

要求

你必须是团队项目的**“项目管理员”**组的成员。请参阅向团队项目添加用户。

导出并打开 WIT 定义文件

根据要执行的自定义的范围，执行以下步骤之一：

如果要修改单个项目的工作项类型：
1. 运行 witadmin exportwitd 导出要修改的工作项类型的 XML 文件。有关详细信息，请参阅导入、导出和管理工作项类型 [witadmin]。
2. 在 Visual Studio 中，依次选择**“文件”、“打开”和“文件”**。
3. 在**“查找范围”**之下，移动到您导出该文件的位置。
如果要修改工作项类型以自定义过程模板：
1. 查找下载过程模板的位置。
2. 选择要更新的工作项类型 XML 文件，然后选择**“打开”。出现有关行尾的提示时，单击“否”**。

向定义文件的 FORM 节添加 Web 内容

找到该 XML 文件的 <TabGroup> 节。请注意，该节中有用于“Links”（链接）和“File Attachments”（文件附件）的 <Tab> 元素，其中每个 <Tab> 元素包含一个呈现各自控件的 <Control> 元素。
```
<Tab Label="Links">
  <Control Type="LinksControl" />
</Tab>
<Tab Label="File Attachments">
  <Control Type="AttachmentsControl" />
</Tab>
```

添加一个新 <Tab> 元素，该元素将包含要显示在工作项窗体中的 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 和 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 替换为要在工作项窗体上显示的信息。

备注

为获得最佳结果，每个 Control（控件）或 Group（组）应显示在一个 Column（列）中，即使该列跨越整个窗体宽度也应如此。相应地，每列应该显示在一个组中，即使该组没有可见的标签或边界也应如此。

保存对 XML 文件所做的更改。
使用 witadmin importwitd 将新工作项类型导入单个项目中。若要将工作项类型添加到过程模板中，请参见向过程模板添加工作项的类型定义。

验证网页或 HTML 内容是否显示在窗体中

在团队资源管理器中，打开包含你已修改的 WIT 定义的团队项目的工作项，然后选择 “刷新”。

此时将从服务器下载最新更新，包括你刚刚导入的更改。请等待几秒钟，直到刷新了**“工作项”节点。正在加载中的节点显示“正在工作”**。
使用已修改的 WIT 创建工作项。

验证网页或 HTML 内容是否按预期显示在窗体中。
选择**“关闭”**以关闭新的工作项。