Acerca del servicio Convertir PDF
El servicio Convertir PDF convierte los documentos PDF a PostScript y a varios 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 resulta práctico al archivar documentos en sistemas gestoras de contenido que no admiten documentos PDF.
Puede realizar estas tareas mediante el servicio Convertir PDF:
Para obtener más información sobre el servicio Convertir PDF, consulte Referencia de servicios para AEM Forms.
En este tema se describe cómo puede utilizar la API de conversión de servicio PDF (Java y servicio web) para convertir documentos PDF en archivos PostScript mediante programación. El documento PDF que se convierte en un archivo PostScript debe ser un documento 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 Convertir PDF, consulte Referencia de servicios para AEM Forms.
Para convertir un documento PDF en un archivo PostScript, lleve a cabo los siguientes pasos:
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, asegúrese de incluir los archivos proxy.
Crear un cliente Convertir PDF
Para poder realizar mediante programación una operación de servicio Convertir PDF, debe crear un cliente de servicio Convertir PDF. Si utiliza la API de Java, cree un objeto ConvertPdfServiceClient
. Si utiliza la API de servicio Web, cree un objeto ConvertPDFServiceService
.
Esta sección utiliza la funcionalidad de servicio Web que se incorpora en AEM Forms. Para acceder a la nueva funcionalidad, debe construir el objeto proxy utilizando el atributo lc_version
. (Consulte "Acceso a la nueva funcionalidad mediante servicios Web" en Invocación de AEM Forms mediante servicios Web.)
Hacer referencia al documento PDF para convertirlo en un archivo PostScript
Haga referencia al documento PDF que desea convertir en un archivo PostScript. Como se ha indicado anteriormente en este tema, el documento PDF debe ser un documento PDF no interactivo. Si intenta convertir un documento PDF interactivo en un archivo PostScript, se genera una excepción.
Establecer las opciones de tiempo de ejecución de conversión
Al convertir un documento PDF a un archivo PostScript, puede definir opciones de tiempo de ejecución que especifican el tipo de 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 PDF de entrada. Si selecciona la opción ShrinkToFit
(que reduce la salida del archivo PostScript para que se ajuste a la página), no verá ninguna diferencia entre el documento PDF de entrada y el archivo PostScript generado. La opción ShrinkToFit
solo se aplica si selecciona imprimir en un tamaño de página menor que el documento PDF de entrada. Para seleccionar un tamaño de página más pequeño, defina la opción PageSize
. Además, se recomienda configurar la opción RotateAndCenter
en true
para obtener la salida PostScript correcta.
Del mismo modo, si selecciona la opción ExpandToFit
(que expande la salida del archivo PostScript para que se ajuste a la página), solo surtirá efecto si selecciona imprimir en un tamaño de página mayor que el documento PDF de entrada. Para seleccionar un tamaño de página mayor, defina la opción PageSize
. Además, se recomienda configurar la opción RotateAndCenter
en true
para obtener la salida PostScript correcta.
Para obtener información sobre los valores en tiempo de ejecución que puede establecer, consulte la referencia de clase ToPSOptionsSpec
en Referencia de API de AEM Forms.
Convertir el documento PDF en un archivo PostScript
Después de crear el cliente de servicio y establecer las opciones de 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 destinatario.
Guardar el archivo PostScript
Después de convertir el documento PDF a PostScript, puede guardar la salida como un archivo PostScript.
Consulte también
Conversión de un documento PDF a PS mediante la API de Java
Convertir un documento PDF a PS mediante la API de servicio web
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Convertir Inicios rápidos de API de servicio PDF
Convertir un documento PDF a PostScript mediante la API de servicio Convertir PDF (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-convertpdf-client.jar, en la ruta de clases del proyecto Java.
Cree un cliente Convertir PDF.
ServiceClientFactory
que contenga propiedades de conexión.ConvertPdfServiceClient
utilizando su constructor y pasando el objeto ServiceClientFactory
.Haga referencia al documento PDF para convertirlo en un archivo PostScript.
java.io.FileInputStream
utilizando su constructor y pase un valor de cadena que especifique la ubicación del documento PDF que se va a convertir.com.adobe.idp.Document
que almacene el documento PDF mediante el constructor com.adobe.idp.Document
. Pase el objeto java.io.FileInputStream
que contiene el documento PDF.Configure las opciones de tiempo de ejecución de conversión.
ToPSOptionsSpec
invocando su constructor.ToPSOptionsSpec
. Por ejemplo, para definir el nivel PostScript que se crea, invoque el método ToPSOptionsSpec
del objeto setPsLevel
y pase un valor de lista desglosada PSLevel
que especifique el nivel PostScript. Para obtener información sobre todos los valores en tiempo de ejecución que puede establecer, consulte la referencia de clase ToPSOptionsSpec
en Referencia de API de AEM Forms.Convierta el documento PDF en un archivo PostScript.
Invoque el método ConvertPdfServiceClient
del objeto toPS2
y pase los siguientes valores:
com.adobe.idp.Document
que representa el documento PDF que se va a convertir en un archivo PostScript.ToPSOptionsSpec
que especifica las opciones de tiempo de ejecución de PostScript.El método toPS2
devuelve un objeto 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 sea .ps.Document
del objeto copyToFile
para copiar el contenido del objeto Document
en el archivo (asegúrese de utilizar el objeto Document
devuelto por el método toPS2
).Consulte también
Inicio rápido (modo SOAP): Conversión de un documento PDF a PostScript mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Convertir un documento PDF a PostScript mediante la API de servicio Convertir PDF (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL: http://localhost:8080/soap/services/ConvertPDFService?WSDL&lc_version=9.0.1
.
Reemplace localhost
por la dirección IP del servidor que aloja AEM Forms.
Cree un cliente Convertir PDF.
Cree un objeto ConvertPdfServiceClient
utilizando su constructor predeterminado.
Cree un objeto ConvertPdfServiceClient.Endpoint.Address
mediante el constructor System.ServiceModel.EndpointAddress
. 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 usar el atributo lc_version
. Sin embargo, especifique ?blob=mtom
.
Cree un objeto System.ServiceModel.BasicHttpBinding
obteniendo el valor del campo ConvertPdfServiceClient.Endpoint.Binding
. Convierta el valor devuelto a BasicHttpBinding
.
Establezca el campo System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
en WSMessageEncoding.Mtom
. Este valor garantiza que se utilice 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
.Haga referencia al documento PDF para convertirlo en un archivo PostScript.
BLOB
utilizando su constructor. El objeto BLOB
se utiliza para almacenar un documento PDF que se convierte en un archivo PostScript.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF que se va a convertir y el modo en el que se va a abrir el archivo.System.IO.FileStream
. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedad System.IO.FileStream
del objeto Length
.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición inicial y la longitud de flujo para leerlos.BLOB
asignando su campo MTOM
con el contenido de la matriz de bytes.Configure las opciones de tiempo de ejecución de conversión.
ToPSOptionsSpec
invocando su constructor.ToPSOptionsSpec
. Por ejemplo, para definir el nivel PostScript que se crea, asigne un valor de lista desglosada PSLevel
al miembro de datos ToPSOptionsSpec
del objeto psLevel
.Convierta el documento PDF en un archivo PostScript.
Invoque el método GeneratePDFServiceService
del objeto toPS2
y pase los siguientes valores:
BLOB
que representa el documento PDF que se va a convertir en un archivo PostScriptToPSOptionsSpec
que especifica opciones de tiempo de ejecuciónUna vez finalizada la conversión, extraiga los datos binarios que representan el documento PostScript accediendo a la propiedad BLOB
del objeto MTOM
. Esto devuelve una matriz de bytes que 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
devuelto por el método encryptPDFUsingPassword
. Rellene la matriz de bytes obteniendo el valor del campo BLOB
del objeto MTOM
.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
.System.IO.BinaryWriter
del objeto Write
y pasando la matriz de bytes.Consulte también
Invocación de AEM Forms mediante MTOM
Invocación de AEM Forms mediante SwaRef
Puede utilizar el servicio Convertir PDF para convertir documentos PDF en formatos de imagen mediante programación, como JPEG, JPEG 2000, TIFF y PNG. Al convertir un documento PDF en un archivo de imagen, puede utilizar el documento PDF como archivo de imagen. Por ejemplo, puede colocar la imagen en un sistema de gestor de contenido empresarial para almacenamiento.
Al convertir un documento PDF en una imagen, el servicio Convertir PDF crea una imagen independiente para cada página del documento. Es decir, si el documento tiene 20 páginas, el servicio Convertir PDF crea 20 archivos de imagen. Al convertir un documento PDF a un formato de imagen, puede crear imágenes individuales para cada página dentro del documento PDF o un solo archivo de imagen para todo el documento PDF.
Para obtener más información sobre el servicio Convertir PDF, consulte Referencia de servicios para AEM Forms.
Para convertir un documento PDF a cualquiera de los tipos admitidos, lleve a cabo los siguientes pasos:
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, asegúrese de incluir los archivos proxy.
Crear un cliente Convertir PDF
Para poder realizar mediante programación una operación de servicio Convertir PDF, debe crear un cliente de servicio Convertir PDF. Si utiliza la API de Java, cree un objeto ConvertPdfServiceClient
. Si utiliza la API de servicio Web, cree un objeto ConvertPDFServiceService
.
Recuperar el documento PDF para convertir
Debe recuperar el documento PDF para convertir en una imagen. No se puede convertir un documento PDF interactivo en una imagen. Si intenta hacerlo, se genera una excepción. Para convertir un documento PDF interactivo en un archivo de imagen, debe acoplar el documento PDF antes de convertirlo. (Consulte Acoplamiento de Documentos PDF).
Definición de opciones de tiempo de ejecución
Debe definir opciones de 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, consulte la referencia de clase ToImageOptionsSpec
en Referencia de API de AEM Forms.
Convertir el PDF en una imagen
Después de crear el cliente de servicio y definir las opciones de tiempo de ejecución, puede convertir el documento 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 que devuelve el servicio Convertir PDF. Cada elemento de la colección es una instancia com.adobe.idp.Document
(o una instancia BLOB
si utiliza servicios Web) que puede guardar como archivo de imagen, como un archivo JPG.
El formato del archivo de imagen depende de la opción ImageConvertFormat
tiempo de ejecución. Es decir, si establece la opción ImageConvertFormat
tiempo de ejecución en ImageConvertFormat.JPEG
, puede guardar los archivos de imagen como archivos JPG.
Consulte también
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Convertir Inicios rápidos de API de servicio PDF
Convertir un documento PDF a un formato de imagen mediante la API de servicio Convertir PDF (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-convertpdf-client.jar, en la ruta de clases del proyecto Java.
Cree un cliente Convertir PDF.
ServiceClientFactory
que contenga propiedades de conexión.ConvertPdfServiceClient
utilizando su constructor y pasando el objeto ServiceClientFactory
.Recupere el documento PDF que desea convertir.
java.io.FileInputStream
que represente el documento PDF que se va a convertir utilizando su constructor y pasando un valor de cadena que especifique la ubicación del documento PDF.com.adobe.idp.Document
utilizando su constructor y pasando el objeto java.io.FileInputStream
.Configure las opciones de tiempo de ejecución.
ToImageOptionsSpec
utilizando su constructor.setImageConvertFormat
y pasando un valor de enumeración ImageConvertFormat
que especifique el tipo de formato.La configuración del valor de lista desglosada ImageConvertFormat
es obligatoria.
Convierta el PDF en una imagen.
Invoque el método ConvertPdfServiceClient
del objeto toImage2
y pase 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 destinatario.El método toImage2
devuelve un objeto java.util.List
que contiene imágenes. Cada elemento de la colección es una instancia com.adobe.idp.Document
.
Recupere los archivos de imagen de una colección.
Repita el objeto java.util.List
para determinar si las imágenes están presentes. Cada elemento es una instancia com.adobe.idp.Document
. Guarde la imagen invocando el método com.adobe.idp.Document
del objeto copyToFile
y pasando un objeto java.io.File
.
Consulte también
Inicio rápido (modo SOAP): Conversión de un documento PDF a archivos JPEG mediante la API de Java
Convertir un documento PDF a un formato de imagen mediante la API de Convertir servicio PDF (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL: http://localhost:8080/soap/services/ConvertPDFService?WSDL&lc_version=9.0.1
.
Reemplace localhost
por la dirección IP del servidor que aloja AEM Forms.
Cree un cliente PDF de conversión.
Cree un objeto ConvertPdfServiceClient
utilizando su constructor predeterminado.
Cree un objeto ConvertPdfServiceClient.Endpoint.Address
mediante el constructor System.ServiceModel.EndpointAddress
. 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 usar el atributo lc_version
. Sin embargo, especifique ?blob=mtom
.
Cree un objeto System.ServiceModel.BasicHttpBinding
obteniendo el valor del campo ConvertPdfServiceClient.Endpoint.Binding
. Convierta el valor devuelto a BasicHttpBinding
.
Establezca el campo System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
en WSMessageEncoding.Mtom
. Este valor garantiza que se utilice 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 PDF que desea convertir.
BLOB
utilizando su constructor. Este objeto BLOB
se utiliza para almacenar el formulario PDF.System.IO.FileStream
invocando su constructor. Pase un valor de cadena que especifique la ubicación del formulario PDF y el modo en el que se abrirá el archivo.System.IO.FileStream
. Determine el tamaño de la matriz de bytes obteniendo la propiedad System.IO.FileStream
del objeto Length
.System.IO.FileStream
del objeto Read
. Pase la matriz de bytes, la posición inicial y la longitud del flujo para leerlos.BLOB
asignando su campo MTOM
con el contenido de la matriz de bytes.Configure las opciones de tiempo de ejecución.
ToImageOptionsSpec
utilizando su constructor.setImageConvertFormat
y pasando un valor de lista desglosada ImageConvertFormat
que especifique el tipo de formato.La configuración del valor de lista desglosada ImageConvertFormat
es obligatoria.
Convierta el PDF en una imagen.
Invoque el método ConvertPDFServiceService
del objeto toImage2
y pase los siguientes valores:
BLOB
que representa el archivo que se va a convertirToImageOptionsSpec
que contiene las distintas preferencias sobre el formato de imagen de destinatarioEl método toImage2
devuelve un objeto MyArrayOfBLOB
que contiene los archivos de imagen recién creados.
Recupere los archivos de imagen de una colección.
MyArrayOfBLOB
obteniendo el valor de su campo Count
. Cada elemento es un objeto BLOB
que contiene la imagen.MyArrayOfBLOB
y guarde cada archivo de imagen.Consulte también