自定义工作跟踪 Web 窗体

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 工作跟踪自定义。

Export WIT definition fileEdit XML definition fileImport WIT definition fileRefresh and verify changes

导入/导出进程 zip 文件

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

Export processEdit XML definition file(s)Import processRefresh and verify changes

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

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

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

导入和导出 WIT 定义文件

注意

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

  1. 如果没有项目的管理权限, 请获取它们

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

    例如:

    %programfiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer 
    
  3. 导出要修改或添加字段的 WIT 定义文件。 指定 WIT 的名称和文件的名称。

    witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:TypeName /f:"DirectoryPath/FileName.xml"  
    

    组织的 CollectionURL 示例为 https://dev.azure.com/OrganizationName

  4. 编辑文件。 有关详细信息,请参阅 WebLayout XML 元素

  5. 导入 WIT 定义文件。

    witadmin importwitd /collection:CollectionURL /p:ProjectName /f:"DirectoryPath/FileName.xml"  
    
  6. 打开任一 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”。

导入警告和错误

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

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