changes:jira-changes

Note:

This goal should be used as a Maven report.

Full name:

org.apache.maven.plugins:maven-changes-plugin:3.0.0-M2:jira-changes

Description:

Goal which downloads issues from the Issue Tracking System and generates a report.

Attributes:

  • Requires a Maven project to be executed.
  • The goal is thread-safe and supports parallel builds.
  • Since version: 2.0.

Required Parameters

Name Type Since Description
<basedir> String 2.10 The current project base directory.
User Property: basedir
<outputDirectory> File - The shared output directory for the report. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin is used instead.

A plugin may use any subdirectory structure (either using a hard-coded name or, ideally, an additional user-defined mojo parameter with a default value) to generate multi-page reports or external reports with the main output file (entry point) denoted by #getOutputName().


Default: ${project.build.directory}/reports

Optional Parameters

Name Type Since Description
<columnNames> String 2.0 Sets the names of the columns that you want in the report. The columns will appear in the report in the same order as you specify them here. Multiple values can be separated by commas.

Valid columns are: Assignee, Component, Created, Fix Version, Id, Key, Priority, Reporter, Resolution, Status, Summary, Type, Updated and Version.


Default: Key,Summary,Status,Resolution,Assignee
<component> String - Sets the component(s) that you want to limit your report to include. Multiple values can be separated by commas (such as 10011,10012). If this is set to empty - that means all components will be included.
<filter> String - Defines the filter parameters to restrict which issues are retrieved from JIRA. The filter parameter uses the same format of url parameters that is used in a JIRA search.
<fixVersionIds> String 2.0 Sets the fix version id(s) that you want to limit your report to include. These are JIRA's internal version ids, NOT the human readable display ones. Multiple fix versions can be separated by commas. If this is set to empty - that means all fix versions will be included.
<jiraDatePattern> String 2.4 The pattern used by dates in the JIRA XML-file. This is used to parse the Created and Updated fields.
Default: EEE, d MMM yyyy HH:mm:ss Z
<jiraPassword> String - Defines the JIRA password for authentication into a private JIRA installation.
<jiraServerId> String 3.0.0 The settings.xml server id to be used for authentication into a private JIRA installation.
User Property: changes.jiraServerId
<jiraUser> String - Defines the JIRA username for authentication into a private JIRA installation.
<locale> String - The locale to use when the report generation is invoked directly as a standalone Mojo.
See also: SiteTool#DEFAULT_LOCALE, SiteTool#getSiteLocales(String)
Default: default
<maxEntries> int - Maximum number of entries to be fetched from JIRA.
Default: 100
<onlyCurrentVersion> boolean 2.0 If you only want to show issues for the current version in the report. The current version being used is ${project.version} minus any "-SNAPSHOT" suffix.
Default: false
<outputFormat> String - The report output format: null by default, to represent a site, but can be configured to a Doxia Sink id.
User Property: output.format
<outputTimestamp> String - Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH).
Default: ${project.build.outputTimestamp}
<priorityIds> String - Sets the priority(s) that you want to limit your report to include. Valid statuses are Blocker, Critical, Major, Minor and Trivial. Multiple values can be separated by commas. If this is set to empty - that means all priorities will be included.
<resolutionIds> String - Sets the resolution(s) that you want to fetch from JIRA. Valid resolutions are: Unresolved, Fixed, Won't Fix, Duplicate, Incomplete and Cannot Reproduce. Multiple values can be separated by commas.

Note: In versions 2.0-beta-3 and earlier this parameter had no default value.


Default: Fixed
<runOnlyAtExecutionRoot> boolean 2.10 This will cause the execution to be run only at the top of a given module tree. That is, run in the project contained in the same folder where the mvn execution was launched.
Default: false
User Property: changes.runOnlyAtExecutionRoot
<siteDirectory> File - Directory containing the site.xml file.
Default: ${basedir}/src/site
<skip> boolean 2.8 If set to true, then the JIRA report will not be generated.
Default: false
User Property: changes.jira.skip
<sortColumnNames> String 2.0 Sets the column names that you want to sort the report by. Add DESC following the column name to specify descending sequence. For example Fix Version DESC, Type sorts first by the Fix Version in descending order and then by Type in ascending order. By default sorting is done in ascending order, but is possible to specify ASC for consistency. The previous example would then become Fix Version DESC, Type ASC.

Valid columns are: Assignee, Component, Created, Fix Version, Id, Key, Priority, Reporter, Resolution, Status, Summary, Type, Updated and Version.

Note: If you are using JIRA 4 you need to put your sort column names in the reverse order. The handling of this changed between JIRA 3 and JIRA 4. The current default value is suitable for JIRA 3. This may change in the future, so please configure your sort column names in an order that works for your own JIRA version.


Default: Priority DESC, Created DESC
<statusIds> String - Sets the status(es) that you want to fetch from JIRA. Valid statuses are: Open, In Progress, Reopened, Resolved and Closed. Multiple values can be separated by commas.

If your installation of JIRA uses custom status IDs, you can reference them here by their numeric values. You can obtain them on the Statuses page (in 4.0.2 it's under Administration > Issue Settings > Statuses) - just hover over the Edit link for the status you want and you'll see something like <your JIRA URL>/secure/admin/EditStatus!default.jspa?id=12345; in this case the value is 12345.

Note: In versions 2.0-beta-3 and earlier this parameter had no default value.


Default: Closed
<typeIds> String 2.0 Sets the types(s) that you want to limit your report to include. Valid types are: Bug, New Feature, Task, Improvement, Wish, Test and Sub-task. Multiple values can be separated by commas. If this is set to empty - that means all types will be included.
<useJql> boolean 2.8
Deprecated.
ignored; delete from your config

Obsolete, since REST queries only use JQL.
Default: false
User Property: changes.useJql
<versionPrefix> String 2.4 The prefix used when naming versions in JIRA.

If you have a project in JIRA with several components that have different release cycles, it is an often used pattern to prefix the version with the name of the component, e.g. maven-filtering-1.0 etc. To fetch issues from JIRA for a release of the "maven-filtering" component you would need to set this parameter to "maven-filtering-".

<webPassword> String -
Deprecated.
use jiraPassword or jiraServerId

Defines the http password for basic authentication into the JIRA webserver.
<webUser> String -
Deprecated.
use jiraUser or jiraServerId

Defines the http user for basic authentication into the JIRA webserver.

Parameter Details

<basedir>

The current project base directory.
  • Type: java.lang.String
  • Since: 2.10
  • Required: Yes
  • User Property: basedir

<columnNames>

Sets the names of the columns that you want in the report. The columns will appear in the report in the same order as you specify them here. Multiple values can be separated by commas.

Valid columns are: Assignee, Component, Created, Fix Version, Id, Key, Priority, Reporter, Resolution, Status, Summary, Type, Updated and Version.

  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Default: Key,Summary,Status,Resolution,Assignee

<component>

Sets the component(s) that you want to limit your report to include. Multiple values can be separated by commas (such as 10011,10012). If this is set to empty - that means all components will be included.
  • Type: java.lang.String
  • Required: No

<filter>

Defines the filter parameters to restrict which issues are retrieved from JIRA. The filter parameter uses the same format of url parameters that is used in a JIRA search.
  • Type: java.lang.String
  • Required: No

<fixVersionIds>

Sets the fix version id(s) that you want to limit your report to include. These are JIRA's internal version ids, NOT the human readable display ones. Multiple fix versions can be separated by commas. If this is set to empty - that means all fix versions will be included.
  • Type: java.lang.String
  • Since: 2.0
  • Required: No

<jiraDatePattern>

The pattern used by dates in the JIRA XML-file. This is used to parse the Created and Updated fields.
  • Type: java.lang.String
  • Since: 2.4
  • Required: No
  • Default: EEE, d MMM yyyy HH:mm:ss Z

<jiraPassword>

Defines the JIRA password for authentication into a private JIRA installation.
  • Type: java.lang.String
  • Required: No

<jiraServerId>

The settings.xml server id to be used for authentication into a private JIRA installation.
  • Type: java.lang.String
  • Since: 3.0.0
  • Required: No
  • User Property: changes.jiraServerId

<jiraUser>

Defines the JIRA username for authentication into a private JIRA installation.
  • Type: java.lang.String
  • Required: No

<locale>

The locale to use when the report generation is invoked directly as a standalone Mojo.
See also: SiteTool#DEFAULT_LOCALE, SiteTool#getSiteLocales(String)
  • Type: java.lang.String
  • Required: No
  • Default: default

<maxEntries>

Maximum number of entries to be fetched from JIRA.
  • Type: int
  • Required: No
  • Default: 100

<onlyCurrentVersion>

If you only want to show issues for the current version in the report. The current version being used is ${project.version} minus any "-SNAPSHOT" suffix.
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Default: false

<outputDirectory>

The shared output directory for the report. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin is used instead.

A plugin may use any subdirectory structure (either using a hard-coded name or, ideally, an additional user-defined mojo parameter with a default value) to generate multi-page reports or external reports with the main output file (entry point) denoted by #getOutputName().

  • Type: java.io.File
  • Required: Yes
  • Default: ${project.build.directory}/reports

<outputFormat>

The report output format: null by default, to represent a site, but can be configured to a Doxia Sink id.
  • Type: java.lang.String
  • Required: No
  • User Property: output.format

<outputTimestamp>

Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH).
  • Type: java.lang.String
  • Required: No
  • Default: ${project.build.outputTimestamp}

<priorityIds>

Sets the priority(s) that you want to limit your report to include. Valid statuses are Blocker, Critical, Major, Minor and Trivial. Multiple values can be separated by commas. If this is set to empty - that means all priorities will be included.
  • Type: java.lang.String
  • Required: No

<resolutionIds>

Sets the resolution(s) that you want to fetch from JIRA. Valid resolutions are: Unresolved, Fixed, Won't Fix, Duplicate, Incomplete and Cannot Reproduce. Multiple values can be separated by commas.

Note: In versions 2.0-beta-3 and earlier this parameter had no default value.

  • Type: java.lang.String
  • Required: No
  • Default: Fixed

<runOnlyAtExecutionRoot>

This will cause the execution to be run only at the top of a given module tree. That is, run in the project contained in the same folder where the mvn execution was launched.
  • Type: boolean
  • Since: 2.10
  • Required: No
  • User Property: changes.runOnlyAtExecutionRoot
  • Default: false

<siteDirectory>

Directory containing the site.xml file.
  • Type: java.io.File
  • Required: No
  • Default: ${basedir}/src/site

<skip>

If set to true, then the JIRA report will not be generated.
  • Type: boolean
  • Since: 2.8
  • Required: No
  • User Property: changes.jira.skip
  • Default: false

<sortColumnNames>

Sets the column names that you want to sort the report by. Add DESC following the column name to specify descending sequence. For example Fix Version DESC, Type sorts first by the Fix Version in descending order and then by Type in ascending order. By default sorting is done in ascending order, but is possible to specify ASC for consistency. The previous example would then become Fix Version DESC, Type ASC.

Valid columns are: Assignee, Component, Created, Fix Version, Id, Key, Priority, Reporter, Resolution, Status, Summary, Type, Updated and Version.

Note: If you are using JIRA 4 you need to put your sort column names in the reverse order. The handling of this changed between JIRA 3 and JIRA 4. The current default value is suitable for JIRA 3. This may change in the future, so please configure your sort column names in an order that works for your own JIRA version.

  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Default: Priority DESC, Created DESC

<statusIds>

Sets the status(es) that you want to fetch from JIRA. Valid statuses are: Open, In Progress, Reopened, Resolved and Closed. Multiple values can be separated by commas.

If your installation of JIRA uses custom status IDs, you can reference them here by their numeric values. You can obtain them on the Statuses page (in 4.0.2 it's under Administration > Issue Settings > Statuses) - just hover over the Edit link for the status you want and you'll see something like <your JIRA URL>/secure/admin/EditStatus!default.jspa?id=12345; in this case the value is 12345.

Note: In versions 2.0-beta-3 and earlier this parameter had no default value.

  • Type: java.lang.String
  • Required: No
  • Default: Closed

<typeIds>

Sets the types(s) that you want to limit your report to include. Valid types are: Bug, New Feature, Task, Improvement, Wish, Test and Sub-task. Multiple values can be separated by commas. If this is set to empty - that means all types will be included.
  • Type: java.lang.String
  • Since: 2.0
  • Required: No

<useJql>

Deprecated.
ignored; delete from your config

Obsolete, since REST queries only use JQL.
  • Type: boolean
  • Since: 2.8
  • Required: No
  • User Property: changes.useJql
  • Default: false

<versionPrefix>

The prefix used when naming versions in JIRA.

If you have a project in JIRA with several components that have different release cycles, it is an often used pattern to prefix the version with the name of the component, e.g. maven-filtering-1.0 etc. To fetch issues from JIRA for a release of the "maven-filtering" component you would need to set this parameter to "maven-filtering-".

  • Type: java.lang.String
  • Since: 2.4
  • Required: No

<webPassword>

Deprecated.
use jiraPassword or jiraServerId

Defines the http password for basic authentication into the JIRA webserver.
  • Type: java.lang.String
  • Required: No

<webUser>

Deprecated.
use jiraUser or jiraServerId

Defines the http user for basic authentication into the JIRA webserver.
  • Type: java.lang.String
  • Required: No