Configuring Report Server Emails

Configuring the report server emails with InetSoft's reporting software allows for simple report distribution that is unmatched by other reporting applications on the market. Review the instructions below to learn more about the Style Intelligence solution.

Mail configuration controls how the scheduler will email reports to a user and how an end user can contact an administrator in case an error is generated by the engine. The email is always sent from one fixed email address, specified as part of the mail configuration. For email delivery to work, the mail host must be configured and point to a valid SMTP server. This section describes the basic properties available on the 'Mail Configuration' page.

#1 Ranking: Read how InetSoft was rated #1 for user adoption in G2's user survey-based index Read More

Note: Multiple servers can be entered, comma separated. If the servers require secure protocol, check the box “Secure SMTP”.

The 'Mail Session JNDI URL' property can be specified to obtain the mail session from the application server's JNDI directory. If this property is set, the engine will first try to obtain a session from the JNDI directory when sending emails. If that fails, a new session is created based on the setting for the 'Mail Host' property.

The 'System Admin Email Address' is used to specify an email address for users to send problems to in case they encounter an error in the application.

The 'Delivery Emails Subject Format' and 'Notification Emails Subject Format' use the java.text.MessageFormat syntax with two properties, the first (index 0) being the report alias, and the second (index 1) being the date and time of report generation. For example, a report with alias 'testReport' and Subject Format specification

Report named {0}, generated at {1,time} on {1,date}

would produce an email subject line such as the following:

Report named testReport, generated at 10:34:54 AM on Nov 5, 2007

where the time and date shown would be the actual time and date of report generation. If no alias is specified for the report in the 'Alias' field of the Report tab, then “{0}” defaults to the report name.

The global 'Delivery Emails Subject Format' setting is overridden by the 'Subject' specified (if any) under the Schedule > Action tab of the Enterprise Manager and the Report Portal.

The 'Maximum Attachment Size [kB]' sets an upper limit for the size of an exported report file to be sent as a single attachment. If exceeded, the file is split into multiple files (binary split) and delivered via multiple emails. It is the responsibility of the recipient to concatenate all the fragments into one file. The concatenation can be done via command-line tools such as “type” (Windows) or “cat” (Linux), for example, type file1.pdf file2.pdf > file3.pdf

Previous: Specifying Report Data Source