Conversión del PDF a archivos Postscript y de imagen converting-pdf-to-postscript-andimage-files
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 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 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:
- Convertir documentos PDF a PostScript.
- Convierta documentos de PDF a formatos de imagen.
Convertir documentos de PDF a PostScript converting-pdf-documents-to-postscript
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.
Resumen de los pasos summary-of-steps
Para convertir un documento de PDF en un archivo PostScript, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un cliente de servicio del PDF Convert.
- Hacer referencia al documento de PDF para convertirlo en un archivo PostScript.
- Establecer las opciones de tiempo de ejecución de conversión.
- Convierta el documento de PDF en un archivo PostScript.
- Guarde el archivo PostScript.
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.
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 en PS mediante la API de Java convert-a-pdf-document-to-ps-using-the-java-api
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.
- Crear un
ServiceClientFactory
que contiene las propiedades de conexión. - Crear un
ConvertPdfServiceClient
usando su constructor y pasando el objetoServiceClientFactory
objeto.
- Crear un
-
Hacer referencia al documento de PDF para convertirlo en un archivo PostScript.
- Crear un
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. - Crear un
com.adobe.idp.Document
que almacena el documento de PDF utilizando el objetocom.adobe.idp.Document
constructor. Pase eljava.io.FileInputStream
que contiene el documento de PDF.
- Crear un
-
Establecer las opciones de tiempo de ejecución de conversión.
- Crear un
ToPSOptionsSpec
invocando su constructor. - Establezca las opciones en tiempo de ejecución invocando un método apropiado que pertenezca a la variable
ToPSOptionsSpec
objeto. Por ejemplo, para definir el nivel de PostScript que se crea, invoque elToPSOptionsSpec
del objetosetPsLevel
método y pase unPSLevel
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 laToPSOptionsSpec
referencia de clase en Referencia de API de AEM Forms.
- Crear un
-
Convierta el documento de PDF en un archivo PostScript.
Invoque el
ConvertPdfServiceClient
del objetotoPS2
y pasar los siguientes valores:- A
com.adobe.idp.Document
que representa el documento de PDF que se va a convertir en un archivo PostScript. - A
ToPSOptionsSpec
que especifica las opciones de tiempo de ejecución de PostScript.
El
toPS2
El método devuelve un valorDocument
que contiene el nuevo documento PostScript. - A
-
Guarde el archivo PostScript.
- Crear un
java.io.File
y asegúrese de que la extensión del nombre de archivo es .ps. - Invoque el
Document
del objetocopyToFile
para copiar el contenido delDocument
al archivo (asegúrese de utilizar la variableDocument
objeto que ha devuelto eltoPS2
método).
- Crear un
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 en PS mediante la API de servicio web convert-a-pdf-document-to-ps-using-the-web-service-api
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
.note note NOTE 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 objetoSystem.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 ellc_version
atributo. Sin embargo, especifique?blob=mtom
. -
Crear un
System.ServiceModel.BasicHttpBinding
al obtener el valor de la variableConvertPdfServiceClient.Endpoint.Binding
field. Convierta el valor devuelto enBasicHttpBinding
. -
Configure las variables
System.ServiceModel.BasicHttpBinding
del objetoMessageEncoding
field aWSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- AEM Asigne el nombre de usuario del formulario de la al campo
ConvertPdfServiceClient.ClientCredentials.UserName.UserName
. - Asigne el valor de contraseña correspondiente al campo
ConvertPdfServiceClient.ClientCredentials.UserName.Password
. - Asignar el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Asignar el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
- AEM Asigne el nombre de usuario del formulario de la al campo
-
-
Hacer referencia al documento de PDF para convertirlo en un archivo PostScript.
- Crear un
BLOB
mediante su constructor. ElBLOB
se utiliza para almacenar un documento de PDF que se convierte en un archivo PostScript. - Crear un
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. - Cree una matriz de bytes que almacene el contenido del
System.IO.FileStream
objeto. Puede determinar el tamaño de la matriz de bytes obteniendo elSystem.IO.FileStream
del objetoLength
propiedad. - Rellene la matriz de bytes con datos de flujo invocando el método
System.IO.FileStream
del objetoRead
y pasando la matriz de bytes, la posición inicial y la longitud de secuencia para que se lean. - Rellene el
BLOB
al asignar suMTOM
con el contenido de la matriz de bytes.
- Crear un
-
Establecer las opciones de tiempo de ejecución de conversión.
- Crear un
ToPSOptionsSpec
invocando su constructor. - Establezca las opciones en tiempo de ejecución asignando un valor a
ToPSOptionsSpec
miembro de datos del objeto. Por ejemplo, para definir el nivel de PostScript que se crea, asigne unPSLevel
valor de enumeración paraToPSOptionsSpec
del objetopsLevel
miembro de datos.
- Crear un
-
Convierta el documento de PDF en un archivo PostScript.
Invoque el
GeneratePDFServiceService
del objetotoPS2
y pasar los siguientes valores:- A
BLOB
que representa el documento de PDF para convertirlo en un archivo PostScript - A
ToPSOptionsSpec
objeto que especifica opciones en tiempo de ejecución
Una vez completada la conversión, extraiga los datos binarios que representan el documento PostScript accediendo a su
BLOB
del objetoMTOM
propiedad. Devuelve una matriz de bytes que se puede escribir en un archivo PostScript. - A
-
Guarde el archivo PostScript.
- Crear un
System.IO.FileStream
invocando su constructor. Pase un valor de cadena que represente la ubicación del archivo PS. - Cree una matriz de bytes que almacene el contenido de datos del
BLOB
objeto que ha devuelto elencryptPDFUsingPassword
método. Rellene la matriz de bytes obteniendo el valor deBLOB
del objetoMTOM
field. - Crear un
System.IO.BinaryWriter
invocando su constructor y pasando el objetoSystem.IO.FileStream
objeto. - Escriba el contenido de la matriz de bytes en el archivo PostScript invocando el método
System.IO.BinaryWriter
del objetoWrite
y pasando la matriz de bytes.
- Crear un
Consulte también
Invocar AEM Forms mediante MTOM
Invocar AEM Forms mediante SwaRef
Conversión de documentos de PDF a formatos de imagen converting-pdf-documents-to-image-formats
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.
Resumen de los pasos summary_of_steps-1
Para convertir un documento de PDF en cualquiera de los tipos compatibles, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un cliente de servicio del PDF Convert.
- Recupere el documento del PDF que desea convertir.
- Establecer opciones en tiempo de ejecución.
- Convierta el PDF en una imagen.
- Recupere los archivos de imagen de una colección.
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
Recupere 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
Establezca 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 en archivos de imagen mediante la API de Java convert-a-pdf-document-to-image-files-using-the-java-api
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.
- Crear un
ServiceClientFactory
que contiene las propiedades de conexión. - Crear un
ConvertPdfServiceClient
usando su constructor y pasando el objetoServiceClientFactory
objeto.
- Crear un
-
Recupere el documento del PDF que desea convertir.
- Crear un
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. - Crear un
com.adobe.idp.Document
usando su constructor y pasando el objetojava.io.FileInputStream
objeto.
- Crear un
-
Establecer opciones en tiempo de ejecución.
- Crear un
ToImageOptionsSpec
mediante su constructor. - Invoque los métodos que pertenezcan a este objeto según sea necesario. Por ejemplo, establezca el tipo de imagen invocando el método
setImageConvertFormat
método y pasar unImageConvertFormat
valor de enumeración que especifica el tipo de formato.
note note NOTE Configuración de la ImageConvertFormat
el valor de enumeración es obligatorio. - Crear un
-
Convierta el PDF en una imagen.
Invoque el
ConvertPdfServiceClient
del objetotoImage2
y pasar los siguientes valores:- A
com.adobe.idp.Document
que representa el archivo PDF que se va a convertir. - A
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 valorjava.util.List
que contiene imágenes. Cada elemento de la colección es uncom.adobe.idp.Document
ejemplo. - A
-
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 uncom.adobe.idp.Document
ejemplo. Guarde la imagen invocando elcom.adobe.idp.Document
del objetocopyToFile
método y pasar unjava.io.File
objeto.
Consulte también
Conversión de un documento de PDF en archivos de imagen mediante la API de servicio web convert-a-pdf-document-to-image-files-using-the-web-service-api
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
.note note NOTE 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 objetoSystem.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 ellc_version
atributo. Sin embargo, especifique?blob=mtom
. -
Crear un
System.ServiceModel.BasicHttpBinding
al obtener el valor de la variableConvertPdfServiceClient.Endpoint.Binding
field. Convierta el valor devuelto enBasicHttpBinding
. -
Configure las variables
System.ServiceModel.BasicHttpBinding
del objetoMessageEncoding
field aWSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- AEM Asigne el nombre de usuario del formulario de la al campo
ConvertPdfServiceClient.ClientCredentials.UserName.UserName
. - Asigne el valor de contraseña correspondiente al campo
ConvertPdfServiceClient.ClientCredentials.UserName.Password
. - Asignar el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Asignar el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
- AEM Asigne el nombre de usuario del formulario de la al campo
-
-
Recupere el documento del PDF que desea convertir.
- Crear un
BLOB
mediante su constructor. EstaBLOB
se utiliza para almacenar el formulario de PDF. - Crear un
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. - Cree una matriz de bytes que almacene el contenido del
System.IO.FileStream
objeto. Determinar el tamaño de la matriz de bytes obteniendoSystem.IO.FileStream
del objetoLength
propiedad. - Rellene la matriz de bytes con datos de flujo invocando el método
System.IO.FileStream
del objetoRead
método. Pase a leer la matriz de bytes, la posición inicial y la longitud de la secuencia. - Rellene el
BLOB
al asignar suMTOM
con el contenido de la matriz de bytes.
- Crear un
-
Establecer opciones en tiempo de ejecución.
- Crear un
ToImageOptionsSpec
mediante su constructor. - Invoque los métodos que pertenezcan a este objeto según sea necesario. Por ejemplo, establezca el tipo de imagen invocando el método
setImageConvertFormat
método y pasar unImageConvertFormat
valor de enumeración que especifica el tipo de formato.
note note NOTE Configuración de la ImageConvertFormat
el valor de enumeración es obligatorio. - Crear un
-
Convierta el PDF en una imagen.
Invoque el
ConvertPDFServiceService
del objetotoImage2
y pasar los siguientes valores:- A
BLOB
objeto que representa el archivo que se va a convertir - A
ToImageOptionsSpec
que contiene las distintas preferencias sobre el formato de imagen de destino
El
toImage2
El método devuelve un valorMyArrayOfBLOB
que contiene los archivos de imagen recién creados. - A
-
Recupere los archivos de imagen de una colección.
- Determine el número de elementos en la
MyArrayOfBLOB
al obtener el valor de suCount
field. Cada elemento es unBLOB
que contiene la imagen. - Itere a través de
MyArrayOfBLOB
y guarde cada archivo de imagen.
- Determine el número de elementos en la
Consulte también
Invocar AEM Forms mediante MTOM
Invocar AEM Forms mediante SwaRef