Previous Topic  Next Topic

Configuring Export Settings

Administrators can configure the default settings for exporting report results to e-mail and fax, and customize the precision level for different export formats.

Below is a list of the sections covered in this topic:

• Configuring Settings for Exporting Reports to E-mail
• Configuring Settings for Exporting Reports to Fax
• Customizing the Layout Precision

Configuring Settings for Exporting Reports to E-mail

The settings are applied when end users schedule report tasks to publish report results to e-mail.

1. In the Logi JReport Server console, point to Administration on the system toolbar, and then select Configuration > Export from the drop-down menu to open the Export page. The E-mail tab is selected by default.

   

2. From the Default E-mail Format drop-down list, specify how a published report is sent out by e-mail. The format can be one of the following:
   • E-mail Result in HTML E-mail Format
     Sends the report result via e-mail to the specified address in HTML format. The report result will be shown in HTML format in the mail body.
   • E-mail Result in Plain Text E-mail Format 
     Sends the report result via e-mail to the specified address in plain text format. The report result will be shown in plain text format in the mail body with no other information such as color, images and so on.
   • Attachment in JReport Result Format
     Sends the report result via e-mail to the specified address with a Logi JReport result file as attachment.
   • Attachment in HTML Format
     Sends the report result via e-mail to the specified address with an HTML file as attachment.
   • Attachment in PDF Format
     Sends the report result via e-mail to the specified address with a PDF file as attachment.
   • Attachment in Excel Format
     Sends the report result via e-mail to the specified address with an Excel file as attachment.
   • Attachment in Text Format
     Sends the report result via e-mail to the specified address with a Text file as attachment.
   • Attachment in RTF Format
     Sends the report result via e-mail to the specified address with a RTF file as attachment.
   • Attachment in XML Format
     Sends the report result via e-mail to the specified address with an XML file as attachment.
   • Attachment in PostScript Format
     Sends the report result via e-mail to the specified address with a PostScript file as attachment.
3. If you want to compress the mail attachment as Java archive, select the Compress Attachment as Java Archive checkbox.
4. To split the PDF file in the mail attachment, specify in which way and how to split.
   • To split the PDF file by file size, check the Maximum Split PDF File Size radio button and then type in the largest size in KB each PDF file could have after splitting. The default value "Unlimited" means not to split.

     If you choose to split by file size, then how to split the PDF file depends on the following two aspects:

     • The separated pages by the before-split PDF file
     • The maximum file size specified for an after-split PDF file

     Here the before-split PDF file refers to the big PDF file to be split and an after-split PDF refers to one of the smaller PDF files generated after splitting the big PDF file. When a PDF file is to be split by file size, the splitting will be carried out based on the pages the file separates but not physically on the maximum file size specified for an after-split PDF file. However, the maximum file size helps to decide by which page to split: the page that the maximum size comes to is not included with the previous pages in an after-split file, but instead is the beginning page of the following after-split file. For example, there is a 2M PDF file with 1M per page. If the maximum file size is set to 1.5M, we will get two PDF files with each 1M and one page as the split result.

   • To split the PDF file by file page, check the Maximum Split PDF File Page radio button and then type in the number of pages each PDF file could have at most after splitting. The default value "Unlimited" means not to split.
5. Select Save and then restart Logi JReport Server to make the e-mail settings take effect.

The e-mail settings are saved in the configuration file mailconfig.properties in the <install_root>\bin directory. You can also use the file for default e-mail configuration. The following table lists the available properties and the UI options they are mapped to.

Configuring Settings for Exporting Reports to Fax

Administrators can specify to export the report results either via a fax machine or fax server. The settings will be used when end users schedule report tasks to publish report results to fax.

To export report result to fax via a fax machine:

1. Configure the running environment first. Download Java Communications API (Version 2.0): http://www.jinfonet.com/download/third_party_tool/JavaCommAPIV2_Win32.zip for Win32 or http://www.jinfonet.com/download/third_party_tool/JavaCommAPIV2_Solaris.zip for Solaris, and place the following files in the specified locations:
   • For Windows:

     File Name	Location
     comm.jar	<server_install_root>\lib
     javax.comm.properties	<Java_install_root>\jre\lib
     Win32Com.dll	<Java_install_root>\jre\bin

   • For Solaris:

     File Name	Location
     comm.jar	<server_install_root>/lib
     javax.comm.properties	<Java_install_root>/jre/lib
     libSolarisSerialParallel.so	LD_LIBRARY_PATH

2. In the Logi JReport Server console, select Administration > Configuration > Export on the system toolbar, then select the Fax tab. The Fax Machine radio button is selected by default.

   

3. From the Dialing drop-down list, select the dialing mode for the fax modem: Tone or Pulse.
4. From the Modem Class drop-down list, select the class of the modem: Class 1, Class 2 or Class 2.0. Most modems only support Class 1, so if you select Class 2 or Class 2.0, you should make sure that your modem can support it.
5. From the Flow Control drop-down list, select the flow control mode between DTE (Data Terminal Equipment) and DCE (Data Circuit-terminating Equipment). Specifying flow control can help the compressing data function of the modem work better.
   • RtsCts
     Flow control of the hardware (recommended).
   • Xon/Xoff
     Flow control of the software.
   • None
     No flow control specified.
6. From the Flow Control Command drop-down list, select the flow control command according to the modem being used. If not contained in the drop-down list, you can leave this empty and enter the command as part of the initial string. The command should be obtained from your modem manual.
7. In the Port text box, enter the port number. The port should be obtained from your modem manual.
8. In the Initialization String text box, type in the string to initialize the modem. The string should be obtained from your modem manual.
9. In the Timeout text boxes, specify the maximum amount of time that the fax should wait for a response from the destination before timing out.
10. When the line is busy, the report result cannot be faxed, so you can specify the maximum number of times the modem re-tries faxing the report result in the Retries text box.
11. Select Save and then restart Logi JReport Server to make the fax settings take effect.

To export report result to fax via a fax server:

1. In the Logi JReport Server console, select Administration > Configuration > Export on the system toolbar, then select the Fax tab.
2. Select the Fax Server radio button.

   

3. In the Fax Gateway Connector text box, enter the name of the implemented class.

   By default, the fax server Logi JReport uses is based on Hylafax Server, however if you want to export your report result via Hylafax Server, you need to download the gnu-hylafax packages according to your requirements from http://sourceforge.net/projects/gnu-hylafax/, for example, gnu-hylafax-util-0.0.9.2.jar, gnu-inet-ftp-0.0.9.2.jar, and gnu-hylafax-0.0.9.2.jar, and then add them to the class path of the file setenv.bat in <server_install_root>\bin.

4. In the Server IP text box, enter the IP address or domain name of the fax server.
5. In the Server Port text box, enter the port number of the fax server.
6. In the Login ID text box, type in the username for the class communicating with fax server.
7. In the Password text box, type in the password for the class communicating with fax server.
8. In the Fax Sender text box, specify the user's name that is shown in the fax server manager.
9. In the Special Parameters text box, type in the parameters for the fax server.
10. In the Timeout text boxes, specify the maximum amount of time that the fax should wait for a response from the destination before timing out. For Hylafax Server the value should not be larger than 59 seconds. It is a limitation of Hylafax Server.
11. In the Retries text box, type in the number of times the modem retries faxing the report result.
12. Select Save and then restart Logi JReport Server to make the fax settings take effect.

The fax settings are saved in the file faxconfig.properties in the <install_root>\bin directory. You can also use the file for default fax configuration. The following table lists the properties in the file and the UI options they are mapped to.

Customizing the Layout Precision

Administrators can customize the precision that will be applied when running reports or exporting reports and dashboards to different formats. However for page reports created in Logi JReport Designer, the customized precision can take effect only in report tabs whose Precision Sensitive property is set to true.

1. In the Logi JReport Server console, select Administration > Configuration > Export on the system toolbar, and then select the Layout Precision tab.

   

2. Select Customize for each format.

   By default, Optimize for speed over visual effect is selected, which means Logi JReport will decide the precision level which is oriented towards speed more than visualization.

3. Select the System Default Settings button, then in the displayed dialog specify the precision level for each format and select OK. The RSD format controls only the Page Report Result format when scheduling to run page report tabs.

   

   Logi JReport provides two precision levels: high and low. High precision provides better layout but slower efficiency while low precision brings higher performance but maybe poorer visual effect. If low precision can make give reports well looks, it is reasonable to apply low precision for at the same time faster performance is guaranteed. By default Logi JReport applies high precision for formats such as PDF, RTF, Excel, Fax and PostScript, thus the report result layouts of these formats are different from the other formats such as HTML, JReport Result, XML, and Text.

4. In the Layout Precision tab, check the checkbox for the required formats to apply the defined precision level. For formats that are not checked, Logi JReport will decide their precision.
5. Select Save and then restart Logi JReport Server to make the settings take effect.

Previous Topic  Next Topic