BackPrevious Page Next PageNext

Exporting to Fax

Configuring the fax settings

Exporting a report to fax

JReport Designer provides the feature of exporting the report result to fax either via a fax machine or a fax server. If you require this feature to be enabled, you will first need to configure your running environment.

Configuring the fax settings

To configure the settings for exporting 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:
  2. Click File > Options.
  3. In the Options dialog, select the Export to category.
  4. Click the Fax tab. The Fax Machine radio button is selected by default.

    Fax Machine Settings

  5. From the Dialing drop-down list, select the dialing mode for the fax modem: Tone or Pulse.
  6. 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.
  7. In the Initialization String text box, type in the string to initialize the modem. The string should be obtained from your modem manual.
  8. 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.
  9. From the Flow 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.
  10. In the Port text box, enter the port number. The port should be obtained from your modem manual.
  11. Specify the maximum amount of time that the fax should wait for a response from the destination before timing out.
  12. 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.
  13. Click OK to accept the settings.

To configure the settings for exporting report result to fax via a fax server:

  1. Click File > Options.
  2. In the Options dialog, select the Export to category.
  3. Click the Fax tab, then check the Fax Server radion button.

    Fax Server Settings

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

    By default, the fax server 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 <designer_install_root>\bin.

  5. In the Server IP text box, enter the IP address or domain name of the fax server.
  6. In the Server Port text box, enter the port number of the fax server.
  7. In the Login ID text box, type in the username for the class communicating with fax server.
  8. In the Password text box, type in the password for the class communicating with fax server.
  9. In the Fax Sender text box, specify the user's name that is shown in the fax server manager.
  10. In the Special Parameters text box, type in the parameters for the fax server.
  11. 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.
  12. In the Retries text box, type in the number of times the modem retries faxing the report result.
  13. Click OK to accept the settings.

Exporting reports to fax

After you have configured the fax settings in the Options dialog, you can now export your reports to fax as follows:

  1. Open the report you want to export.
  2. Click File > Export > To Fax. The Export to Fax dialog appears.

    Export to Fax dialog

  3. If you are exporting a page report, in the Select Report Tabs box, select the report tabs in the page report you want to export. The selected report tabs will be exported in the list order. You can click Move Up button or Move Down button to change the order of the report tabs.
  4. Specify the quality of the fax: Best, Normal, or Fast.
  5. Choose whether to send a cover sheet with the fax.
  6. Specify what you want to display on the cover sheet if you select to include it.
  7. Check Run Linked Report if you want to generate the reports that is linked with the report (not including the detail reports) in the fax result. If you are only interested in the primary report, leave this option unchecked. Generating linked reports at the same time, especially when the linked reports contain a large amount of data, will cause performance issue.
  8. Click OK to start exporting.

BackPrevious Page Next PageNext