Documentation – Crear o cargar un documento en Java

Java: Especifique las opciones de carga en Java

Mon, 01 Jan 0001 00:00:00 +0000

Al cargar un documento, puede establecer algunas propiedades avanzadas. Aspose.Words le proporciona la clase LoadOptions, que permite un control más preciso del proceso de carga. Algunos formatos de carga tienen una clase correspondiente que contiene opciones de carga para este formato de carga, por ejemplo, hay PdfLoadOptions para cargar en formato PDF o TxtLoadOptions para cargar en TXT. Este artículo proporciona ejemplos de cómo trabajar con opciones de la clase LoadOptions.

Establezca la versión Microsoft Word para cambiar la Apariencia

Las diferentes versiones de la aplicación Microsoft Word pueden mostrar los documentos de manera diferente. Por ejemplo,existe un problema bien conocido con OOXML documentos como DOCX o DOTX producidos con WPS Office. En tales casos, es posible que falten elementos esenciales de marcado del documento o que se interpreten de manera diferente, lo que hace que Microsoft Word 2019 muestre dicho documento de manera diferente en comparación con Microsoft Word 2010.

De forma predeterminada, Aspose.Words abre documentos con las reglas de Microsoft Word 2019. Si necesita que la carga de documentos aparezca como sucedería en una de las versiones anteriores de la aplicación Microsoft Word, debe especificar explícitamente la versión deseada utilizando la propiedad MswVersion de la clase LoadOptions.

El siguiente ejemplo de código muestra cómo configurar la versión Microsoft Word con opciones de carga:

Establecer Preferencias de idioma para Cambiar la Apariencia

Los detalles de mostrar un documento en Microsoft Word dependen no solo de la versión de la aplicación y del valor de la propiedad MswVersion, sino también de la configuración de idioma. Microsoft Word puede mostrar los documentos de manera diferente según la configuración del cuadro de diálogo" Preferencias de idioma de Office", que se puede encontrar en “Archivo → Opciones → Idioma”. Mediante este cuadro de diálogo, un usuario puede seleccionar, por ejemplo, idioma principal, idiomas de corrección, idiomas de visualización,etc. Aspose.Words proporciona la propiedad LanguagePreferences como equivalente de este cuadro de diálogo. Si la salida Aspose.Words difiere de la salida Microsoft Word, establezca el valor apropiado para EditingLanguage; esto puede mejorar el documento de salida –.

El siguiente ejemplo de código muestra cómo establecer japonés como EditingLanguage:

Utilice WarningCallback para Controlar Problemas Al Cargar un Documento

Algunos documentos pueden estar dañados, contener entradas no válidas o tener funciones que Aspose.Words no admite actualmente. Si desea conocer los problemas que ocurrieron al cargar un documento, Aspose.Words proporciona la interfaz IWarningCallback.

El siguiente ejemplo de código muestra la implementación de la interfaz IWarningCallback:

Para obtener información sobre todos los problemas durante el tiempo de carga, use la propiedad WarningCallback.

El siguiente ejemplo de código muestra cómo usar esta propiedad:

Utilice ResourceLoadingCallback para Controlar la Carga de Recursos Externos

Un documento puede contener enlaces externos a imágenes ubicadas en algún lugar de un disco local, red o Internet. Aspose.Words carga automáticamente dichas imágenes en un documento, pero hay situaciones en las que es necesario controlar este proceso. Por ejemplo, para decidir si realmente necesitamos cargar una determinada imagen o quizás omitirla. La opción ResourceLoadingCallback load le permite controlar esto.

El siguiente ejemplo de código muestra la implementación de la interfaz IResourceLoadingCallback:

El siguiente ejemplo de código muestra cómo usar la propiedad ResourceLoadingCallback:

Use TempFolder para Evitar una Excepción de Memoria

Aspose.Words admite documentos extremadamente grandes que tienen miles de páginas llenas de contenido enriquecido. Cargar dichos documentos puede requerir mucho RAM. En el proceso de carga, Aspose.Words necesita aún más memoria para contener las estructuras temporales utilizadas para analizar un documento.

Si tiene un problema con la excepción de falta de memoria al cargar un documento, intente usar la propiedad TempFolder. En este caso, Aspose.Words almacenará algunos datos en archivos temporales en lugar de en la memoria, y esto puede ayudar a evitar dicha excepción.

El siguiente ejemplo de código muestra cómo establecer TempFolder:

Establezca la Codificación Explícitamente

La mayoría de los formatos de documentos modernos almacenan su contenido en Unicode y no requieren un manejo especial. Por otro lado, todavía hay muchos documentos que usan alguna codificación anterior a Unicode y, a veces, omiten información de codificación o ni siquiera admiten información de codificación por naturaleza. Aspose.Words intenta detectar automáticamente la codificación adecuada de forma predeterminada, pero en un caso raro, es posible que deba usar una codificación diferente a la detectada por nuestro algoritmo de reconocimiento de codificación. En este caso, use la propiedad Encoding para obtener o establecer la codificación.

El siguiente ejemplo de código muestra cómo configurar la codificación para que anule la codificación elegida automáticamente:

Cargar Documentos Cifrados

Puede cargar documentos de Word cifrados con una contraseña. Para hacer esto, use una sobrecarga de constructor especial, que acepta un objeto LoadOptions. Este objeto contiene la propiedad Password, que especifica la cadena de contraseña.

El siguiente ejemplo de código muestra cómo cargar un documento cifrado con una contraseña:

Si no sabe de antemano si el archivo está cifrado, puede usar la clase FileFormatUtil, que proporciona métodos de utilidad para trabajar con formatos de archivo, como detectar el formato de archivo o convertir extensiones de archivo a/desde enumeraciones de formato de archivo. Para detectar si el documento está cifrado y requiere una contraseña para abrirlo, use la propiedad IsEncrypted.

El siguiente ejemplo de código muestra cómo verificar que OpenDocument esté encriptado o no:

Java: Detectar Formato de Archivo

Mon, 01 Jan 0001 00:00:00 +0000

A veces es necesario determinar el formato de un documento antes de abrirlo porque la extensión del archivo no garantiza que el contenido del archivo sea el adecuado. Por ejemplo, se sabe que Crystal Reports a menudo genera documentos en formato RTF, pero les da el .extensión doc.

Aspose.Words proporciona la capacidad de obtener información sobre el tipo de archivo para evitar una excepción si no está seguro de cuál es el contenido real del archivo.

Detecte el Formato de Archivo sin excepción

Cuando se trata de varios documentos en varios formatos de archivo, es posible que deba separar los archivos que pueden procesarse con Aspose.Words de los que no pueden. También es posible que desee saber por qué no se pueden procesar algunos de los documentos.

Si intenta cargar un archivo en un objeto Document y Aspose.Words no puede reconocer el formato de archivo o el formato no es compatible, Aspose.Words generará una excepción. Puede detectar esas excepciones y analizarlas, pero Aspose.Words también proporciona el método DetectFileFormat que nos permite determinar rápidamente el formato de archivo sin cargar un documento con posibles excepciones. Este método devuelve un objeto FileFormatInfo que contiene la información detectada sobre el tipo de archivo.

DetectFileFormat solo comprueba el formato de archivo, pero no valida el formato de archivo. No hay garantía de que el archivo se abra correctamente, incluso si DetectFileFormat devuelve que es uno de los formatos admitidos. Esto se debe a que el método DetectFileFormat lee solo datos parciales del formato del archivo, suficientes para verificar el formato del archivo, pero no lo suficiente para una validación completa.

Comprobar la Compatibilidad de Formatos de Archivos

Podemos verificar la compatibilidad de formato de todos los archivos en la carpeta seleccionada y ordenarlos por formato en las subcarpetas correspondientes.

Dado que estamos tratando con el contenido de una carpeta, lo primero que debemos hacer es obtener una colección de todos los archivos de esta carpeta utilizando el método GetFiles de la clase Directory (del espacio de nombres System.IO).

El siguiente ejemplo de código muestra cómo obtener una lista de todos los archivos en la carpeta:

Cuando se recopilan todos los archivos, el resto del trabajo se realiza mediante el método DetectFileFormat, que verifica el formato del archivo.

El siguiente ejemplo de código muestra cómo iterar sobre la lista recopilada de archivos, verificar el formato de cada archivo y mover cada archivo a la carpeta correspondiente:

Los archivos se mueven a las subcarpetas apropiadas utilizando el método Move de la clase File, desde el mismo espacio de nombres System.IO.

Los siguientes archivos se utilizan en el ejemplo anterior. El nombre del archivo está a la izquierda y su descripción a la derecha:

Grupo de Archivos	Documento de Entrada	Tipo
Formatos de archivo admitidos	Test File (Doc).doc	Microsoft Word 95/6.0 o Microsoft Word 97 – documento de 2003.
	Test File (Dot).dot	Plantilla Microsoft Word 95 / 6.0 o Microsoft Word 97 – 2003.
	Test File (Docx).docx	Office Abre XML WordprocessingML documento sin macros.
	Test File (Docm).docm	Office Abre XML WordprocessingML documento con macros.
	Test File (Dotx).dotx	Plantilla de oficina abierta XML WordprocessingML.
	Test File (Dotm).dotm	Plantilla Office Open XML WordprocessingML con macros.
	Test File (XML).xml	FlatOPC OOXML Documento.
	Test File (RTF).rtf	Documento de Formato de Texto Enriquecido.
	Test File (WordML).xml	Microsoft Word documento de 2003 WordprocessingML.
	Test File (HTML).html	HTML documento.
	Test File (MHTML).mhtml	Documento MHTML (Archivo web).
	Test File (Odt).odt	OpenDocument Texto (OpenOffice Escritor).
	Test File (Ott).ott	Plantilla de documento OpenDocument.
	Test File (DocPreWord60).doc	Microsoft Word 2.0 documento.
Documentos cifrados	Test File (Enc).doc	Documento cifrado Microsoft Word 95 / 6.0 o Microsoft Word 97 – 2003.
	Test File (Enc).docx	Documento Office Open XML WordprocessingML cifrado.
Formatos de archivo no compatibles	Test File (JPG).jpg	JPEG archivo de imagen.