Overview
This page documents the use of reporting tools.
Prerequisites
- MySQL database must already exist (e.g. "mappingservicedb") and be loaded with data.
- MySQL database connection parameters must be defined in the properties file specified by "run.config".
- Report definitions defined for the specified project.
Details
These tools are used to generate and remove reports. The report generator can be wired to an automation (continuous integration server or cron job) to run daily and generate reports. The remover tool can be used to remove reports, if desired.
Following are some details about these tools:
Mojo: ReportGenerateDailyMojo.java (in admin/mojo/src/main/resources/java/org/ihtsdo/otf/mapping/mojo)
Project: admin/loader
Configuration Parameters
- A profile of "GenerateDailyReports" must be passed
- run.config - the standard configuration file specified as a -D parameter
refset.id - the map project refset id to generate reports for, specified as a -D parameter.
- start.date - the start date range for reporting specified as a -Dparameter in the string format "yyyyMMdd"
- end.date - the end date range for reporting specified as a -Dparameter in the string format "yyyyMMdd"
- typically, this is left null and reports are generated from the start date until now.
- This parameter is supported for the generation of report data in the past.
Mojo: ReportRemoverMojo.java (in admin/mojo/src/main/resources/java/org/ihtsdo/otf/mapping/mojo)
Project: admin/remove
Configuration Parameters
- A profile of "Reports" must be passed
- run.config - the standard configuration file specified as a -D parameter
refset.id - the map project refset id to remove reports for, specified as a -D parameter.
- This tool is rarely used outside the development environment.
Samples
Sample command line call to generate for refset id 447563008 for a date:
% cd mapping-parent/admin/loader % set date = `/bin/date +%Y%m%d` % mvn install -Drun.config=/home/ihtsdo/config/config.properties -PGenerateDailyReports -Drefset.id=447563008 -Dstart.date=$date
Sample command line call to clear reports for refset id 447563008:
% cd mapping-parent/admin/remover % mvn install -Drun.config=/home/ihtsdo/config/config.properties -PReports Drefset.id=447563008
Sample Eclipse run configuration to generate for refset id 447563008 for a date:
Sample Eclipse run configuration to clear reports for refset id 447563008:
References/Links
- n/a