xml2jira

xml2jira 工具提供了一种简单的方法，可以自动创建/更新 JIRA 问题条目，基于 Squish 测试产生的结果输出。由于 Squish 测试中心提供了一种更强大、更灵活的 Jira 集成，该功能已经冻结且已被弃用。

xml2jira 为 Squish 测试套件创建相应的 JIRA 条目。当它收到新的 result.xml 文件时，它会连接到 JIRA，针对产生结果的测试套件创建条目，或者（如果已存在相关条目）用新收集的实际测试结果更新该条目。

为了使 xml2jira 能够创建和更新条目，您的 JIRA 系统需要配置为可以在项目的默认条目创建对话框中设置 'labels' 字段。《xml2jira》需要 'labels' 字段来 '标记' 条目，以便它可以识别它是否是正确的条目，对应于即将更新的测试套件。

JIRA 问题描述包含描述测试套件状态的 测试套件状态，说明上次执行测试用例是通过还是失败，以及测试执行持续时间。如果已存在相应的条目，其描述将相应更新。

测试套件状态

此外，在每次调用 xml2jira 时，都会在相应的 JIRA 问题中添加一个包含指定 Squish XML 报告文件中提到的测试用例执行概述的注释（ 测试套件摘要）。

测试套件摘要

可选地，可以将 Squish XML 报告文件作为附件添加到 JIRA 问题中，以供日后分析。

如果 Squish XML 报告文件可能包含任何失败，xml2jira 工具会将 JIRA 问题状态更改为开放。如果报告文件不包含失败，则状态将设置为关闭。

用法

xml2jira --server <url> --user <name> --password <password> --project <project key> --reportfile <filename> --issueType <name> --component <name> --transitions <workflow> --customField <field=content> --commandFile <filename> --attachSquishReport --deleteIssue

选项

选项	描述
`--server` <url>	包括端口的 JIRA 服务器 URL，例如 `http://jira:8080`。
`--user <name>`	表示用于身份验证 JIRA 服务器的 JIRA 用户名称。
`--password <password>`	表示 JIRA 用户的密码。
`--project <project key>`	通过项目密钥作为参数指定 JIRA 项目。
`--component <name>`	可选地指定 JIRA 项目组件的名称。
`--issueType <name>`	可选地指定 JIRA 条目的问题类型。如果提供，则参数必须与 JIRA 中定义的问题类型之一匹配，否则条目创建将失败。省略选项时，默认使用 Bug 作为问题类型。
`--reportfile <filename>`	指定要创建或更新 JIRA 条目的 Squish XML 报告文件的绝对路径，例如 `C:\reports\squishreport.xml`。支持的结果格式为：xml2、xml2.1、xml2.2、xml3、xml3.1、xml3.2、xml3.3
`--commandfile <filename>`	指定一个可选的 UTF-8 编码文件，其中包含除传递给 `xml2jira` 工具的选项以外的命令行选项。有关更多信息，请参阅命令文件。
`--attachSquishReport`	可选地指示将Squish XML报告文件附加到JIRA问题。
`--customField <字段名=字段内容>`	可选地定义JIRA票据上的自定义字段，以便通过<字段内容>进行更新。它还用于在票据创建对话框中填充<字段内容>字段，这些字段在创建票据时被设置为“必填”。此选项可以多次提供，以更新可能需要更新的每个字段。此外，“自定义选项字段”（作为下拉字段或组合框）也可以填充。在这种情况下，<字段内容>必须与字段的可选之一精确匹配。
`--transitions <工作流端点定义>`	可选地定义自定义工作流端点状态及其之间之间的转换。当您的Jira平台配置为使用非标准工作流定义时，可以使用此选项让`xml2jira`了解这些定义。
`--deleteIssue`	删除与通过`--reportfile`选项提供的测试结果相关的Jira票据。（为此，报告`--user`需要在JIRA服务器上启用了管理员权限。）

工作流端点定义

--transitions选项始终需要4个用逗号分隔的参数，按以下顺序给出，否则票据创建将失败：Active=<元数据-id>, AtransD=<元数据-id>, Disabled=<元数据-id>, DtransA=<元数据-id>。

对于Active和Disabled，给出代码xml2jira在更新结果时应使用的状态名称。在JIRA标准工作流中，这些被称为Open=1和Closed=6。PASSED更新会导致票据被Disabled，而FAILED更新会导致票据被激活。
对于AtransD和DtransA，必须提供从Active状态到Disabled状态以及相反方向的转换名称。在JIRA标准工作流中，这些被称为CloseIssue=2和ReopenIssue=3。
在这些名称中，也要给出<元数据-id>，由等号（=）分隔。

具有与JIRA预定义标准状态和转换相匹配参数的--transitions选项如下

xml2jira ... --transitions "Open=1,CloseIssue=2,Closed=6,ReopenIssue=3" ... --reportfile C:\report.xml

示例

以下是一个使用名为xml2jira的工具的示例调用，该工具使用用户alice和密码al1ce将Squish XML报告文件C:\report.xml导入指定的JIRA服务器中的项目SampleProject和组件tests。

xml2jira --server http://jira:8080 --user alice --password al1ce --project SampleProject --component tests --reportfile C:\report.xml

以下是一个使用命令文件mycmd.txt的示例

# mycmd.txt
--reportfile C:\report.xml

您可以使用以下方式使用命令文件与xml2jira工具结合使用

xml2jira --server http://jira:8080 --user alice --password al1ce --project SampleProject --component tests --commandfile C:\mycmd.txt

网络代理环境变量