org.ametys.plugins.odfpilotage.report

Class AbstractPilotageReport

java.lang.Object

org.ametys.runtime.plugin.component.AbstractLogEnabled

org.ametys.plugins.odfpilotage.report.AbstractPilotageReport

All Implemented Interfaces:

PilotageReport, LogEnabled, PluginAware, Initializable, Serviceable

Direct Known Subclasses:

AbstractExtract, AbstractReport

public abstract class AbstractPilotageReport
extends AbstractLogEnabled
implements PilotageReport, Serviceable, Initializable, PluginAware

The abstract class for pilotage reports.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractPilotageReport.PilotageFile Object representing a pilotage file Containing the zip file and the report status
static class	AbstractPilotageReport.PilotageReportStatus The enumerator for different pilotage report status

Nested classes/interfaces inherited from interface org.ametys.plugins.odfpilotage.report.PilotageReport

PilotageReport.PilotageReportTarget

Field Summary

Fields

Modifier and Type	Field and Description
protected String	_currentFormattedDate The current date formatted to yyyy-MM-dd
protected I18nUtils	_i18nUtils The I18N utils
private String	_mailFrom
protected ODFHelper	_odfHelper The ODF helper
protected PilotageHelper	_pilotageHelper The pilotage helper
private String	_pluginName
protected OdfReferenceTableHelper	_refTableHelper The ODF enumeration helper
protected ReportHelper	_reportHelper The report helper
protected AmetysObjectResolver	_resolver The ametys object resolver
protected SourceResolver	_sourceResolver The source resolver
protected File	_tmpFolder The tmp folder
protected UserManager	_userManager The user manager

Fields inherited from interface org.ametys.plugins.odfpilotage.report.PilotageReport

PARAMETER_CATALOG, PARAMETER_LANG, PARAMETER_ORGUNIT, PARAMETER_PROGRAM

Constructor Summary

Constructors

Constructor and Description
AbstractPilotageReport()

Method Summary

Modifier and Type	Method and Description
private String	_buildZipName(String contextName) Build the ZIP name.
protected void	convertReport(File outputFolder, String fileName, File xmlFile) Convert the report from XML to the required format
protected AbstractPilotageReport.PilotageFile	createZipFile(File folderToZip, String contextName) Compress a folder to zip format
protected String	getMailBody(AbstractPilotageReport.PilotageReportStatus status) The mail body.
protected String	getMailSubject() The mail subject.
protected String	getPipeline(String outputFolderName) Build the pipeline to launch the transformation.
protected String	getPluginName() Get the plugin name to build the pipeline.
protected abstract String	getReportName() The report name to add in the mail.
protected abstract String	getType() Get the name of the report
void	initialize()
void	launch(PilotageReport.PilotageReportTarget target, Map<String,String> reportParameters, UserIdentity user) Launch a report on the given target with the given parameters.
protected abstract String	launchByOrgUnit(Map<String,String> reportParameters) Launch a report generation on an orgunit.
protected abstract String	launchByProgram(Map<String,String> reportParameters) Launch a report generation on a program.
protected void	sendMail(AbstractPilotageReport.PilotageFile file, UserIdentity user) Send a mail with the ZIP file as attachment at the end of the report generation.
void	service(ServiceManager manager)
void	setPluginInfo(String pluginName, String featureName, String id) Sets the plugin info relative to the current component. Note : The feature name may be null if the targeted component in declared at plugin level.

Methods inherited from class org.ametys.runtime.plugin.component.AbstractLogEnabled

getLogger, setLogger

Methods inherited from class java.lang.Object

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

Field Detail

_sourceResolver

protected SourceResolver _sourceResolver

The source resolver

_pilotageHelper

protected PilotageHelper _pilotageHelper

The pilotage helper

_resolver

protected AmetysObjectResolver _resolver

The ametys object resolver

_reportHelper

protected ReportHelper _reportHelper

The report helper

_refTableHelper

protected OdfReferenceTableHelper _refTableHelper

The ODF enumeration helper

_odfHelper

protected ODFHelper _odfHelper

The ODF helper

_userManager

protected UserManager _userManager

The user manager

_i18nUtils

protected I18nUtils _i18nUtils

The I18N utils

_tmpFolder

protected File _tmpFolder

The tmp folder

_currentFormattedDate

protected String _currentFormattedDate

The current date formatted to yyyy-MM-dd

_pluginName

private String _pluginName

_mailFrom

private String _mailFrom

Constructor Detail

AbstractPilotageReport

public AbstractPilotageReport()

Method Detail

initialize

public void initialize()
                throws Exception

Specified by:

initialize in interface Initializable

Throws:

Exception

setPluginInfo

public void setPluginInfo(String pluginName,
                          String featureName,
                          String id)

Description copied from interface: PluginAware

Sets the plugin info relative to the current component.
Note : The feature name may be null if the targeted component in declared at plugin level.

Specified by:

setPluginInfo in interface PluginAware

Parameters:

pluginName - Unique identifier for the plugin hosting the extension

featureName - Unique feature identifier (unique for a given pluginName)

id - Unique identifier of this component

service

public void service(ServiceManager manager)
             throws ServiceException

Specified by:

service in interface Serviceable

Throws:

ServiceException

launchByOrgUnit

protected abstract String launchByOrgUnit(Map<String,String> reportParameters)
                                   throws Exception

Launch a report generation on an orgunit.

Parameters:

reportParameters - The report parameters

Returns:

the name of the generated file

Throws:

Exception - if an exception occurs

launchByProgram

protected abstract String launchByProgram(Map<String,String> reportParameters)
                                   throws Exception

Launch a report generation on a program.

Parameters:

reportParameters - The report parameters

Returns:

the name of the generated file

Throws:

Exception - if an exception occurs

getType

protected abstract String getType()

Get the name of the report

Returns:

The report name

getPluginName

protected String getPluginName()

Get the plugin name to build the pipeline.

Returns:

The plugin name

getPipeline

protected String getPipeline(String outputFolderName)

Build the pipeline to launch the transformation.

Parameters:

outputFolderName - The name of the output folder name

Returns:

The pipeline for transformation

launch

public void launch(PilotageReport.PilotageReportTarget target,
                   Map<String,String> reportParameters,
                   UserIdentity user)

Description copied from interface: PilotageReport

Launch a report on the given target with the given parameters.

Specified by:

launch in interface PilotageReport

Parameters:

target - The target of the report

reportParameters - The report parameters

user - The current user

convertReport

protected void convertReport(File outputFolder,
                             String fileName,
                             File xmlFile)
                      throws IOException

Convert the report from XML to the required format

Parameters:

outputFolder - folder where the file will stay temporarily

fileName - the name of the file

xmlFile - the file to be converted

Throws:

IOException - if an error occurs

createZipFile

protected AbstractPilotageReport.PilotageFile createZipFile(File folderToZip,
                                                            String contextName)
                                                     throws IOException

Compress a folder to zip format

Parameters:

folderToZip - the folder to be compressed

contextName - the name of the report context

Returns:

The pilotage file

Throws:

IOException - if an exception occurs

sendMail

protected void sendMail(AbstractPilotageReport.PilotageFile file,
                        UserIdentity user)

Send a mail with the ZIP file as attachment at the end of the report generation.

Parameters:

file - the pilotage file

user - the recipient if he has an email

getMailSubject

protected String getMailSubject()

The mail subject.

Returns:

The subject of the mail

getMailBody

protected String getMailBody(AbstractPilotageReport.PilotageReportStatus status)

The mail body.

Parameters:

status - the status of the pilotage report

Returns:

The body of the mail

getReportName

protected abstract String getReportName()

The report name to add in the mail.

Returns:

The report name

_buildZipName

private String _buildZipName(String contextName)

Build the ZIP name.

Parameters:

contextName - The report context name

Returns:

The full ZIP name