Los ejemplos de este documento solo son para AEM Forms en un entorno JEE.
Acerca del servicio Convertir PDF
El servicio ConvertPDF convierte los documentos de PDF a PostScript y a una serie de formatos de imagen (JPEG, JPEG 2000, PNG y TIFF). Convertir un documento PDF a PostScript es útil para la impresión desatendida basada en servidor en cualquier impresora PostScript. Convertir un documento PDF en un archivo TIFF de varias páginas es práctico cuando se archivan documentos en sistemas de administración de contenido que no admiten documentos PDF.
Puede realizar estas tareas mediante el servicio Convert PDF:
Para obtener más información sobre el servicio ConvertPDF, consulte Referencia de servicios para AEM Forms.
En este tema se describe cómo se puede utilizar la API del servicio ConvertPDF (Java y servicio Web) para convertir mediante programación documentos de PDF en archivos PostScript. El documento de PDF convertido en un archivo PostScript debe ser un documento de PDF no interactivo. Es decir, si intenta convertir un documento PDF interactivo en un archivo PostScript, se genera una excepción.
Para obtener más información sobre el servicio ConvertPDF, consulte Referencia de servicios para AEM Forms.
Para convertir un documento de PDF en un archivo PostScript, realice los siguientes pasos:
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.
Creación de un cliente PDF de conversión
Para poder realizar mediante programación una operación de servicio ConvertPDF, debe crear un cliente de servicio ConvertPDF. Si utiliza la API de Java, cree un ConvertPdfServiceClient
objeto. Si utiliza la API del servicio web, cree un ConvertPDFServiceService
objeto.
Esta sección utiliza la funcionalidad de servicio web que se introduce en AEM Forms. Para acceder a la nueva funcionalidad, debe construir el objeto proxy utilizando lc_version
atributo. (Consulte "Acceso a la nueva funcionalidad mediante servicios web" en Invocar AEM Forms mediante servicios web.)
Hacer referencia al documento de PDF para convertirlo en un archivo PostScript
Haga referencia al documento de PDF que desee convertir en un archivo PostScript. Como se ha indicado anteriormente en este tema, el documento de PDF debe ser un documento de PDF no interactivo. Si intenta convertir un documento PDF interactivo en un archivo PostScript, se producirá una excepción.
Establecer opciones de tiempo de ejecución de conversión
Al convertir un documento de PDF en un archivo PostScript, puede definir opciones en tiempo de ejecución que especifiquen el tipo PostScript que se crea. Por ejemplo, puede definir un archivo PostScript de nivel 3.
Normalmente, el archivo PostScript generado reflejará el tamaño del documento del PDF de entrada. Si selecciona la opción ShrinkToFit
opción (que reduce la salida del archivo PostScript para que se ajuste a la página), no verá una diferencia entre el documento del PDF de entrada y el archivo PostScript generado. El ShrinkToFit
se aplica únicamente si se selecciona imprimir en un tamaño de página menor que el documento del PDF de entrada. Para seleccionar un tamaño de página menor, defina la variable PageSize
opción. Además, se recomienda configurar la variable RotateAndCenter
opción para true
para obtener la salida PostScript correcta.
Del mismo modo, si selecciona la ExpandToFit
(que expande la salida del archivo PostScript para ajustarse a la página), sólo tendrá efecto si selecciona imprimir en un tamaño de página mayor que el documento del PDF de entrada. Para seleccionar un tamaño de página mayor, defina la variable PageSize
opción. Además, se recomienda configurar la variable RotateAndCenter
opción para true
para obtener la salida PostScript correcta.
Para obtener información acerca de los valores en tiempo de ejecución que puede establecer, vea la ToPSOptionsSpec
referencia de clase en Referencia de API de AEM Forms.
Conversión del documento de PDF en un archivo PostScript
Después de crear el cliente de servicios y establecer las opciones en tiempo de ejecución, puede invocar la operación de conversión PostScript. Esta operación necesitará información sobre el documento que se va a convertir, incluido el nivel PostScript preferido para el documento de destino.
Guarde el archivo PostScript
Después de convertir el documento de PDF a PostScript, puede guardar la salida como un archivo PostScript.
Consulte también
Conversión de un documento de PDF en PS mediante la API de Java
Conversión de un documento de PDF en PS mediante la API de servicio web
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Inicios rápidos de la API de ConvertPDF Service
Conversión de un documento de PDF a PostScript mediante la API del servicio ConvertPDF (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-convertpdf-client.jar, en la ruta de clase del proyecto Java.
Cree un cliente PDF de conversión.
ServiceClientFactory
que contiene las propiedades de conexión.ConvertPdfServiceClient
usando su constructor y pasando el objeto ServiceClientFactory
objeto.Hacer referencia al documento de PDF para convertirlo en un archivo PostScript.
java.io.FileInputStream
mediante su constructor y pase un valor de cadena que especifique la ubicación del documento de PDF que se va a convertir.com.adobe.idp.Document
que almacena el documento de PDF utilizando el objeto com.adobe.idp.Document
constructor. Pase el java.io.FileInputStream
que contiene el documento de PDF.Establecer las opciones de tiempo de ejecución de conversión.
ToPSOptionsSpec
invocando su constructor.ToPSOptionsSpec
objeto. Por ejemplo, para definir el nivel de PostScript que se crea, invoque el ToPSOptionsSpec
del objeto setPsLevel
método y pase un PSLevel
valor de enumeración que especifica el nivel PostScript. Para obtener información acerca de todos los valores en tiempo de ejecución que puede establecer, vea la ToPSOptionsSpec
referencia de clase en Referencia de API de AEM Forms.Convierta el documento de PDF en un archivo PostScript.
Invoque el ConvertPdfServiceClient
del objeto toPS2
y pasar los siguientes valores:
com.adobe.idp.Document
que representa el documento de PDF que se va a convertir en un archivo PostScript.ToPSOptionsSpec
que especifica las opciones de tiempo de ejecución de PostScript.El toPS2
El método devuelve un valor Document
que contiene el nuevo documento PostScript.
Guarde el archivo PostScript.
java.io.File
y asegúrese de que la extensión del nombre de archivo es .ps.Document
del objeto copyToFile
para copiar el contenido del Document
al archivo (asegúrese de utilizar la variable Document
objeto que ha devuelto el toPS2
método).Consulte también
Inicio rápido (modo SOAP): Conversión de un documento de PDF a PostScript mediante la API de Java
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Conversión de un documento de PDF a PostScript mediante la API del servicio ConvertPDF (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL: http://localhost:8080/soap/services/ConvertPDFService?WSDL&lc_version=9.0.1
.
Reemplazar localhost
con la dirección IP del servidor que aloja AEM Forms.
Cree un cliente PDF de conversión.
Crear un ConvertPdfServiceClient
mediante su constructor predeterminado.
Crear un ConvertPdfServiceClient.Endpoint.Address
mediante el uso del objeto System.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/ConvertPDFService?blob=mtom
.) No es necesario que utilice el lc_version
atributo. Sin embargo, especifique ?blob=mtom
.
Crear un System.ServiceModel.BasicHttpBinding
al obtener el valor de la variable ConvertPdfServiceClient.Endpoint.Binding
field. Convierta el valor devuelto en BasicHttpBinding
.
Configure las variables System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
field a WSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
ConvertPdfServiceClient.ClientCredentials.UserName.UserName
.ConvertPdfServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Hacer referencia al documento de PDF para convertirlo en un archivo PostScript.
BLOB
mediante su constructor. El BLOB
se utiliza para almacenar un documento de PDF que se convierte en un archivo PostScript.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo del documento de PDF que se va a convertir y el modo en que se va a abrir el archivo.System.IO.FileStream
objeto. Puede determinar el tamaño de la matriz de bytes obteniendo el System.IO.FileStream
del objeto Length
propiedad.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición inicial y la longitud de secuencia para que se lean.BLOB
al asignar su MTOM
con el contenido de la matriz de bytes.Establecer las opciones de tiempo de ejecución de conversión.
ToPSOptionsSpec
invocando su constructor.ToPSOptionsSpec
miembro de datos del objeto. Por ejemplo, para definir el nivel de PostScript que se crea, asigne un PSLevel
valor de enumeración para ToPSOptionsSpec
del objeto psLevel
miembro de datos.Convierta el documento de PDF en un archivo PostScript.
Invoque el GeneratePDFServiceService
del objeto toPS2
y pasar los siguientes valores:
BLOB
que representa el documento de PDF para convertirlo en un archivo PostScriptToPSOptionsSpec
objeto que especifica opciones en tiempo de ejecuciónUna vez completada la conversión, extraiga los datos binarios que representan el documento PostScript accediendo a su BLOB
del objeto MTOM
propiedad. Devuelve una matriz de bytes que se puede escribir en un archivo PostScript.
Guarde el archivo PostScript.
System.IO.FileStream
invocando su constructor. Pase un valor de cadena que represente la ubicación del archivo PS.BLOB
objeto que ha devuelto el encryptPDFUsingPassword
método. Rellene la matriz de bytes obteniendo el valor de BLOB
del objeto MTOM
field.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
objeto.System.IO.BinaryWriter
del objeto Write
y pasando la matriz de bytes.Consulte también
Invocar AEM Forms mediante MTOM
Invocar AEM Forms mediante SwaRef
Puede utilizar el servicio PDF de conversión para convertir mediante programación documentos de PDF a formatos de imagen, que incluyen JPEG, JPEG 2000, TIFF y PNG. Al convertir un documento de PDF en un archivo de imagen, puede utilizar el documento de PDF como archivo de imagen. Por ejemplo, puede colocar la imagen en un sistema de administración de contenido empresarial para su almacenamiento.
Al convertir un documento de PDF en una imagen, el servicio ConvertPDF crea una imagen independiente para cada página del documento. Es decir, si el documento tiene 20 páginas, el servicio ConvertPDF crea 20 archivos de imagen. Al convertir un documento de PDF a un formato de imagen, puede crear imágenes individuales para cada página dentro del documento de PDF o un solo archivo de imagen para todo el documento de PDF.
Para obtener más información sobre el servicio ConvertPDF, consulte Referencia de servicios para AEM Forms.
Para convertir un documento de PDF en cualquiera de los tipos compatibles, realice los siguientes pasos:
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.
Creación de un cliente PDF de conversión
Para poder realizar mediante programación una operación de servicio ConvertPDF, debe crear un cliente de servicio ConvertPDF. Si utiliza la API de Java, cree un ConvertPdfServiceClient
objeto. Si utiliza la API del servicio web, cree un ConvertPDFServiceService
objeto.
Recuperar el documento del PDF para convertirlo
Debe recuperar el documento del PDF para convertirlo en una imagen. No se puede convertir un documento interactivo de PDF en una imagen. Si intenta hacerlo, se produce una excepción. Para convertir un documento de PDF interactivo en un archivo de imagen, debe acoplar el documento de PDF antes de convertirlo. (Consulte Acoplar documentos de PDF.)
Establecer opciones en tiempo de ejecución
Debe establecer opciones en tiempo de ejecución como el formato de imagen y los valores de resolución. Para obtener información sobre los valores en tiempo de ejecución, vea la ToImageOptionsSpec
referencia de clase en Referencia de API de AEM Forms.
Conversión del PDF en imagen
Después de crear el cliente de servicios y establecer las opciones en tiempo de ejecución, puede convertir el documento de PDF en una imagen. Se devuelve un objeto de colección que contiene las imágenes.
Recuperar los archivos de imagen de una colección
Puede recuperar archivos de imagen de un objeto de colección devuelto por el servicio Convert PDF. Cada elemento de la colección es un com.adobe.idp.Document
instancia de (o un BLOB
ejemplo, si utiliza servicios web) que puede guardar como archivo de imagen, como un archivo de JPG.
El formato del archivo de imagen depende de la variable ImageConvertFormat
en tiempo de ejecución. Es decir, si establece la variable ImageConvertFormat
opción de tiempo de ejecución para ImageConvertFormat.JPEG
, puede guardar archivos de imagen como archivos de JPG.
Consulte también
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Inicios rápidos de la API de ConvertPDF Service
Conversión de un documento de PDF a un formato de imagen mediante la API del servicio ConvertPDF (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-convertpdf-client.jar, en la ruta de clase del proyecto Java.
Cree un cliente PDF de conversión.
ServiceClientFactory
que contiene las propiedades de conexión.ConvertPdfServiceClient
usando su constructor y pasando el objeto ServiceClientFactory
objeto.Recupere el documento del PDF que desea convertir.
java.io.FileInputStream
que representa el documento de PDF que se va a convertir utilizando su constructor y pasando un valor de cadena que especifica la ubicación del documento de PDF.com.adobe.idp.Document
usando su constructor y pasando el objeto java.io.FileInputStream
objeto.Establecer opciones en tiempo de ejecución.
ToImageOptionsSpec
mediante su constructor.setImageConvertFormat
método y pasar un ImageConvertFormat
valor de enumeración que especifica el tipo de formato.Configuración de la ImageConvertFormat
el valor de enumeración es obligatorio.
Convierta el PDF en una imagen.
Invoque el ConvertPdfServiceClient
del objeto toImage2
y pasar los siguientes valores:
com.adobe.idp.Document
que representa el archivo PDF que se va a convertir.com.adobe.livecycle.converpdfservice.client.ToImageOptionsSpec
que contiene las distintas preferencias sobre el formato de imagen de destino.El toImage2
El método devuelve un valor java.util.List
que contiene imágenes. Cada elemento de la colección es un com.adobe.idp.Document
ejemplo.
Recupere los archivos de imagen de una colección.
Itere a través de java.util.List
para determinar si las imágenes están presentes. Cada elemento es un com.adobe.idp.Document
ejemplo. Guarde la imagen invocando el com.adobe.idp.Document
del objeto copyToFile
método y pasar un java.io.File
objeto.
Consulte también
Conversión de un documento de PDF a un formato de imagen mediante la API del servicio ConvertPDF (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL: http://localhost:8080/soap/services/ConvertPDFService?WSDL&lc_version=9.0.1
.
Reemplazar localhost
con la dirección IP del servidor que aloja AEM Forms.
Cree un cliente PDF de conversión.
Crear un ConvertPdfServiceClient
mediante su constructor predeterminado.
Crear un ConvertPdfServiceClient.Endpoint.Address
mediante el uso del objeto System.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/ConvertPDFService?blob=mtom
.) No es necesario que utilice el lc_version
atributo. Sin embargo, especifique ?blob=mtom
.
Crear un System.ServiceModel.BasicHttpBinding
al obtener el valor de la variable ConvertPdfServiceClient.Endpoint.Binding
field. Convierta el valor devuelto en BasicHttpBinding
.
Configure las variables System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
field a WSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
ConvertPdfServiceClient.ClientCredentials.UserName.UserName
.ConvertPdfServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Recupere el documento del PDF que desea convertir.
BLOB
mediante su constructor. Esta BLOB
se utiliza para almacenar el formulario de PDF.System.IO.FileStream
invocando su constructor. Pase un valor de cadena que especifique la ubicación del formulario de PDF y el modo en que se abrirá el archivo.System.IO.FileStream
objeto. Determinar el tamaño de la matriz de bytes obteniendo System.IO.FileStream
del objeto Length
propiedad.System.IO.FileStream
del objeto Read
método. Pase a leer la matriz de bytes, la posición inicial y la longitud de la secuencia.BLOB
al asignar su MTOM
con el contenido de la matriz de bytes.Establecer opciones en tiempo de ejecución.
ToImageOptionsSpec
mediante su constructor.setImageConvertFormat
método y pasar un ImageConvertFormat
valor de enumeración que especifica el tipo de formato.Configuración de la ImageConvertFormat
el valor de enumeración es obligatorio.
Convierta el PDF en una imagen.
Invoque el ConvertPDFServiceService
del objeto toImage2
y pasar los siguientes valores:
BLOB
objeto que representa el archivo que se va a convertirToImageOptionsSpec
que contiene las distintas preferencias sobre el formato de imagen de destinoEl toImage2
El método devuelve un valor MyArrayOfBLOB
que contiene los archivos de imagen recién creados.
Recupere los archivos de imagen de una colección.
MyArrayOfBLOB
al obtener el valor de su Count
field. Cada elemento es un BLOB
que contiene la imagen.MyArrayOfBLOB
y guarde cada archivo de imagen.Consulte también
Invocar AEM Forms mediante MTOM
Invocar AEM Forms mediante SwaRef