更改:jira 报告

注意:这个目标应该用作 Maven 报告。

全名:

org.apache.maven.plugins:maven-changes-plugin:2.8:jira-report

说明:

从问题跟踪系统下载问题并生成报告的目标。

属性:

  • 需要执行一个 Maven 项目。
  • 目标是线程安全的并支持并行构建。

可选参数

姓名 类型 自从 描述
列名 细绳 2.0 设置报告中所需的列的名称。这些列将按照您在此处指定的顺序出现在报告中。多个值可以用逗号分隔。

有效列是:Assignee、 Component、Created、Fix Version、Id、Key、 Priority、Reporter、 Resolution、Status、Summary、 Type、Updated和 Version。


默认值为:Key,Summary,Status,Resolution,Assignee。
零件 细绳 - 设置要限制报告包含的组件。多个值可以用逗号分隔(例如 10011,10012)。如果将其设置为空 - 这意味着将包含所有组件。
筛选 细绳 - 定义过滤器参数以限制从 JIRA 检索哪些问题。filter 参数使用与 JIRA 搜索中使用的相同格式的 url 参数。
fixVersionIds 细绳 2.0 设置您希望限制报告包含的修复版本 ID。这些是 JIRA 的内部版本 ID,而不是人类可读的显示 ID。多个修复版本可以用逗号分隔。如果将其设置为空 - 这意味着将包含所有修复版本。
jiraDate模式 细绳 2.4 JIRA XML 文件中日期使用的模式。这用于解析 Created 和 Updated 字段。
默认值为:EEE, d MMM yyyy HH:mm:ss Z。
jira密码 细绳 - 定义用于在私有 JIRA 安装中进行身份验证的 JIRA 密码。
吉拉用户 细绳 - 定义 JIRA 用户名,用于在私有 JIRA 安装中进行身份验证。
最大条目 整数 - 要从 JIRA 获取的最大条目数。
默认值为:100。
仅当前版本 布尔值 2.0 如果您只想在报告中显示当前版本的问题。当前使用的版本是 ${project.version}减去任何“-SNAPSHOT”后缀。
默认值为:false。
输出目录 文件 - 报告输出目录。请注意,仅当目标从命令行或默认构建生命周期运行时,此参数才相关。如果目标作为站点生成的一部分间接运行,则使用在 Maven 站点插件中配置的输出目录。
默认值为:${project.reporting.outputDirectory}。
输出编码 细绳 2.4 报告输出编码。请注意,仅当目标从命令行或默认构建生命周期运行时,此参数才相关。如果目标作为站点生成的一部分间接运行,则使用在 Maven 站点插件中配置的输出编码。
默认值为:${project.reporting.outputEncoding}。
用户属性是:outputEncoding。
优先级 ID 细绳 - 设置您希望限制报告包含的优先级。有效状态为Blocker、Critical、 Major、Minor和Trivial。多个值可以用逗号分隔。如果将其设置为空 - 这意味着将包括所有优先级。
分辨率ID 细绳 - 设置要从 JIRA 获取的分辨率。有效的解决方案是:Unresolved、Fixed、 Won't Fix、Duplicate、 Incomplete和Cannot Reproduce。多个值可以用逗号分隔。

注意:在 2.0-beta-3 及更早的版本中,此参数没有默认值。


默认值为:固定。
跳过 布尔值 2.8 如果设置为true,则不会生成 JIRA 报告。
默认值为:false。
用户属性是:changes.jira.skip。
排序列名 细绳 2.0 设置报表排序依据的列名。在列名后面 添加 DESC以指定降序。例如Fix Version DESC,Type首先按 Fix Version 降序排序,然后按 Type 升序排序。默认情况下按升序排序,但可以指定ASC以保持一致性。前面的示例将变为Fix Version DESC,Type ASC。

有效列是:Assignee、 Component、Created、Fix Version、Id、Key、 Priority、Reporter、 Resolution、Status、Summary、 Type、Updated和 Version。

注意:如果您使用的是 JIRA 4,则需要以相反的顺序放置排序列名称。对此的处理在 JIRA 3 和 JIRA 4 之间发生了变化。当前的默认值适用于 JIRA 3。这可能会在将来发生变化,因此请按照适用于您自己的 JIRA 版本的顺序配置您的排序列名称。如果您使用 JQL,通过将 useJql参数设置为true,则字段的顺序再次恢复正常。从 JIRA 5.1 开始,您必须使用 JQL。


默认值为:优先级 DESC,已创建 DESC。
状态标识 细绳 - 设置要从 JIRA 获取的状态。有效状态为:Open、In Progress、 Reopened、Resolved和 Closed。多个值可以用逗号分隔。

如果您的 JIRA 安装使用自定义状态 ID,您可以在此处通过其数值引用它们。您可以在“状态”页面上获取它们(在 4.0.2 中,它位于“管理”>“问题设置”>“状态”下) - 只需将鼠标悬停在所需状态的“编辑”链接上,您就会看到类似 <your JIRA URL>/secure/admin /EditStatus!default.jspa?id=12345; 在这种情况下,值为 12345。

注意:在 2.0-beta-3 及更早的版本中,此参数没有默认值。


默认值为:关闭。
类型 ID 细绳 2.0 设置要限制报告包含的类型。有效类型为:Bug、New Feature、 Task、Improvement、Wish、 Test和Sub-task。多个值可以用逗号分隔。如果将其设置为空 - 这意味着将包括所有类型。
使用Jql 布尔值 2.8 使用 JIRA 查询语言而不是基于 HTTP 参数的 JIRA 查询。从 JIRA 5.1 起,仅支持 JQL。JIRA 4.4 支持基于 JQL 和 URL 参数的查询。
默认值为:false。
版本前缀 细绳 2.4 在 JIRA 中命名版本时使用的前缀。

如果您在 JIRA 中有一个项目,其中包含多个具有不同发布周期的组件,则经常使用的模式是使用组件名称作为版本前缀,例如 maven-filtering-1.0 等。从 JIRA 获取问题以发布您需要将此参数设置为“maven-filtering-”的“maven-filtering”组件。


网络密码 细绳 - 为 JIRA 网络服务器的基本身份验证定义 http 密码。
网络用户 细绳 - 为 JIRA 网络服务器的基本身份验证定义 http 用户。

参数详情

列名:

设置报告中所需的列的名称。这些列将按照您在此处指定的顺序出现在报告中。多个值可以用逗号分隔。

有效列是:Assignee、 Component、Created、Fix Version、Id、Key、 Priority、Reporter、 Resolution、Status、Summary、 Type、Updated和 Version。

  • 类型:java.lang.String
  • 从: 2.0
  • 要求:否
  • 默认值:键、摘要、状态、分辨率、受让人

组件:

设置要限制报告包含的组件。多个值可以用逗号分隔(例如 10011,10012)。如果将其设置为空 - 这意味着将包含所有组件。
  • 类型:java.lang.String
  • 要求:否

过滤器:

定义过滤器参数以限制从 JIRA 检索哪些问题。filter 参数使用与 JIRA 搜索中使用的相同格式的 url 参数。
  • 类型:java.lang.String
  • 要求:否

fixVersionIds:

设置您希望限制报告包含的修复版本 ID。这些是 JIRA 的内部版本 ID,而不是人类可读的显示 ID。多个修复版本可以用逗号分隔。如果将其设置为空 - 这意味着将包含所有修复版本。
  • 类型:java.lang.String
  • 从: 2.0
  • 要求:否

jiraDate模式:

JIRA XML 文件中日期使用的模式。这用于解析 Created 和 Updated 字段。
  • 类型:java.lang.String
  • 从: 2.4
  • 要求:否
  • 默认值:EEE, d MMM yyyy HH:mm:ss Z

吉拉密码:

定义用于在私有 JIRA 安装中进行身份验证的 JIRA 密码。
  • 类型:java.lang.String
  • 要求:否

吉拉用户:

定义 JIRA 用户名,用于在私有 JIRA 安装中进行身份验证。
  • 类型:java.lang.String
  • 要求:否

最大条目:

要从 JIRA 获取的最大条目数。
  • 类型:整数
  • 要求:否
  • 默认值:100

仅当前版本:

如果您只想在报告中显示当前版本的问题。当前使用的版本是 ${project.version}减去任何“-SNAPSHOT”后缀。
  • 类型:布尔值
  • 从: 2.0
  • 要求:否
  • 默认值:假

输出目录:

报告输出目录。请注意,仅当目标从命令行或默认构建生命周期运行时,此参数才相关。如果目标作为站点生成的一部分间接运行,则使用在 Maven 站点插件中配置的输出目录。
  • 类型:java.io.File
  • 要求:否
  • 默认值:${project.reporting.outputDirectory}

输出编码:

报告输出编码。请注意,仅当目标从命令行或默认构建生命周期运行时,此参数才相关。如果目标作为站点生成的一部分间接运行,则使用在 Maven 站点插件中配置的输出编码。
  • 类型:java.lang.String
  • 从: 2.4
  • 要求:否
  • 用户属性:输出编码
  • 默认值:${project.reporting.outputEncoding}

优先级:

设置您希望限制报告包含的优先级。有效状态为Blocker、Critical、 Major、Minor和Trivial。多个值可以用逗号分隔。如果将其设置为空 - 这意味着将包括所有优先级。
  • 类型:java.lang.String
  • 要求:否

分辨率标识:

设置要从 JIRA 获取的分辨率。有效的解决方案是:Unresolved、Fixed、 Won't Fix、Duplicate、 Incomplete和Cannot Reproduce。多个值可以用逗号分隔。

注意:在 2.0-beta-3 及更早的版本中,此参数没有默认值。

  • 类型:java.lang.String
  • 要求:否
  • 默认值:固定

跳过:

如果设置为true,则不会生成 JIRA 报告。
  • 类型:布尔值
  • 从: 2.8
  • 要求:否
  • 用户属性:changes.jira.skip
  • 默认值:假

排序列名:

设置报表排序依据的列名。在列名后面 添加 DESC以指定降序。例如Fix Version DESC,Type首先按 Fix Version 降序排序,然后按 Type 升序排序。默认情况下按升序排序,但可以指定ASC以保持一致性。前面的示例将变为Fix Version DESC,Type ASC。

有效列是:Assignee、 Component、Created、Fix Version、Id、Key、 Priority、Reporter、 Resolution、Status、Summary、 Type、Updated和 Version。

注意:如果您使用的是 JIRA 4,则需要以相反的顺序放置排序列名称。对此的处理在 JIRA 3 和 JIRA 4 之间发生了变化。当前的默认值适用于 JIRA 3。这可能会在将来发生变化,因此请按照适用于您自己的 JIRA 版本的顺序配置您的排序列名称。如果您使用 JQL,通过将 useJql参数设置为true,则字段的顺序再次恢复正常。从 JIRA 5.1 开始,您必须使用 JQL。

  • 类型:java.lang.String
  • 从: 2.0
  • 要求:否
  • 默认值:优先 DESC,已创建 DESC

状态标识:

设置要从 JIRA 获取的状态。有效状态为:Open、In Progress、 Reopened、Resolved和 Closed。多个值可以用逗号分隔。

如果您的 JIRA 安装使用自定义状态 ID,您可以在此处通过其数值引用它们。您可以在“状态”页面上获取它们(在 4.0.2 中,它位于“管理”>“问题设置”>“状态”下) - 只需将鼠标悬停在所需状态的“编辑”链接上,您就会看到类似 <your JIRA URL>/secure/admin /EditStatus!default.jspa?id=12345; 在这种情况下,值为 12345。

注意:在 2.0-beta-3 及更早的版本中,此参数没有默认值。

  • 类型:java.lang.String
  • 要求:否
  • 默认值:关闭

类型标识:

设置要限制报告包含的类型。有效类型为:Bug、New Feature、 Task、Improvement、Wish、 Test和Sub-task。多个值可以用逗号分隔。如果将其设置为空 - 这意味着将包括所有类型。
  • 类型:java.lang.String
  • 从: 2.0
  • 要求:否

使用Jql:

使用 JIRA 查询语言而不是基于 HTTP 参数的 JIRA 查询。从 JIRA 5.1 起,仅支持 JQL。JIRA 4.4 支持基于 JQL 和 URL 参数的查询。
  • 类型:布尔值
  • 从: 2.8
  • 要求:否
  • 默认值:假

版本前缀:

在 JIRA 中命名版本时使用的前缀。

如果您在 JIRA 中有一个项目,其中包含多个具有不同发布周期的组件,则经常使用的模式是使用组件名称作为版本前缀,例如 maven-filtering-1.0 等。从 JIRA 获取问题以发布您需要将此参数设置为“maven-filtering-”的“maven-filtering”组件。

  • 类型:java.lang.String
  • 从: 2.4
  • 要求:否

网络密码:

为 JIRA 网络服务器的基本身份验证定义 http 密码。
  • 类型:java.lang.String
  • 要求:否

网络用户:

为 JIRA 网络服务器的基本身份验证定义 http 用户。
  • 类型:java.lang.String
  • 要求:否