向工作项窗体添加 Web 内容

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

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

• 网页的 URL

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

• HTML 内容

有关用于向工作项窗体添加 Web 内容的元素的语法结构信息，请参见WebpageControlOptions XML 元素引用和Link 和 Param XML 元素引用。

主题内容

• 导出和打开工作项类型定义文件

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

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

必需的权限

若要执行此过程，您必须是**“Team Foundation Administrators (Team Foundation 管理员)”组的成员或项目的“Project Administrators (项目管理员)”**组的成员。 有关更多信息，请参见Team Foundation Server 权限。

导出和打开工作项类型定义文件

导出和打开工作项类型定义文件

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

  如果要修改单个项目的工作项类型：

  1. 运行 witadmin exportwitd 导出要修改的工作项类型的 XML 文件。 有关更多信息，请参见从现有项目导出和导入工作项类型。

  2. 在 Visual Studio 中，单击**“文件”，单击“打开”，再单击“文件”**。

     此时出现**“打开文件”**对话框。

  3. 在**“查找范围”**之下，移动到您导出该文件的位置。

  如果要修改工作项类型以自定义过程模板：

  1. 查找已下载过程模板的位置。

  2. 选择要更新的工作项类型 XML 文件，然后单击**“打开”。 出现有关行尾的提示时，单击“否”**。

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

向工作项窗体添加 Web 内容

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

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

2. 添加一个新 <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" Dock="Fill">
                 <WebpageControlOptions AllowScript="false">
                    <Link UrlRoot="URL of Web Page" />
                 </WebpageControlOptions>
              </Control>
           </Column>
        </Group>
     </Tab>
     

     将 Tab Label（选项卡标签）和 URL of Web Page（网页 URL）替换为要在工作项窗体上显示的信息。

   • 指定要在运行时确定的动态 URL：

     <Tab Label="Tab Label">
        <Group>
           <Column PercentWidth="100">
              <Control Type="WebpageControl" Name="Webpage" Label=" Name of Web Page" LabelPosition="Top" Dock="Fill">
                 <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>
     

     将选项卡标签、网页 URL、带参数的 URL 路径 以及参数值 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（HTML 内容）替换为要在工作项窗体上显示的信息。

     备注

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

3. 在工具栏上单击**“保存”**将所做更改保存到该 XML 文件中。

4. 若要将新工作项类型导入单个项目中，请参见从现有项目导出和导入工作项类型。 若要将工作项类型添加到过程模板中，请参见向过程模板添加工作项的类型定义。

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

验证对工作项窗体所做的更改

1. 在团队资源管理器中，右击包含所修改的工作项类型定义的团队项目节点，然后单击**“刷新”**。

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

2. 使用修改后的工作项类型创建工作项，方法是右击**“工作项”节点，指向“添加工作项”**，然后单击该工作项类型。

   此工作项将从您所更改的工作项类型创建。

   验证网页或 HTML 内容是否显示在所添加的新选项卡上。

3. 单击**“关闭”以关闭这个新的工作项。 提示您保存工作项时，请单击“否”**。

请参见

任务

添加和自定义工作项类型

参考

WebpageControlOptions XML 元素引用

Link 和 Param XML 元素引用

自定义和管理工作项类型 [witadmin]

概念

指定工作项窗体控件

设计和自定义工作项窗体