Contenido
Este documento explica cómo instalar el módulo WordToPDF que permite convertir un documento en un formato dado en otro documento con distinto formato.
Versiones
Versión 0.0.3
La versión 0.0.3 de WordToPDF está indicada para entornos con Java 7 y posteriores. Utiliza la librería Aspose.Words for Java para las conversiones.
Versión 0.0.4
La versión 0.0.4 de WordToPDF está indicada para entornos con Java 11 y posteriores. Utiliza la librería Aspose.Words for Java para las conversiones.
Versión jdk7_v1.0.0
La versión jdk7_v1.0.0 de WordToPDF está indicada para entornos con Java 7 y posteriores. Incorpora el método convertGeneric que utiliza OpenOffice.org para las conversiones además de mantener los métodos existentes.
Versión jdk11_v1.0.0
La versión jdk11_v1.0.0 de WordToPDF está indicada para entornos con Java 11 y posteriores. Incorpora el método convertGeneric que utiliza OpenOffice.org para las conversiones además de mantener los métodos existentes.
Carpeta de fuentes
Versión 0.0.3
Se debe copiar las fuentes en la ruta \home\fuseadmin\wordtopdf\fonts\.
Versión 0.0.4 y posteriores
Se debe crear la variable de entorno FONTS_FOLDER para indicar la ruta de las fuentes. Un ejemplo de ruta sería \home\fuseadmin\wordtopdffonts\:
En Linux, la variable de entorno se puede añadir al fichero .bashrc:
export FONTS_FOLDER="/home/fuseadmin/wordtopdf/fonts/"
Versión 2.0. - Openoffice.org
Se ha añadido un método de conversión genérica (convertGeneric) que utiliza OpenOffice.org (OOo) en lugar de Aspose.Words for Java. Debido a ésto, hay que instalar en el sistema una suite office derivada de OpenOffice.org (OOo) tal como LibreOffice o Apache OpenOffice y configurar la variable de entorno OFFICE_HOME con el directorio de instalación de la suite office. Para Windows se instalará la versión 7.3.4.2 de LibreOffice y el valor de la variable de entorno será C:\\Program Files\LibreOffice. En Linux se instalará la versión 7.2.7 de LibreOffice y el valor de la variable de entorno será /opt/libreoffice7.2/.
En Linux, la variable de entorno se puede añadir al fichero .bashrc:
export OFFICE_HOME="/opt/libreoffice7.2/"
Tomcat
Según la versión de Tomcat en el que se vaya a desplegar el war de WordToPDF se utilizará una de las versiones mencionadas anteriormente. Una vez desplegado el war, se puede acceder al servicio en http://{host}:{puerto}/WordToPdf/:
WSDL
El wsdl del servicio se encuentra en http://{host}:{puerto}/WordToPdf/WordConvEJBService?wsdl.
Métodos
Los métodos del servicio son:
convertDOCX2PDF
Convierte un DOCX a PDF.
Parámetros de entrada
fileB64: Documento DOCX codificado en BASE64.
Parámetros de salida
messageType: Devuelve S si todo ha ido bien y E si ha habido algún error.
pdfB64: Documento PDF codificado en BASE64.
pdfByteLength: Número de bytes.
convertDOCX2HTML
Convierte un DOCX a HTML.
Parámetros de entrada
fileB64: Documento DOCX codificado en BASE64.
Parámetros de salida
messageType: Devuelve S si todo ha ido bien y E si ha habido algún error.
outputB64: Documento HTML codificado en BASE64.
outputByteLength: Número de bytes.
convertDOCX
Convierte un DOCX a uno de los siguientes formatos: DOC, DOT, DOCX, DOCM, DOTX, DOTM, FLAT_OPC, FLAT_OPC_MACRO_ENABLED, FLAT_OPC_TEMPLATE, FLAT_OPC_TEMPLATE_MACRO_ENABLED, RTF, WORD_ML, PDF, XPS, XAML_FIXED, SVG, HTML_FIXED, OPEN_XPS, PS, PCL, HTML, MHTML, EPUB, ODT, OTT, TEXT, XAML_FLOW, XAML_FLOW_PACK, TIFF, PNG, BMP, EMF, JPEG, GIF.
Parámetros de entrada
fileB64: Documento DOCX codificado en BASE64.
outputFormat: Formato de salida.
Parámetros de salida
messageType: Devuelve S si todo ha ido bien y E si ha habido algún error.
outputB64: Documento con el formato outputFormat codificado en BASE64.
outputByteLength: Número de bytes.
convertXLSX2PDF
Convierte un XLSX a PDF.
Parámetros de entrada
fileB64: Documento XLSX codificado en BASE64.
evaluateFormulaCell: Boolean que indica si se debe recalcular las fórmulas de la hoja de cálculo. Puede tomar el valor true o false.
Parámetros de salida
messageText: Mensaje con información del proceso.
messageType: Devuelve S si todo ha ido bien y E si ha habido algún error.
outputB64: Documento PDF codificado en BASE64.
outputByteLength: Número de bytes.
convertGeneric
Convierte un documento en un formato dado a otro.
Formatos soportados
Permite conversiones soportadas por cualquier suite office derivada de OpenOffice.org (OOo) tal como LibreOffice o Apache OpenOffice :
Parámetros de entrada
fileB64: Documento con el formato inputFormat codificado en BASE64.
evaluateFormulaCell: Boolean que indica si se debe recalcular las fórmulas de la hoja de cálculo. Puede tomar el valor true o false. Sólo aplicable para documentos XLSX.
inputFormat: Formato del documento de entrada.
outputFormat: Formato del documento de salida.
Parámetros de salida
messageText: Mensaje con información del proceso.
messageType: Devuelve S si todo ha ido bien y E si ha habido algún error.
outputB64: Documento con el formato outputFormat codificado en BASE64.
outputByteLength: Número de bytes.
evaluateFormulaCellXLSX
Recalcula las fórmulas de una hoja de cálculo.
Parámetros de entrada
fileB64: Documento XLSX codificado en BASE64.
Parámetros de salida
messageText: Mensaje con información del proceso.
messageType: Devuelve S si todo ha ido bien y E si ha habido algún error.
outputB64: Documento XLSX codificado en BASE64.
outputByteLength: Número de bytes.
getLibDetail
Devuelve la versión de la librería Aspose.Words for Java.
