自定义工作跟踪 Web 表单

  • 项目

Azure DevOps Server 2022 - Azure DevOps Server 2019

本文适用于在对本地 Azure DevOps Server 使用托管 XML 进程模型或本地 Xml 进程模型时可以做出的自定义。 有关继承进程模型，请参阅 “自定义进程”。 有关流程模型的概述，请参阅 自定义工作跟踪体验。

导入/导出 XML 定义文件

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

导出 WIT 定义文件编辑 XML 定义文件导入 WIT 定义文件刷新并验证更改

导入/导出进程 zip 文件

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

导出过程编辑 XML 定义文件 () 导入过程刷新和验证更改

FORM 部分

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

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

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

导入和导出定义文件（本地 XML 进程）

  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 Marketplace 安装进程模板编辑器。

布局和调整大小

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

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

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

全局列表

全局列表在托管 XML 中管理的方式不同于 Azure DevOps Server 上的列表。 witadmin不支持该命令和单独的全局列表文件。 在 Hosted 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>  
     ...

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

导入警告和错误

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

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