更改:jira 报告

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

全名

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

说明

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

属性

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

必需参数

姓名 类型 自从 描述
基于的 细绳 2.10 当前项目基目录。
用户属性是basedir

可选参数

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

有效列是:AssigneeComponentCreatedFix VersionIdKeyPriorityReporterResolutionStatusSummaryTypeUpdatedVersion


默认值为Key,Summary,Status,Resolution,Assignee
零件 细绳 - 设置要限制报告包含的组件。多个值可以用逗号分隔(例如 10011,10012)。如果将其设置为空 - 这意味着将包含所有组件。
筛选 细绳 - 定义过滤器参数以限制从 JIRA 检索哪些问题。filter 参数使用与 JIRA 搜索中使用的相同格式的 url 参数。
fixVersionIds 细绳 2.0 设置您希望限制报告包含的修复版本 ID。这些是 JIRA 的内部版本 ID,而不是人类可读的显示 ID。多个修复版本可以用逗号分隔。如果将其设置为空 - 这意味着将包含所有修复版本。
强制RSS 布尔值 2.9 从 JIRA 5.1.1 开始,不再可以构造下载 RSS 的 URL。同时 JIRA 在 4.2 中添加了一个 REST API。默认情况下,此插件使用 REST API(如果可用)。将此参数设置为 true 会强制它尝试使用 RSS。
默认值为false
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 细绳 - 设置您希望限制报告包含的优先级。有效状态为BlockerCriticalMajorMinorTrivial。多个值可以用逗号分隔。如果将其设置为空 - 这意味着将包括所有优先级。
分辨率ID 细绳 - 设置要从 JIRA 获取的分辨率。有效的解决方案是:UnresolvedFixedWon't FixDuplicateIncompleteCannot Reproduce。多个值可以用逗号分隔。

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


默认值为固定
runOnlyAtExecutionRoot 布尔值 2.10 这将导致执行仅在给定模块树的顶部运行。也就是说,在启动 mvn 执行的同一文件夹中包含的项目中运行。
默认值为false
用户属性是changes.runOnlyAtExecutionRoot
跳过 布尔值 2.8 如果设置为true,则不会生成 JIRA 报告。
默认值为false
用户属性是changes.jira.skip
排序列名 细绳 2.0 设置报表排序依据的列名。在列名后面 添加 DESC以指定降序。例如Fix Version DESC,Type首先按 Fix Version 降序排序,然后按 Type 升序排序。默认情况下按升序排序,但可以指定ASC以保持一致性。前面的示例将变为Fix Version DESC,Type ASC

有效列是:AssigneeComponentCreatedFix VersionIdKeyPriorityReporterResolutionStatusSummaryTypeUpdatedVersion

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


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

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

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


默认值为关闭
类型 ID 细绳 2.0 设置要限制报告包含的类型。有效类型为:BugNew FeatureTaskImprovementWishTestSub-task。多个值可以用逗号分隔。如果将其设置为空 - 这意味着将包括所有类型。
使用Jql 布尔值 2.8 使用 JIRA 查询语言而不是基于 HTTP 参数的 JIRA 查询。从 JIRA 5.1 起,仅支持 JQL。JIRA 4.4 支持基于 JQL 和 URL 参数的查询。从 5.1.1 开始,这已过时,因为 REST 查询仅使用 JQL。
默认值为false
用户属性是changes.useJql
版本前缀 细绳 2.4 在 JIRA 中命名版本时使用的前缀。

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


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

参数详情

基于

当前项目基目录。
  • 类型java.lang.String
  • : 2.10
  • 要求
  • 用户属性basedir

列名

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

有效列是:AssigneeComponentCreatedFix VersionIdKeyPriorityReporterResolutionStatusSummaryTypeUpdatedVersion

  • 类型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
  • 要求

forceRss

从 JIRA 5.1.1 开始,不再可以构造下载 RSS 的 URL。同时 JIRA 在 4.2 中添加了一个 REST API。默认情况下,此插件使用 REST API(如果可用)。将此参数设置为 true 会强制它尝试使用 RSS。
  • 类型布尔值
  • : 2.9
  • 要求
  • 默认值

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}

优先级

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

分辨率标识

设置要从 JIRA 获取的分辨率。有效的解决方案是:UnresolvedFixedWon't FixDuplicateIncompleteCannot Reproduce。多个值可以用逗号分隔。

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

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

runOnlyAtExecutionRoot

这将导致执行仅在给定模块树的顶部运行。也就是说,在启动 mvn 执行的同一文件夹中包含的项目中运行。
  • 类型布尔值
  • : 2.10
  • 要求
  • 用户属性changes.runOnlyAtExecutionRoot
  • 默认值

跳过

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

排序列名

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

有效列是:AssigneeComponentCreatedFix VersionIdKeyPriorityReporterResolutionStatusSummaryTypeUpdatedVersion

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

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

状态标识

设置要从 JIRA 获取的状态。有效状态为:OpenIn ProgressReopenedResolvedClosed。多个值可以用逗号分隔。

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

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

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

类型标识

设置要限制报告包含的类型。有效类型为:BugNew FeatureTaskImprovementWishTestSub-task。多个值可以用逗号分隔。如果将其设置为空 - 这意味着将包括所有类型。
  • 类型java.lang.String
  • : 2.0
  • 要求

使用Jql

使用 JIRA 查询语言而不是基于 HTTP 参数的 JIRA 查询。从 JIRA 5.1 起,仅支持 JQL。JIRA 4.4 支持基于 JQL 和 URL 参数的查询。从 5.1.1 开始,这已过时,因为 REST 查询仅使用 JQL。
  • 类型布尔值
  • : 2.8
  • 要求
  • 用户属性changes.useJql
  • 默认值

版本前缀

在 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
  • 要求