Trabajar con documentos PDF/A working-with-pdf-a-documents
Acerca del servicio DocConverter
El servicio DocConverter puede convertir documentos de PDF en documentos de PDA/A. Puede realizar estas tareas con este servicio:
- Conversión de documentos de PDF en documentos de PDF/A. (Consulte Conversión de documentos a documentos de PDF/A.)
- Determine si los documentos del PDF son documentos del PDF/A. (Consulte Determinación Programática De La Conformidad De 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. Como 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 de 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 el 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 de PDF estándar cumple los requisitos de su empresa. El propósito de la norma PDF/A es crear un archivo PDF destinado a las necesidades de archivo 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 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 PDF para convertirlo en un documento 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 de servicio DocConverter, haga referencia al documento de PDF para convertir y establezca la opción de tiempo de ejecución que especifica cuánta información se rastrea, 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 un 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
ServiceClientFactory
que contenga propiedades de conexión. - Cree un objeto
DocConverterServiceClient
utilizando 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.FileInputStream
que represente el documento de PDF que se va a convertir utilizando su constructor y pasando un valor de cadena que especifique la ubicación del archivo de PDF. - Cree un objeto
com.adobe.idp.Document
utilizando su constructor y pasando el objetojava.io.FileInputStream
.
- Cree un objeto
-
Establecer información de seguimiento
- Crear un objeto
PDFAConversionOptionSpec
mediante su constructor. - Establezca el nivel de seguimiento de la información invocando el método
setLogLevel
del objetoPDFAConversionOptionSpec
y 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étodosetLogLevel
en la Referencia de API de AEM Forms.
- Crear un objeto
-
Convertir el documento
Convierta el documento de PDF en un documento PDF/A invocando el método
toPDFA
del objetoDocConverterServiceClient
y pasando los siguientes valores:- El objeto
com.adobe.idp.Document
que contiene el documento de PDF que se va a convertir - El objeto
PDFAConversionOptionSpec
que especifica la información de seguimiento
El método
toPDFA
devuelve un objetoPDFAConversionResult
que contiene el documento PDF/A. - El objeto
-
Guarde el documento PDF/A.
- Recupere el documento PDF/A invocando el método
getPDFA
del objetoPDFAConversionResult
. Este método devuelve un objetocom.adobe.idp.Document
que representa el documento PDF/A. - Cree un objeto
java.io.File
que 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
copyToFile
del objetocom.adobe.idp.Document
y 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
DocConverterServiceService
invocando su constructor predeterminado. - Establezca el miembro de datos
Credentials
del objetoDocConverterServiceService
con un valorSystem.Net.NetworkCredential
que 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
BLOB
mediante su constructor. El objetoBLOB
se usa para almacenar el documento de PDF convertido en un documento de PDF/A. - Cree un objeto
System.IO.FileStream
invocando 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 propiedadLength
del objetoSystem.IO.FileStream
. - Rellene la matriz de bytes con datos de secuencia invocando el método
Read
del objetoSystem.IO.FileStream
y pasando a leer la matriz de bytes, la posición inicial y la longitud de secuencia. - Rellene el objeto
BLOB
asignando su propiedadbinaryData
con el contenido de la matriz de bytes.
- Crear un objeto
-
Establecer información de seguimiento
- Crear un objeto
PDFAConversionOptionSpec
mediante su constructor. - Establezca el nivel de seguimiento de la información asignando un valor que especifique el nivel de seguimiento al miembro de datos
logLevel
del objetoPDFAConversionOptionSpec
. Por ejemplo, asigne el valorFINE
a este miembro de datos.
- Crear un objeto
-
Convertir el documento
Convierta el documento de PDF en un documento PDF/A invocando el método
toPDFA
del objetoDocConverterServiceService
y pasando los siguientes valores:- El objeto
BLOB
que contiene el documento de PDF que se va a convertir - El objeto
PDFAConversionOptionSpec
que especifica la información de seguimiento
El método
toPDFA
devuelve un objetoPDFAConversionResult
que contiene el documento PDF/A. - El objeto
-
Guarde el documento PDF/A.
- Cree un objeto
BLOB
que almacene el documento PDF/A obteniendo el valor del miembro de datosPDFADocument
del objetoPDFAConversionResult
. - Cree una matriz de bytes que almacene el contenido del objeto
BLOB
devuelto mediante el objetoPDFAConversionResult
. Rellene la matriz de bytes obteniendo el valor del miembro de datosbinaryData
del objetoBLOB
. - Cree un objeto
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación de archivo del documento PDF/A. - Cree un objeto
System.IO.BinaryWriter
invocando su constructor y pasando el objetoSystem.IO.FileStream
. - Escriba el contenido de la matriz de bytes en un archivo PDF invocando el método
Write
del objetoSystem.IO.BinaryWriter
y 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 conformidad de PDF/A programmatically-determining-pdf-a-compliancy
Puede utilizar el servicio DocConverter para determinar si un documento de PDF es compatible con el PDF/A. Para obtener información sobre un documento de PDF PDF/A y cómo convertirlo 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 del 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 de PDF/A.
- Establecer opciones en tiempo de ejecución.
- Recupere información sobre el documento del 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 del 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 el 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 sobre el documento del 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 el PDF/A.
Consulte también
Determinar la conformidad del PDF/A mediante la API de Java
Determinar la conformidad del PDF/A mediante la API del servicio web
Determinar la conformidad del PDF/A mediante la API de Java determine-pdf-a-compliancy-using-the-java-api
Determine la conformidad del 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
ServiceClientFactory
que contenga propiedades de conexión. - Cree un objeto
DocConverterServiceClient
utilizando su constructor y pasando el objetoServiceClientFactory
.
- Cree un objeto
-
Hacer referencia a un documento de PDF utilizado para determinar la conformidad de PDF/A.
- Cree un objeto
java.io.FileInputStream
que represente el documento de PDF que se va a convertir utilizando su constructor y pasando un valor de cadena que especifique la ubicación del archivo de PDF. - Cree un objeto
com.adobe.idp.Document
utilizando su constructor y pasando el objetojava.io.FileInputStream
.
- Cree un objeto
-
Establecer opciones en tiempo de ejecución
- Crear un objeto
PDFAValidationOptionSpec
mediante su constructor. - Defina el nivel de cumplimiento invocando el método
setCompliance
del objetoPDFAValidationOptionSpec
y pasandoPDFAValidationOptionSpec.Compliance.PDFA_1B
. - Establezca el nivel de seguimiento de la información invocando el método
setLogLevel
del objetoPDFAValidationOptionSpec
y 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étodosetLogLevel
en la Referencia de API de AEM Forms.
- Crear un objeto
-
Recuperar información sobre el documento del PDF
Determine la conformidad del PDF/A invocando el método
isPDFA
del objetoDocConverterServiceClient
y pasando los siguientes valores:- El objeto
com.adobe.idp.Document
que contiene el documento de PDF. - El objeto
PDFAValidationOptionSpec
que especifica las opciones en tiempo de ejecución.
El método
isPDFA
devuelve un objetoPDFAValidationResult
que contiene los resultados de esta operación. - El objeto
Consulte también
SOAP Inicio rápido (modo de): Determinación del cumplimiento de PDF/A mediante la API de Java
Determinar la conformidad del PDF/A mediante la API del servicio web determine-pdf-a-compliancy-using-the-web-service-api
Determine la conformidad del 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
DocConverterServiceService
invocando su constructor predeterminado. - Establezca el miembro de datos
Credentials
del objetoDocConverterServiceService
con un valorSystem.Net.NetworkCredential
que 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 de PDF/A.
- Crear un objeto
BLOB
mediante su constructor. El objetoBLOB
se usa para almacenar el documento de PDF convertido en un documento de PDF/A. - Cree un objeto
System.IO.FileStream
invocando 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 propiedadLength
del objetoSystem.IO.FileStream
. - Rellene la matriz de bytes con datos de secuencia invocando el método
Read
del objetoSystem.IO.FileStream
y pasando a leer la matriz de bytes, la posición inicial y la longitud de secuencia. - Rellene el objeto
BLOB
asignando su propiedadbinaryData
con el contenido de la matriz de bytes.
- Crear un objeto
-
Establecer opciones en tiempo de ejecución
- Crear un objeto
PDFAValidationOptionSpec
mediante su constructor. - Establezca el nivel de cumplimiento asignando el miembro de datos
compliance
del objetoPDFAValidationOptionSpec
con el valorPDFAConversionOptionSpec_Compliance.PDFA_1B
. - Establezca el nivel de seguimiento de la información asignando el miembro de datos
resultLevel
del objetoPDFAValidationOptionSpec
con el valorPDFAValidationOptionSpec_ResultLevel.DETAILED
.
- Crear un objeto
-
Recuperar información sobre el documento del PDF
Determine la conformidad del PDF/A invocando el método
isPDFA
del objetoDocConverterServiceService
y pasando los siguientes valores:- El objeto
BLOB
que contiene el documento de PDF. - El objeto
PDFAValidationOptionSpec
que contiene opciones en tiempo de ejecución.
El método
isPDFA
devuelve un objetoPDFAValidationResult
que 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