自定义工作跟踪 Web 窗体

项目
04/18/2022

Azure DevOps Server 2020 |Azure DevOps Server 2019 |TFS 2018

重要

功能可用性：本主题适用于使用托管 XML 进程模型时可以做出的自定义，或者已将应用程序层服务器更新为使用本地 XML 进程模型) 的 Team Foundation Server 2017 或更高版本版本 (。有关继承过程模型，请参阅自定义进程。

有关流程模型的概述，请参阅自定义工作跟踪体验。

正如你能够自定义工作项类型的窗体布局一样，你可以继续使用新的 Web 窗体。新窗体提供几个功能，这些功能不适用于旧窗体。帐户或项目集合管理员管理切换到新窗体。为帐户或项目集合启用新窗体时，WebLayout 节将添加到集合中定义的每个 WIT 的 XML 定义中。

注意

在自定义 Web 窗体之前，管理员必须已启用新窗体。

可以像以前一样自定义转换的 WIT。路径略有不同，具体取决于你的平台和以前的自定义选项。

导入/导出 XML 定义文件

使用本地 XML 进程模型时使用此序列，即通过导入单个 XML 定义文件来管理 TFS 工作跟踪自定义。

Refresh and verify changes

导入/导出进程 zip 文件

使用托管 XML 进程模型（即，通过导入进程或进程模板来管理工作跟踪自定义）时，请使用此序列。

Refresh and verify changes

主要区别在于 ，FORM 节点中现在有两个主要布局部分。第一部分包含在 Layout 元素中，在通过客户端（如 Visual Studio）查看时定义窗体布局。 WebLayout 元素中包含的第二部分在通过 Web 浏览器查看时定义窗体布局。

<FORM>
   <Layout HideReadOnlyEmptyFields="true" HideControlBorders="true">
       . . .  
   </Layout>
   <WebLayout>
       . . .  
   </WebLayout>
</FORM>

请参阅以下主题，以便进行指示的自定义：

若要 (WebLayout 节点) 自定义 Web 门户的窗体，请参阅 WebLayout 和 Control XML 元素
若要向 Web 门户的窗体添加作用域链接控件， (LinksControlOptions) ，请参阅 LinksControlOptions XML 元素
若要 (布局节点) 自定义客户端窗体，请参阅 Layout XML 元素。

导入和导出 WIT 定义文件

注意

Azure DevOps Services不支持 witadmin 命令行工具。而是使用继承的进程来修改工作项类型。

如果没有项目的管理权限，请获取它们。

根据 witAdmin 中提供的说明打开命令提示符窗口：自定义和管理跟踪工作的对象。

例如：

%programfiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

导出要修改或添加字段的 WIT 定义文件。指定 WIT 的名称和文件的名称。
```
witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:TypeName /f:"DirectoryPath/FileName.xml"  
```
组织的 CollectionURL 示例为 https://dev.azure.com/OrganizationName。
编辑文件。有关详细信息，请参阅 WebLayout XML 元素。

导入 WIT 定义文件。

witadmin importwitd /collection:CollectionURL /p:ProjectName /f:"DirectoryPath/FileName.xml"

打开任一 Web 门户以查看更改。如果客户端已打开，请刷新页面。

此时将从服务器下载最新更新，包括你刚刚导入的更改。请等待几秒钟，直到刷新完成。

有关使用 witadmin 的详细信息，请参阅导入、导出和管理工作项类型。

提示

使用 witadmin，可以导入和导出定义文件。可以使用的其他工具包括进程编辑器 (要求已安装版本Visual Studio) 。从Visual Studio市场安装进程模板编辑器。

或者，可以使用 TFS 团队Project管理器（可从GitHub获取的开源客户端）。

提示

使用 witadmin，可以导入和导出定义文件。可以使用的其他工具包括进程编辑器 (要求已安装版本Visual Studio) 。从Visual Studio市场安装 TFS 进程模板编辑器。可以使用此版本的进程编辑器修改旧样式的工作项窗体。不能使用它来编辑与新 Web 窗体关联的表单。

或者，可以使用 TFS 团队Project管理器（可从GitHub获取的开源客户端）。

布局和调整大小

新的 Web 窗体根据可用宽度和定义的节数调整大小。在最大宽度下，在大多数 Web 浏览器中，页面中的每个部分都将在其自己的列中显示。随着显示宽度的减少，每个部分按比例调整大小，如下所示：

对于四个部分：40%、20%、20% 和 20%
对于三个部分：50%、25% 和 25%
对于两个部分：66% 和 33%
对于一个部分：100%。

当显示宽度不能容纳每个节的列式显示时，各节将显示在列内。

全局列表

全局列表在托管 XML 中管理的方式与Azure DevOps Server (和 TFS) 不同。对于初学者，不支持 witadmin，因此不存在单独的全局列表文件。在托管 XML 中，它们附加到现有工作项类型。下面是一个示例...

<?xml version="1.0" encoding="utf-8"?>
<witd:WITD xmlns:witd="http://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef" application="Work item type editor" version="1.0">
  <WORKITEMTYPE name="Shared Steps" refname="Custom.SharedSteps">
    <DESCRIPTION>Server-side data for reusable set of test steps. Version: B.02</DESCRIPTION>
    <GLOBALLISTS>
      <GLOBALLIST name="Foo">
        <LISTITEM value="No" />
        <LISTITEM value="Yes" />
        <LISTITEM value="Maybe" />
        <LISTITEM value="Not Sure" />
      </GLOBALLIST>
      <GLOBALLIST name="Bar">
        <LISTITEM value="Open" />
        <LISTITEM value="Closed" />
      </GLOBALLIST>
     </GLOBALLISTS>  
     ...

默认情况下，全局列表将附加到共享步骤工作项类型。

如果你不熟悉 WIT 自定义，请参阅 “添加和修改 WIT”。

导入警告和错误

如果仅为 WebLayout 或 Layout 节点中的所需字段添加 Control 元素，但未添加其他字段，则导入修改后的 WIT 定义时会收到警告。

如果启用新窗体，然后修改删除 WebLayout 节点的 WIT 定义，将收到错误。