What are report processors?
Report Processors are components which can be enabled and configured to process the results of a rendered Report. For example, let's say you have designed a particular data quality report, which you want to run every week, output the results into Excel, and email the results to a data manager. Report processors fulfill the final step in that process - adding the ability to manually or automatically email the rendered Excel report to a configured list of users whenever it is run. Although the number of built-in report processors is currently limited - supporting only Email Processing at this time (the Logging Processor is for a lightweight proof-of-concept only), more can easily be added into the framework as ongoing requirements dictate.
Configuration
Report Processors must be associated with a Report Design, not with a Report Definition directly. The reason for this is that the type of processing is often directly related to the type of output produced. For example, you may well want to have an electronic submission report processor available when you have rendered your report into an SDMX-HD message to send to a 3rd party, but this kind of processor would not make much sense if you are rendering the same report to the Web. So the first thing that you will need to do - even if the type of renderer that you want to use has not previously required a ReportDesign to operate - is to create a new Report Design that points to the renderer of your choice. Once that is done, you can go to the Manage Report Processors page, and create a new Report Processor, taking care to associate it with your Report Design.
Email Report Processor
Email Report Processors have 2 types of configuration settings needed to work - they need global settings (stored in global properties) in order to configure the actual ability to send emails. Then, each Processor needs to be configured with the content of the email message.
Global Settings
The following global properties must be set to appropriate values. The values specified below are the defaults that will be used if no configured global property value is found:
- mail.transport.protocol=smtp
- mail.smtp_host=localhost
- mail.smtp_port=25
- mail.smtp_auth=false
- mail.debug=false
- mail.from=
- mail.user=
- mail.password=
For each configured instance of the Email Report Processor, the following properties are supported:
Property |
Description |
|---|---|
from |
The email address that the message should come from |
to |
The email address(es) that the message should be sent to. Multiple addresses separated by commas. |
subject |
The subject line for the message |
content |
Any raw content that should go in the body of the message |
addOutputToContent |
If the rendered report is text, setting this to true will include it in the body of the email |
addOutputAsAttachment |
Any rendered report can be included as an attachment to the email message by setting this to true |
attachmentName |
If addOutputAsAttachment=true, this can be used to specify the name of the attachment on the email |