org.nuiton.jredmine.plugin.report

Class IssuesReportByVersion

java.lang.Object

org.apache.maven.plugin.AbstractMojo

org.nuiton.plugin.AbstractPlugin

org.nuiton.jredmine.plugin.AbstractRedmineMojo

org.nuiton.jredmine.plugin.AbstractRedmineMojoWithProject

org.nuiton.jredmine.plugin.report.AbstractRedmineReport

org.nuiton.jredmine.plugin.report.AbstractIssuesReport

org.nuiton.jredmine.plugin.report.IssuesReportByVersion

All Implemented Interfaces:

org.apache.maven.plugin.ContextEnabled, org.apache.maven.plugin.Mojo, org.apache.maven.reporting.MavenReport, RedmineClientConfiguration, IssueCollectorConfiguration, RedmineProjectAware, RedmineVersionAware, RedmineServiceConfiguration, org.nuiton.plugin.Plugin

@Mojo(name="issues-report-by-version",
      requiresOnline=true,
      requiresProject=true,
      requiresReports=true)
public class IssuesReportByVersion
extends AbstractIssuesReport

Generates a report for issues from Redmine's server group by version.

Since:

1.0.0

Author:

tchemit

Nested Class Summary

Nested classes/interfaces inherited from interface org.nuiton.plugin.Plugin

org.nuiton.plugin.Plugin.InitState, org.nuiton.plugin.Plugin.Packaging

Field Summary

Fields

Modifier and Type	Field and Description
protected String	columnNamesByVersion Sets the column names that you want to show in the report.
protected Map<String,String>	filtersByVersion Sets some filters on issues to include.
protected int	maxEntriesByVersion Maximum number of entries to be fetched from redmine.
protected boolean	onlyCurrentVersionByVersion If you only want to show issues for the current version in the report.
protected boolean	skipIssueReportByVersion A flag to skip the report.

Fields inherited from class org.nuiton.jredmine.plugin.report.AbstractIssuesReport

group, issues, issuesCache

Fields inherited from class org.nuiton.jredmine.plugin.report.AbstractRedmineReport

factory, i18n, issueLinkTemplate, localRepository, outputDirectory, resolver, siteRenderer, versionId, versionLinkTemplate

Fields inherited from class org.nuiton.jredmine.plugin.AbstractRedmineMojoWithProject

projectId, releaseProject, releaseUser, users

Fields inherited from class org.nuiton.jredmine.plugin.AbstractRedmineMojo

apiKey, dateFormat, encoding, initOk, password, project, REDMINE_SYSTEM, safe, service, serviceInit, session, url, username, verbose

Fields inherited from interface org.apache.maven.reporting.MavenReport

CATEGORY_PROJECT_INFORMATION, CATEGORY_PROJECT_REPORTS, ROLE

Fields inherited from interface org.apache.maven.plugin.Mojo

ROLE

Constructor Summary

Constructors

Constructor and Description
IssuesReportByVersion()

Method Summary

Methods

Modifier and Type	Method and Description
protected String	getColumnNames()
protected Map<String,String>	getFilters()
int	getMaxEntries()
boolean	isOnlyCurrentVersion()
protected boolean	skipReport()

Methods inherited from class org.nuiton.jredmine.plugin.report.AbstractIssuesReport

executeReport, getCategoryIds, getDescription, getGroup, getIssueLinkTemplate, getName, getOutputName, getPriorityIds, getStatusIds, getTrackerIds, getVersionLinkTemplate, getVersionNames, init

Methods inherited from class org.nuiton.jredmine.plugin.report.AbstractRedmineReport

canGenerateReport, doAction, generate, getBundle, getCategoryName, getReportOutputDirectory, getSink, getSkinArtifactFile, getVersionId, isExternalReport, setReportOutputDirectory, setVersionId

Methods inherited from class org.nuiton.jredmine.plugin.AbstractRedmineMojoWithProject

checkSkip, getProjectId, initReleaseProject, initReleaseUser, setProjectId

Methods inherited from class org.nuiton.jredmine.plugin.AbstractRedmineMojo

afterExecute, closeService, failIfSafe, getAuthConfiguration, getEncoding, getProject, getUrl, isVerbose, setApiKey, setAuthConfiguration, setEncoding, setPassword, setProject, setUrl, setUsername, setVerbose

Methods inherited from class org.nuiton.plugin.AbstractPlugin

acceptPackaging, addCompileSourceRoots, addDirectoryToUrlsList, addResourceDir, addTestCompileSourceRoots, addTestResourceDir, addUrlToUrlsList, backupFile, checkEncoding, checkPackaging, checkResource, checkRunOnceDone, copyFile, createDirectoryIfNecessary, createNewFile, deleteFile, execute, getBackupFile, getFileFromBasedir, getFilesToTreate, getFilesToTreateForRoots, getRootProject, getTemplate, hasClassPath, initClassLoader, isExecutionRoot, isFileNewerThanPomFile, needInvoke, needInvoke, rejectPackaging, removeCompileSourceRoots, removeTestCompileSourceRoots, renameFile, writeFile

Methods inherited from class org.apache.maven.plugin.AbstractMojo

getLog, getPluginContext, setLog, setPluginContext

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.nuiton.jredmine.plugin.IssueCollectorConfiguration

getProjectId, getVersionId, isVerbose, setVersionId

Methods inherited from interface org.apache.maven.plugin.Mojo

getLog, setLog

Field Detail

maxEntriesByVersion

@Parameter(property="redmine.maxEntries",
           defaultValue="100")
protected int maxEntriesByVersion

Maximum number of entries to be fetched from redmine.

Note: use value 0 to have no limits

Since:

1.0.0

onlyCurrentVersionByVersion

@Parameter(property="redmine.onlyCurrentVersion",
           defaultValue="false")
protected boolean onlyCurrentVersionByVersion

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.

Since:

1.0.0

filtersByVersion

@Parameter
protected Map<String,String> filtersByVersion

Sets some filters on issues to include. the possible keys are :

• version : to restrict on version fixed
• status : to restrict on some status
• priority : to restrict on some priorties
• category : to restrict on some categories
• tracker : to restrict on some tracker (says type of issues)

Values are Redmine's internal ids (except for the version entry which use Redmine's version names).

Multiple values can be separated by commas.

Note : If a value is set to empty - that means to not filter on that property.

To see the internal ids, use the command :

 mvn redmine:display-ids -Dtype=<entry key>
 

Since:

1.0.0

columnNamesByVersion

@Parameter(property="redmine.columnNames",
           defaultValue="Tracker,Category,Key,Summary,Status,Assignee,Version")
protected String columnNamesByVersion

Sets the column names that you want to show 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: Key, Summary, Status, Assignee, Reporter, Tracker, Priority, Version, Category, Created and Updated.

Since:

2.0

skipIssueReportByVersion

@Parameter(property="redmine.skipIssueReportByVersion",
           defaultValue="false")
protected boolean skipIssueReportByVersion

A flag to skip the report.

This can be usefull since there is no way to skip a report from an inherited reportSet configuration.

Since:

1.0.0

Constructor Detail

IssuesReportByVersion

public IssuesReportByVersion()

Method Detail

isOnlyCurrentVersion

public boolean isOnlyCurrentVersion()

getMaxEntries

public int getMaxEntries()

getColumnNames

protected String getColumnNames()

Specified by:

getColumnNames in class AbstractIssuesReport

getFilters

protected Map<String,String> getFilters()

Specified by:

getFilters in class AbstractIssuesReport

skipReport

protected boolean skipReport()

Specified by:

skipReport in class AbstractRedmineReport

Returns:

true if report should be skip