To use Aspose.Words for JasperReports from your application, you should copy a single appropriate .jar file from the \lib folder of aspose.words.jasperreports.zip to the JasperReports\lib directory or to a library folder of your application. After that, you can access the exporters programmatically.
If you are using JasperReports v3.7.1 (or lower), copy aspose.words.jasperreports-3.7.1.jar file.
If you are using JasperReports v3.7.2 ... v4.5.0, copy aspose.words.jasperreports-4.5.0.jar file.
If you are using JasperReports v4.7.0, copy aspose.words.jasperreports-4.7.0.jar file.
If you are using JasperReports v5.0.0/v5.1.0, copy aspose.words.jasperreports-5.1.0.jar file.
NOTE: You need to copy ONLY ONE jar file.
The following example shows typical code needed to export a report to a DOC file using Aspose.Words for JasperReports. More examples can be found in the demo reports included in the product download.
[Java]
import com.aspose.words.jasperreports.*;
AWDocExporter exporter = new AWDocExporter();
File sourceFile = new File(fileName);
JasperPrint jasperPrint = (JasperPrint)JRLoader.loadObject(sourceFile);
exporter.setParameter(JRExporterParameter.JASPER_PRINT, jasperPrint);
File destFile = new File(sourceFile.getParent(), jasperPrint.getName() + ".doc");
exporter.setParameter(JRExporterParameter.OUTPUT_FILE_NAME, destFile.toString());
exporter.exportReport();
To add DOC, DOCX, RTF, ODT, HTML and TXT export formats to JasperServer, perform the following steps. In all of the following steps <InstallDir> stands for the JasperServer installation directory.
Step 1. Add the following new exporter properties to the <InstallDir>\apache-tomcat\webapps\jasperserver\WEB-INF\flows\viewReportBeans.xml file.
[XML]
<bean id="aw_reportDocExporter" class="com.aspose.words.jasperreports.AWReportDocExporter" parent="baseReportExporter">
<property name="exportParameters" ref="aw_exportParameters"/>
<property name="setResponseContentLength" value="true"/>
</bean>
<bean id="aw_reportDocxExporter" class="com.aspose.words.jasperreports.AWReportDocxExporter" parent="baseReportExporter">
<property name="exportParameters" ref="aw_exportParameters"/>
<property name="setResponseContentLength" value="true"/>
</bean>
<bean id="aw_reportRtfExporter" class="com.aspose.words.jasperreports.AWReportRtfExporter" parent="baseReportExporter">
<property name="exportParameters" ref="aw_exportParameters"/>
<property name="setResponseContentLength" value="true"/>
</bean>
<bean id="aw_reportOdtExporter" class="com.aspose.words.jasperreports.AWReportOdtExporter" parent="baseReportExporter">
<property name="exportParameters" ref="aw_exportParameters"/>
<property name="setResponseContentLength" value="true"/>
</bean>
<bean id="aw_reportHtmlExporter" class="com.aspose.words.jasperreports.AWReportHtmlExporter" parent="baseReportExporter">
<property name="exportParameters" ref="aw_exportParameters"/>
<property name="setResponseContentLength" value="true"/>
</bean>
<bean id="aw_reportTxtExporter" class="com.aspose.words.jasperreports.AWReportTxtExporter" parent="baseReportExporter">
<property name="exportParameters" ref="aw_exportParameters"/>
<property name="setResponseContentLength" value="true"/>
</bean>
<bean id="aw_docExporterConfiguration" class="com.jaspersoft.jasperserver.war.action.ExporterConfigurationBean">
<property name="descriptionKey" value="DOC – Word Document via Aspose.Words"/>
<property name="iconSrc" value="/images/aw_doc.gif"/>
<property name="parameterDialogName" value=""/>
<property name="exportParameters" ref="aw_exportParameters"/>
<property name="currentExporter" ref="aw_reportDocExporter"/>
</bean>
<bean id="aw_docxExporterConfiguration" class="com.jaspersoft.jasperserver.war.action.ExporterConfigurationBean">
<property name="descriptionKey" value="OOXML – Office Open Document via Aspose.Words"/>
<property name="iconSrc" value="/images/aw_docx.gif"/>
<property name="parameterDialogName" value=""/>
<property name="exportParameters" ref="aw_exportParameters"/>
<property name="currentExporter" ref="aw_reportDocxExporter"/>
</bean>
<bean id="aw_rtfExporterConfiguration" class="com.jaspersoft.jasperserver.war.action.ExporterConfigurationBean">
<property name="descriptionKey" value="RTF – Rich Text Format via Aspose.Words"/>
<property name="iconSrc" value="/images/aw_rtf.gif"/>
<property name="parameterDialogName" value=""/>
<property name="exportParameters" ref="aw_exportParameters"/>
<property name="currentExporter" ref="aw_reportRtfExporter"/>
</bean>
<bean id="aw_odtExporterConfiguration" class="com.jaspersoft.jasperserver.war.action.ExporterConfigurationBean">
<property name="descriptionKey" value="ODT – OpenDocument Text via Aspose.Words"/>
<property name="iconSrc" value="/images/aw_odt.gif"/>
<property name="parameterDialogName" value=""/>
<property name="exportParameters" ref="aw_exportParameters"/>
<property name="currentExporter" ref="aw_reportOdtExporter"/>
</bean>
<bean id="aw_htmlExporterConfiguration" class="com.jaspersoft.jasperserver.war.action.ExporterConfigurationBean">
<property name="descriptionKey" value="HTML – Web Page via Aspose.Words"/>
<property name="iconSrc" value="/images/aw_html.gif"/>
<property name="parameterDialogName" value=""/>
<property name="exportParameters" ref="aw_exportParameters"/>
<property name="currentExporter" ref="aw_reportHtmlExporter"/>
</bean>
<bean id="aw_txtExporterConfiguration" class="com.jaspersoft.jasperserver.war.action.ExporterConfigurationBean">
<property name="descriptionKey" value="TXT – Plain Text via Aspose.Words"/>
<property name="iconSrc" value="/images/aw_txt.gif"/>
<property name="parameterDialogName" value=""/>
<property name="exportParameters" ref="aw_exportParameters"/>
<property name="currentExporter" ref="aw_reportTxtExporter"/>
</bean>
Step 2. Locate the <util:map id=”exporterConfigMap> element in the <InstallDir>\apache-tomcat\webapps\jasperserver\WEB-INF\flows\viewReportBeans.xml file and add the following lines:
[XML]
<util:map id="exporterConfigMap">
<entry key="pdf" value-ref="pdfExporterConfiguration"/>
<entry key="xls" value-ref="xlsExporterConfiguration"/>
<entry key="rtf" value-ref="rtfExporterConfiguration"/>
<entry key="csv" value-ref="csvExporterConfiguration"/>
<entry key="swf" value-ref="swfExporterConfiguration"/>
<!-- START of ADDED LINES -->
<entry key="aw_doc" value-ref="aw_docExporterConfiguration"/>
<entry key="aw_docx" value-ref="aw_docxExporterConfiguration"/>
<entry key="aw_rtf" value-ref="aw_rtfExporterConfiguration"/>
<entry key="aw_odt" value-ref="aw_odtExporterConfiguration"/>
<entry key="aw_html" value-ref="aw_htmlExporterConfiguration"/>
<entry key="aw_txt" value-ref="aw_txtExporterConfiguration"/>
<!-- END of ADDED LINES -->
</util:map>
Step 3. Copy all *.GIF images from the \lib folder of aspose.words.jasperreports.zip to <InstallDir>\apache-tomcat\webapps\jasperserver\images\.
Step 4. Copy a single .jar file from the \lib folder of aspose.words.jasperreports.zip to <InstallDir>\apache-tomcat\webapps\jasperserver\WEB-INF\lib\.
If you are using JasperReports v3.7.1 (or lower), copy aspose.words.jasperreports-3.7.1.jar file.
If you are using JasperReports v3.7.2 ... v4.5.0, copy aspose.words.jasperreports-4.5.0.jar file.
If you are using JasperReports v4.7.0, copy aspose.words.jasperreports-4.7.0.jar file.
If you are using JasperReports v5.0.0/v5.1.0, copy aspose.words.jasperreports-5.1.0.jar file.
NOTE: You need to copy ONLY ONE jar file.
Step 5. Add the following lines to the <InstallDir>\apache-tomcat\webapps\jasperserver\WEB-INF\applicationContext.xml file.
This bean may contain various configuration settings intended to configure the export. For example, you can use the JasperReports font mapping feature or specify the location of the Aspose.Words for JasperReports license file.
<bean id="aw_exportParameters" class="com.aspose.words.jasperreports.AWExportParametersBean">
<property name="fontMap">
<util:map id="fontMap">
<entry key="sansserif" value="Arial"/>
<entry key="serif" value="Times New Roman"/>
<entry key="monospaced" value="Courier"/>
</util:map>
</property>
<!-- Uncomment to apply a license. Check the license path.
<property name="licenseFile" value="C:/jasperserver-3.0/apache-tomcat/webapps/jasperserver/WEB-INF/Aspose.Words.JasperReports.lic"/>
-->
</bean>
Step 6. Note: this is applied to JasperServer 4.7.0 and higher. Change the following line in the <InstallDir>\apache-tomcat\webapps\jasperserver\WEB-INF\classes\esapi\security-config.properties file:
from
security.validation.input.on=true
to
security.validation.input.on=false
Step 7. Run JasperServer and open any report to view. If the previous steps were performed properly, you will see the additional format icons available.
New export formats available (on the right) after installing Aspose.Words for JasperReports on JasperServer.