Conversión de archivos PDF a archivos de imagen y postscript

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:

  • Convertir documentos PDF a PostScript.
  • Convertir documentos PDF a formatos de imagen.
NOTA

Para obtener más información sobre el servicio Convertir PDF, consulte Referencia de servicios para AEM Forms.

Conversión de Documentos PDF a PostScript

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.

NOTA

Para obtener más información sobre el servicio Convertir PDF, consulte Referencia de servicios para AEM Forms.

Resumen de los pasos

Para convertir un documento PDF en un archivo PostScript, lleve a cabo los siguientes pasos:

  1. Incluir archivos de proyecto.
  2. Cree un cliente de servicio Convertir PDF.
  3. Haga referencia al documento PDF para convertirlo en un archivo PostScript.
  4. Configure las opciones de tiempo de ejecución de conversión.
  5. Convierta el documento PDF en un archivo PostScript.
  6. Guarde el archivo PostScript.

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.

NOTA

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 PS mediante la API de Java

Convertir un documento PDF a PostScript mediante la API de servicio Convertir PDF (Java):

  1. Incluir archivos de proyecto.

    Incluya archivos JAR de cliente, como adobe-convertpdf-client.jar, en la ruta de clases del proyecto Java.

  2. Cree un cliente Convertir PDF.

    • Cree un objeto ServiceClientFactory que contenga propiedades de conexión.
    • Cree un objeto ConvertPdfServiceClient utilizando su constructor y pasando el objeto ServiceClientFactory.

  3. Haga referencia al documento PDF para convertirlo en un archivo PostScript.

    • Cree un objeto 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.
    • Cree un objeto 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.

  4. Configure las opciones de tiempo de ejecución de conversión.

    • Cree un objeto ToPSOptionsSpec invocando su constructor.
    • Configure las opciones de tiempo de ejecución invocando un método adecuado que pertenece al objeto 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.

  5. Convierta el documento PDF en un archivo PostScript.

    Invoque el método ConvertPdfServiceClientdel objeto toPS2 y pase los siguientes valores:

    • Un objeto com.adobe.idp.Document que representa el documento PDF que se va a convertir en un archivo PostScript.
    • Un objeto 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.

  6. Guarde el archivo PostScript.

    • Cree un objeto java.io.File y asegúrese de que la extensión del nombre de archivo sea .ps.
    • Invoque el método 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

Resumen de los pasos

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 PS mediante la API de servicio Web

Convertir un documento PDF a PostScript mediante la API de servicio Convertir PDF (servicio web):

  1. 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.

    NOTA

    Reemplace localhost por la dirección IP del servidor que aloja AEM Forms.

  2. 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:

      • Asigne el nombre de usuario de los formularios AEM al campo ConvertPdfServiceClient.ClientCredentials.UserName.UserName.
      • Asigne el valor de contraseña correspondiente al campo ConvertPdfServiceClient.ClientCredentials.UserName.Password.
      • Asigne el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

  3. Haga referencia al documento PDF para convertirlo en un archivo PostScript.

    • Cree un objeto BLOB utilizando su constructor. El objeto BLOB se utiliza para almacenar un documento PDF que se convierte en un archivo PostScript.
    • Cree un objeto 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.
    • 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 propiedad System.IO.FileStream del objeto Length.
    • Rellene la matriz de bytes con datos de flujo invocando el método System.IO.FileStream del objeto Read y pasando la matriz de bytes, la posición inicial y la longitud de flujo para leerlos.
    • Rellene el objeto BLOB asignando su campo MTOM con el contenido de la matriz de bytes.

  4. Configure las opciones de tiempo de ejecución de conversión.

    • Cree un objeto ToPSOptionsSpec invocando su constructor.
    • Configure las opciones de tiempo de ejecución asignando un valor al miembro de datos del objeto 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.

  5. Convierta el documento PDF en un archivo PostScript.

    Invoque el método GeneratePDFServiceService del objeto toPS2 y pase los siguientes valores:

    • Un objeto BLOB que representa el documento PDF que se va a convertir en un archivo PostScript
    • Un objeto ToPSOptionsSpec que especifica opciones de tiempo de ejecución

    Una 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.

  6. Guarde el archivo PostScript.

    • Cree un objeto 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 objeto BLOB devuelto por el método encryptPDFUsingPassword. Rellene la matriz de bytes obteniendo el valor del campo BLOB del objeto MTOM.
    • Cree un objeto System.IO.BinaryWriter invocando su constructor y pasando el objeto System.IO.FileStream.
    • Escriba el contenido de la matriz de bytes en el archivo PostScript invocando el método System.IO.BinaryWriter del objeto Write y pasando la matriz de bytes.

Consulte también

Resumen de los pasos

Invocación de AEM Forms mediante MTOM

Invocación de AEM Forms mediante SwaRef

Conversión de Documentos PDF a formatos de imagen

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.

NOTA

Para obtener más información sobre el servicio Convertir PDF, consulte Referencia de servicios para AEM Forms.

Resumen de los pasos

Para convertir un documento PDF a cualquiera de los tipos admitidos, lleve a cabo los siguientes pasos:

  1. Incluir archivos de proyecto.
  2. Cree un cliente de servicio Convertir PDF.
  3. Recupere el documento PDF que desea convertir.
  4. Configure las opciones de tiempo de ejecución.
  5. Convierta el PDF en una imagen.
  6. Recupere los archivos de imagen de una colección.

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

Conversión de un documento PDF en archivos de imagen mediante la API de Java

Convertir un documento PDF a un formato de imagen mediante la API de servicio Convertir PDF (Java):

  1. Incluir archivos de proyecto.

    Incluya archivos JAR de cliente, como adobe-convertpdf-client.jar, en la ruta de clases del proyecto Java.

  2. Cree un cliente Convertir PDF.

    • Cree un objeto ServiceClientFactory que contenga propiedades de conexión.
    • Cree un objeto ConvertPdfServiceClient utilizando su constructor y pasando el objeto ServiceClientFactory.

  3. Recupere el documento PDF que desea convertir.

    • Cree un objeto 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.
    • Cree un objeto com.adobe.idp.Document utilizando su constructor y pasando el objeto java.io.FileInputStream.

  4. Configure las opciones de tiempo de ejecución.

    • Cree un objeto ToImageOptionsSpec utilizando su constructor.
    • Invocar los métodos que pertenecen a este objeto según sea necesario. Por ejemplo, establezca el tipo de imagen invocando el método setImageConvertFormat y pasando un valor de enumeración ImageConvertFormat que especifique el tipo de formato.
    NOTA

    La configuración del valor de lista desglosada ImageConvertFormat es obligatoria.

  5. Convierta el PDF en una imagen.

    Invoque el método ConvertPdfServiceClient del objeto toImage2 y pase los siguientes valores:

    • Un objeto com.adobe.idp.Document que representa el archivo PDF que se va a convertir.
    • Un objeto 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.

  6. 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 en archivos de imagen mediante la API de servicio Web

Convertir un documento PDF a un formato de imagen mediante la API de Convertir servicio PDF (servicio web):

  1. 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.

    NOTA

    Reemplace localhost por la dirección IP del servidor que aloja AEM Forms.

  2. 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:

      • Asigne el nombre de usuario de los formularios AEM al campo ConvertPdfServiceClient.ClientCredentials.UserName.UserName.
      • Asigne el valor de contraseña correspondiente al campo ConvertPdfServiceClient.ClientCredentials.UserName.Password.
      • Asigne el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

  3. Recupere el documento PDF que desea convertir.

    • Cree un objeto BLOB utilizando su constructor. Este objeto BLOB se utiliza para almacenar el formulario PDF.
    • Cree un objeto 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.
    • Cree una matriz de bytes que almacene el contenido del objeto System.IO.FileStream. Determine el tamaño de la matriz de bytes obteniendo la propiedad System.IO.FileStream del objeto Length.
    • Rellene la matriz de bytes con datos de flujo invocando el método System.IO.FileStream del objeto Read. Pase la matriz de bytes, la posición inicial y la longitud del flujo para leerlos.
    • Rellene el objeto BLOB asignando su campo MTOM con el contenido de la matriz de bytes.

  4. Configure las opciones de tiempo de ejecución.

    • Cree un objeto ToImageOptionsSpec utilizando su constructor.
    • Invocar los métodos que pertenecen a este objeto según sea necesario. Por ejemplo, establezca el tipo de imagen invocando el método setImageConvertFormat y pasando un valor de lista desglosada ImageConvertFormat que especifique el tipo de formato.
    NOTA

    La configuración del valor de lista desglosada ImageConvertFormat es obligatoria.

  5. Convierta el PDF en una imagen.

    Invoque el método ConvertPDFServiceService del objeto toImage2 y pase los siguientes valores:

    • Un objeto BLOB que representa el archivo que se va a convertir
    • Un objeto ToImageOptionsSpec que contiene las distintas preferencias sobre el formato de imagen de destinatario

    El método toImage2 devuelve un objeto MyArrayOfBLOB que contiene los archivos de imagen recién creados.

  6. Recupere los archivos de imagen de una colección.

    • Determine el número de elementos en el objeto MyArrayOfBLOB obteniendo el valor de su campo Count. Cada elemento es un objeto BLOB que contiene la imagen.
    • Repita el objeto MyArrayOfBLOB y guarde cada archivo de imagen.

Consulte también

Invocación de AEM Forms mediante MTOM

Invocación de AEM Forms mediante SwaRef

En esta página