i-net Crystal-Clear

Email Request Handler

Please note: The “Email Request Handler” is a feature exclusive to i-net Crystal-Clear Plus.

Since version 7.1, i‑net Crystal-Clear Plus contains the “Email Request Handler”, a reference implementation of an email handler.
With the “Email Request Handler” it is possible to let the i‑net Crystal-Clear server send an executed report (e.g. a PDF file) as an email attachment to an recipient.

How does “Email Request Handler” work

The “Email Request Handler” uses the email configuration of the i‑net SchedulerXML (see: scheduler configuration).
You can send the request for an email, e.g. with the report URL to the i‑net Crystal-Clear server. The following properties are supported:

Property Description
init The value needs to be “email” to tell the “Email Request Handler” to send an email
to Email address of the recipient
subject Subject of the email (optional)
message Email body (optional)
export_fmt Format of the attached report (optional, default is PDF)

Configure Tasks, Reports and Actions

You need to enable the “Email Request Handler” in the i‑net Crystal-Clear Configuration Manager. To do this, enter the fully qualified class name “com.inet.report.schedule.server.EMailRequestHandler” in the field “Request Handler” in the category ”Customization”.

Usage of “Email Request Handler”

To use the email request handler just open a report URL on the i‑net Crystal-Clear report server with “init=email” and an recipient address:

Sample URL:

http://srvName:9000?report=file:c:/myReports/report1.rpt&init=email&to=xxx@xxx.com

How you could use a report URL with JSP you can find in the JSP Sample.

See Also:


i‑net software strives to provide accurate product documentation. Please give us your feedback using the form below.
NOTE: This form is for documentation feedback only. For technical assistance, please send an email to crystalclear@inetsoftware.de.

 

© Copyright 1996 - 2010, i-net software; All Rights Reserved.