Trabajar con documentos PDF/A working-with-pdf-a-documents
Acerca del servicio DocConverter
El servicio DocConverter puede convertir documentos de PDF en documentos PDA/A. Puede realizar estas tareas con este servicio:
- Convierta documentos de PDF en documentos de PDF/A. (Consulte Conversión de documentos a documentos de PDF/A.)
- Determine si los documentos de PDF son documentos de PDF/A. (Consulte Determinación Programática De La Conformidad Con PDF/A.)
Conversión de documentos a documentos de PDF/A converting-documents-to-pdf-a-documents
Puede utilizar el servicio DocConverter para convertir un documento de PDF en un documento de PDF/A. Dado que PDF/A es un formato de archivo para la preservación a largo plazo del contenido del documento, todas las fuentes están incrustadas y el archivo no está comprimido. Como resultado, un documento PDF/A suele ser más grande que un documento PDF estándar. Además, un documento PDF/A no contiene contenido de audio y vídeo. Antes de convertir un documento de PDF en un documento de PDF/A, asegúrese de que el documento de PDF no sea un documento de PDF/A.
La especificación PDF/A-1 consta de dos niveles de conformidad, a saber, A y B. La principal diferencia entre los dos es la compatibilidad con la estructura lógica (accesibilidad), que no es necesaria para el nivel de conformidad B. Independientemente del nivel de conformidad, PDF/A-1 dicta que todas las fuentes estén incrustadas en el documento PDF/A generado. En este momento, solo se admite PDF/A-1b en la validación (y conversión).
Aunque PDF/A es el estándar para archivar documentos de PDF, no es obligatorio que PDF/A se utilice para archivar si un documento estándar de PDF cumple los requisitos de su empresa. El propósito del estándar PDF/A es crear un archivo PDF diseñado para las necesidades de archivado y conservación de documentos a largo plazo.
Resumen de los pasos summary-of-steps
Para convertir un documento de PDF en un documento de PDF/A, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Crear un cliente DocConvert
- Hacer referencia a un documento de PDF para convertirlo en un documento de PDF/A.
- Configure la información de seguimiento.
- Convertir el documento.
- Guarde el documento de PDF/A.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente con Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Los siguientes archivos JAR deben agregarse a la ruta de clase del proyecto:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-docconverter-client.jar
- adobe-utilities.jar (requerido si AEM Forms está implementado en el servidor de aplicaciones JBoss)
- jbossall-client.jar (requerido si AEM Forms está implementado en el servidor de aplicaciones JBoss)
Para obtener información sobre la ubicación de estos archivos JAR, consulte Inclusión de archivos de biblioteca Java de AEM Forms.
Crear un cliente DocConvert
Para poder realizar mediante programación una operación DocConverter, debe crear un cliente DocConverter. Si está usando la API de Java, cree un objeto DocConverterServiceClient. Si está usando la API del servicio web DocConverter, cree un objeto DocConverterServiceService.
Hacer referencia a un documento de PDF para convertirlo en un documento de PDF/A
Recupere un documento de PDF para convertirlo en un documento de PDF/A. Si intenta convertir un documento de PDF, como un formulario de Acrobat, en un documento de PDF/A, se producirá una excepción.
Establecer información de seguimiento
Puede establecer una opción en tiempo de ejecución que determine la cantidad de información que se rastreará durante el proceso de conversión. Es decir, puede establecer nueve niveles diferentes que especifiquen la cantidad de información que el servicio DocConverter rastrea cuando convierte un documento de PDF en un documento de PDF/A.
Convertir el documento
Después de crear el cliente del servicio DocConverter, haga referencia al documento de PDF para convertir y establezca la opción en tiempo de ejecución que especifica la cantidad de información de la que se realiza el seguimiento, puede convertir el documento de PDF en un documento de PDF/A.
Guardar el documento de PDF/A
Puede guardar el documento de PDF/A como archivo de PDF.
Consulte también
Conversión de documentos en documentos de PDF/A mediante la API de Java
Conversión de documentos en documentos de PDF/A mediante la API de servicio web
Incluir archivos de biblioteca Java de AEM Forms
Conversión de documentos en documentos de PDF/A mediante la API de Java convert-documents-to-pdf-a-documents-using-the-java-api
Conversión de un documento de PDF en un documento de PDF/A mediante la API de Java:
-
Incluir archivos de proyecto
Incluya archivos JAR de cliente, como adobe-docconverter-client.jar, en la ruta de clase del proyecto Java.
-
Crear un cliente DocConvert
- Cree un objeto
ServiceClientFactoryque contenga propiedades de conexión. - Cree un objeto
DocConverterServiceClientutilizando su constructor y pasando el objetoServiceClientFactory.
- Cree un objeto
-
Hacer referencia a un documento de PDF para convertirlo en un documento de PDF/A
- Cree un objeto
java.io.FileInputStreamque represente el documento de PDF que se va a convertir mediante su constructor y pasando un valor de cadena que especifique la ubicación del archivo de PDF. - Cree un objeto
com.adobe.idp.Documentutilizando su constructor y pasando el objetojava.io.FileInputStream.
- Cree un objeto
-
Establecer información de seguimiento
- Crear un objeto
PDFAConversionOptionSpecmediante su constructor. - Establezca el nivel de seguimiento de la información invocando el método
setLogLeveldel objetoPDFAConversionOptionSpecy pasando un valor de cadena que especifique el nivel de seguimiento. Por ejemplo, pase el valorFINE. Para obtener información acerca de los distintos valores, vea el métodosetLogLevelen la Referencia de API de AEM Forms.
- Crear un objeto
-
Convertir el documento
Convierta el documento de PDF en un documento de PDF/A invocando el método
toPDFAdel objetoDocConverterServiceClienty pasando los siguientes valores:- El objeto
com.adobe.idp.Documentque contiene el documento de PDF que se va a convertir - El objeto
PDFAConversionOptionSpecque especifica la información de seguimiento
El método
toPDFAdevuelve un objetoPDFAConversionResultque contiene el documento PDF/A. - El objeto
-
Guardar el documento de PDF/A
- Recupere el documento PDF/A invocando el método
getPDFAdel objetoPDFAConversionResult. Este método devuelve un objetocom.adobe.idp.Documentque representa el documento de PDF/A. - Cree un objeto
java.io.Fileque represente el archivo PDF/A. Asegúrese de que la extensión del nombre de archivo sea .pdf. - Rellene el archivo con datos de PDF/A invocando el método
copyToFiledel objetocom.adobe.idp.Documenty pasando el objetojava.io.File.
- Recupere el documento PDF/A invocando el método
Consulte también
Conversión de documentos en documentos de PDF/A mediante la API de servicio web convert-documents-to-pdf-a-documents-using-the-web-service-api
Conversión de un documento de PDF en un documento de PDF/A mediante la API de DocConverter (servicio web):
-
Incluir archivos de proyecto
- Cree un ensamblado de cliente de Microsoft .NET que consuma el WSDL de DocConverter.
- Hacer referencia al ensamblado de cliente de Microsoft .NET.
-
Crear un cliente DocConvert
- Mediante el ensamblado de cliente de Microsoft .NET, cree un objeto
DocConverterServiceServiceinvocando su constructor predeterminado. - Establezca el miembro de datos
Credentialsdel objetoDocConverterServiceServicecon un valorSystem.Net.NetworkCredentialque especifique el valor de nombre de usuario y contraseña.
- Mediante el ensamblado de cliente de Microsoft .NET, cree un objeto
-
Hacer referencia a un documento de PDF para convertirlo en un documento de PDF/A
- Crear un objeto
BLOBmediante su constructor. El objetoBLOBse usa para almacenar el documento de PDF convertido en un documento de PDF/A. - Cree un objeto
System.IO.FileStreaminvocando su constructor y pasando un valor de cadena que represente la ubicación de archivo del documento de PDF y el modo para abrir el archivo en. - Cree una matriz de bytes que almacene el contenido del objeto
System.IO.FileStream. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedadLengthdel objetoSystem.IO.FileStream. - Rellene la matriz de bytes con datos de secuencia invocando el método
Readdel objetoSystem.IO.FileStreamy pasando a leer la matriz de bytes, la posición inicial y la longitud de secuencia. - Rellene el objeto
BLOBasignando su propiedadbinaryDatacon el contenido de la matriz de bytes.
- Crear un objeto
-
Establecer información de seguimiento
- Crear un objeto
PDFAConversionOptionSpecmediante su constructor. - Establezca el nivel de seguimiento de la información asignando un valor que especifique el nivel de seguimiento al miembro de datos
logLeveldel objetoPDFAConversionOptionSpec. Por ejemplo, asigne el valorFINEa este miembro de datos.
- Crear un objeto
-
Convertir el documento
Convierta el documento de PDF en un documento de PDF/A invocando el método
toPDFAdel objetoDocConverterServiceServicey pasando los siguientes valores:- El objeto
BLOBque contiene el documento de PDF que se va a convertir - El objeto
PDFAConversionOptionSpecque especifica la información de seguimiento
El método
toPDFAdevuelve un objetoPDFAConversionResultque contiene el documento PDF/A. - El objeto
-
Guardar el documento de PDF/A
- Cree un objeto
BLOBque almacene el documento PDF/A obteniendo el valor del miembro de datosPDFADocumentdel objetoPDFAConversionResult. - Cree una matriz de bytes que almacene el contenido del objeto
BLOBdevuelto mediante el objetoPDFAConversionResult. Rellene la matriz de bytes obteniendo el valor del miembro de datosbinaryDatadel objetoBLOB. - Cree un objeto
System.IO.FileStreaminvocando su constructor y pasando un valor de cadena que represente la ubicación de archivo del documento de PDF/A. - Cree un objeto
System.IO.BinaryWriterinvocando su constructor y pasando el objetoSystem.IO.FileStream. - Escriba el contenido de la matriz de bytes en un archivo PDF invocando el método
Writedel objetoSystem.IO.BinaryWritery pasando la matriz de bytes.
- Cree un objeto
Consulte también
Invocar AEM Forms con codificación Base64
Crear un ensamblado de cliente .NET que utilice codificación Base64
Determinación programática de la compatibilidad con PDF/A programmatically-determining-pdf-a-compliancy
Puede utilizar el servicio DocConverter para determinar si un documento de PDF es compatible con PDF/A. Para obtener información sobre un documento de PDF/A y cómo convertir un documento de PDF en un documento de PDF/A, consulte Conversión de documentos a documentos de PDF/A.
Resumen de los pasos summary_of_steps-1
Para determinar la conformidad con PDF/A, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Crear un cliente DocConvert
- Hacer referencia a un documento de PDF utilizado para determinar la conformidad con PDF/A.
- Establecer opciones en tiempo de ejecución.
- Recupere información sobre el documento de PDF.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente con Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Los siguientes archivos JAR deben agregarse a la ruta de clase del proyecto:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-docconverter-client.jar
- adobe-utilities.jar (requerido si AEM Forms está implementado en el servidor de aplicaciones JBoss)
- jbossall-client.jar (requerido si AEM Forms está implementado en el servidor de aplicaciones JBoss)
Para obtener información sobre la ubicación de estos archivos JAR, consulte Inclusión de archivos de biblioteca Java de AEM Forms.
Crear un cliente DocConvert
Para poder realizar mediante programación una operación DocConverter, debe crear un cliente DocConverter. Si está usando la API de Java, cree un objeto DocConverterServiceClient. Si está usando la API del servicio web DocConverter, cree un objeto DocConverterServiceService.
Hacer referencia a un documento de PDF utilizado para determinar la conformidad con PDF/A
Se debe hacer referencia a un documento de PDF y pasarlo al servicio DocConverter para determinar si el documento de PDF es compatible con PDF/A.
Establecer opciones en tiempo de ejecución
Puede establecer una opción en tiempo de ejecución que determine la cantidad de información que se rastreará durante el proceso de conversión. Es decir, puede establecer nueve niveles diferentes que especifiquen cuánta información rastrea el servicio DocConverter cuando convierte un documento de PDF en un documento de PDF/A.
Recuperar información acerca del documento de PDF
Después de crear el cliente de servicio DocConverter, hacer referencia al documento de PDF y establecer las opciones en tiempo de ejecución, puede determinar si el documento de PDF es un documento compatible con PDF/A.
Consulte también
Determinar la conformidad de PDF/A mediante la API de Java
Determinar la conformidad de PDF/A mediante la API del servicio web
Determinar la conformidad de PDF/A mediante la API de Java determine-pdf-a-compliancy-using-the-java-api
Determine la conformidad con PDF/A mediante la API de Java:
-
Incluir archivos de proyecto
Incluya archivos JAR de cliente, como adobe-docconverter-client.jar, en la ruta de clase del proyecto Java.
-
Crear un cliente DocConvert
- Cree un objeto
ServiceClientFactoryque contenga propiedades de conexión. - Cree un objeto
DocConverterServiceClientutilizando su constructor y pasando el objetoServiceClientFactory.
- Cree un objeto
-
Hacer referencia a un documento de PDF utilizado para determinar la conformidad con PDF/A
- Cree un objeto
java.io.FileInputStreamque represente el documento de PDF que se va a convertir mediante su constructor y pasando un valor de cadena que especifique la ubicación del archivo de PDF. - Cree un objeto
com.adobe.idp.Documentutilizando su constructor y pasando el objetojava.io.FileInputStream.
- Cree un objeto
-
Establecer opciones en tiempo de ejecución
- Crear un objeto
PDFAValidationOptionSpecmediante su constructor. - Defina el nivel de cumplimiento invocando el método
setCompliancedel objetoPDFAValidationOptionSpecy pasandoPDFAValidationOptionSpec.Compliance.PDFA_1B. - Establezca el nivel de seguimiento de la información invocando el método
setLogLeveldel objetoPDFAValidationOptionSpecy pasando un valor de cadena que especifique el nivel de seguimiento. Por ejemplo, pase el valorFINE. Para obtener información acerca de los distintos valores, vea el métodosetLogLevelen la Referencia de API de AEM Forms.
- Crear un objeto
-
Recuperar información sobre el documento de PDF
Para determinar la compatibilidad con PDF/A, invoque el método
isPDFAdel objetoDocConverterServiceClienty pase los siguientes valores:- El objeto
com.adobe.idp.Documentque contiene el documento de PDF. - El objeto
PDFAValidationOptionSpecque especifica las opciones en tiempo de ejecución.
El método
isPDFAdevuelve un objetoPDFAValidationResultque contiene los resultados de esta operación. - El objeto
Consulte también
Inicio rápido (modo SOAP): Determinación del cumplimiento de PDF/A mediante la API de Java
Determinar la conformidad de PDF/A mediante la API del servicio web determine-pdf-a-compliancy-using-the-web-service-api
Determine la conformidad de PDF/A mediante la API del servicio web:
-
Incluir archivos de proyecto
- Cree un ensamblado de cliente de Microsoft .NET que consuma el WSDL de DocConverter.
- Hacer referencia al ensamblado de cliente de Microsoft .NET.
-
Crear un cliente DocConvert
- Mediante el ensamblado de cliente de Microsoft .NET, cree un objeto
DocConverterServiceServiceinvocando su constructor predeterminado. - Establezca el miembro de datos
Credentialsdel objetoDocConverterServiceServicecon un valorSystem.Net.NetworkCredentialque especifique el valor de nombre de usuario y contraseña.
- Mediante el ensamblado de cliente de Microsoft .NET, cree un objeto
-
Hacer referencia a un documento de PDF utilizado para determinar la conformidad con PDF/A
- Crear un objeto
BLOBmediante su constructor. El objetoBLOBse usa para almacenar el documento de PDF convertido en un documento de PDF/A. - Cree un objeto
System.IO.FileStreaminvocando su constructor y pasando un valor de cadena que represente la ubicación de archivo del documento de PDF y el modo para abrir el archivo en. - Cree una matriz de bytes que almacene el contenido del objeto
System.IO.FileStream. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedadLengthdel objetoSystem.IO.FileStream. - Rellene la matriz de bytes con datos de secuencia invocando el método
Readdel objetoSystem.IO.FileStreamy pasando a leer la matriz de bytes, la posición inicial y la longitud de secuencia. - Rellene el objeto
BLOBasignando su propiedadbinaryDatacon el contenido de la matriz de bytes.
- Crear un objeto
-
Establecer opciones en tiempo de ejecución
- Crear un objeto
PDFAValidationOptionSpecmediante su constructor. - Establezca el nivel de cumplimiento asignando el miembro de datos
compliancedel objetoPDFAValidationOptionSpeccon el valorPDFAConversionOptionSpec_Compliance.PDFA_1B. - Establezca el nivel de seguimiento de la información asignando el miembro de datos
resultLeveldel objetoPDFAValidationOptionSpeccon el valorPDFAValidationOptionSpec_ResultLevel.DETAILED.
- Crear un objeto
-
Recuperar información sobre el documento de PDF
Para determinar la compatibilidad con PDF/A, invoque el método
isPDFAdel objetoDocConverterServiceServicey pase los siguientes valores:- El objeto
BLOBque contiene el documento de PDF. - El objeto
PDFAValidationOptionSpecque contiene opciones en tiempo de ejecución.
El método
isPDFAdevuelve un objetoPDFAValidationResultque contiene los resultados de esta operación. - El objeto
Consulte también
Invocar AEM Forms con codificación Base64
Crear un ensamblado de cliente .NET que utilice codificación Base64