Conversión de Postscript a documentos de PDF

Los ejemplos y ejemplos de este documento son solo para AEM Forms en un entorno JEE.

Acerca del servicio Distiller

El servicio Distiller® convierte archivos de PostScript®, PostScript encapsulado (EPS) y PRN en archivos PDF compactos, confiables y más seguros a través de una red. El servicio Distiller se utiliza con frecuencia para convertir grandes volúmenes de documentos impresos en documentos electrónicos, como facturas y estados de cuentas. La conversión de documentos a PDF también permite a las empresas enviar a sus clientes una versión en papel y una versión electrónica de un documento.

NOTA

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

Conversión de PostScript en documentos de PDF

En este tema se describe cómo puede utilizar la API de servicio de Distiller (Java y servicio web) para convertir mediante programación archivos PostScript (PS), PostScript encapsulado (EPS) y PRN a documentos de PDF.

NOTA

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

NOTA

Para convertir archivos PostScript en documentos de PDF, se debe instalar una de las siguientes opciones en el servidor que aloje AEM Forms: Paquete redistribuible de Acrobat 9 o Microsoft Visual C++ 2005.

Resumen de los pasos

Para convertir cualquiera de los tipos admitidos en un documento de PDF, realice los siguientes pasos:

  1. Incluir archivos de proyecto.
  2. Cree un cliente de servicio de Distiller.
  3. Recupere el archivo que desea convertir.
  4. Invoque la operación de creación del PDF.
  5. Guarde el documento del PDF.

Incluir archivos de proyecto

Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.

Creación de un cliente de servicio de Distiller

Para poder realizar una operación de servicio de Distiller mediante programación, debe crear un cliente de servicio de Distiller. Si utiliza la API de Java, cree un DistillerServiceClient objeto. Si utiliza la API de servicio web, cree un DistillerServiceService objeto.

Recupere el archivo que desea convertir

Debe recuperar el archivo que desea convertir. Por ejemplo, para convertir un archivo PS en un documento PDF, debe recuperar el archivo PS.

Invocar la operación de creación del PDF

Después de crear el cliente de servicio, puede invocar la operación de creación del PDF. Esta operación necesitará información sobre el documento que se va a convertir, incluida la ruta al documento de destino.

Guardar el documento del PDF

Puede guardar el documento del PDF como un archivo del PDF.

Consulte también lo siguiente

Convertir un archivo PostScript a PDF mediante la API de Java

Conversión de un archivo PostScript a PDF mediante la API de servicio web

Inclusión de archivos de biblioteca Java de AEM Forms

Configuración de las propiedades de conexión

Inicio rápido de la API del servicio de salida

Convertir un archivo PostScript a PDF mediante la API de Java

Convierta un archivo PostScript a un documento de PDF mediante la API de servicio de Distiller (Java):

  1. Incluir archivos de proyecto.

    Incluya archivos JAR del cliente, como adobe-distiller-client.jar, en la ruta de clase de su proyecto Java.

  2. Cree un cliente de servicio de Distiller.

    • Cree un ServiceClientFactory objeto que contiene propiedades de conexión.
    • Cree un DistillerServiceClient usando su constructor y pasando el ServiceClientFactory objeto.
  3. Recupere el archivo que desea convertir.

    • Cree un java.io.FileInputStream objeto que representa el archivo que se va a convertir utilizando su constructor y pasando un valor de cadena que especifica la ubicación del archivo.
    • Cree un com.adobe.idp.Document usando su constructor y pasando el java.io.FileInputStream objeto.
  4. Invoque la operación de creación del PDF.

    Invocar el DistillerServiceClient del objeto createPDF y pase los siguientes valores:

    • La variable com.adobe.idp.Document objeto que representa el archivo PS, EPS o PRN que se va a convertir
    • A java.lang.String objeto que contiene el nombre del archivo que se va a convertir
    • A java.lang.String objeto que contiene el nombre de la configuración de Adobe PDF que se va a utilizar
    • A java.lang.String objeto que contiene el nombre de la configuración de seguridad que se va a utilizar
    • Un com.adobe.idp.Document objeto que contiene la configuración que se aplicará al generar el documento PDF
    • Un com.adobe.idp.Document objeto que contiene información de metadatos que se aplicará al documento del PDF

    La variable createPDF el método devuelve un CreatePDFResult que contiene el nuevo documento de PDF y un archivo de registro que se pueden generar. El archivo de registro suele contener mensajes de error o de advertencia generados por la solicitud de conversión.

  5. Guarde el documento del PDF.

    Para obtener el documento de PDF recién creado, realice las siguientes acciones:

    • Invocar el CreatePDFResult del objeto getCreatedDocument método. Esto devuelve un com.adobe.idp.Document objeto.
    • Invocar el com.adobe.idp.Document del objeto copyToFile método para extraer el documento PDF.

    Del mismo modo, para obtener el documento de registro, realice las siguientes acciones.

    • Invocar el CreatePDFResult del objeto getLogDocument método. Esto devuelve un com.adobe.idp.Document objeto.
    • Invocar el com.adobe.idp.Document del objeto copyToFile método para extraer el documento de registro.

Consulte también lo siguiente

Resumen de los pasos

Inicio rápido (modo SOAP): Conversión de un archivo PostScript en un documento PDF mediante la API de Java

Inclusión de archivos de biblioteca Java de AEM Forms

Configuración de las propiedades de conexión

Conversión de un archivo PostScript a PDF mediante la API de servicio web

Convierta un archivo PostScript a un documento de PDF mediante la API de servicio de Distiller (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/DistillerService?WSDL&lc_version=9.0.1.

    NOTA

    Reemplazar localhost con la dirección IP del servidor que hospeda AEM Forms.

  2. Cree un cliente de servicio de Distiller.

    • Cree un DistillerServiceClient usando su constructor predeterminado.

    • Cree un DistillerServiceClient.Endpoint.Address usando la variable System.ServiceModel.EndpointAddress constructor. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo, http://localhost:8080/soap/services/DistillerService?blob=mtom.) No es necesario que use la variable lc_version atributo. Este atributo se utiliza al crear una referencia de servicio. Sin embargo, especifique ?blob=mtom para usar MTOM.

    • Cree un System.ServiceModel.BasicHttpBinding obteniendo el valor de DistillerServiceClient.Endpoint.Binding campo . Conversión del valor devuelto a BasicHttpBinding.

    • Configure las variables System.ServiceModel.BasicHttpBinding del objeto MessageEncoding campo a WSMessageEncoding.Mtom. Este valor garantiza que se utilice MTOM.

    • Habilite la autenticación HTTP básica realizando las siguientes tareas:

      • Asignar el nombre de usuario de los formularios AEM al campo DistillerServiceClient.ClientCredentials.UserName.UserName.
      • Asignar el valor de contraseña correspondiente al campo DistillerServiceClient.ClientCredentials.UserName.Password.
      • Asignar el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Asignar el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.
  3. Recupere el archivo que desea convertir.

    • Cree un BLOB usando su constructor. Esta BLOB se utiliza para almacenar el archivo y convertirlo en un documento PDF.
    • Cree un System.IO.FileStream invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo y el modo en el que se abre 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 la variable System.IO.FileStream del objeto Length propiedad.
    • Rellene la matriz de bytes con los datos de flujo invocando la variable System.IO.FileStream del objeto Read y pasando la matriz de bytes, la posición inicial y la longitud de flujo para leer.
    • Rellene el BLOB asignando su MTOM con el contenido de la matriz de bytes.
  4. Invoque la operación de creación del PDF.

    Invocar el DistillerServiceService del objeto CreatePDF2 y pase los siguientes valores obligatorios:

    • La variable BLOB objeto que representa el archivo PS a convertir
    • Una cadena que contiene el nombre de ruta del archivo que se va a convertir
    • Un objeto de cadena que contiene la configuración de Adobe PDF que se va a utilizar (por ejemplo, Standard)
    • Un objeto de cadena que contiene la configuración de seguridad que se va a utilizar (por ejemplo, No Security)
    • Un BLOB objeto que contiene la configuración que se aplicará al generar el documento PDF
    • Un BLOB objeto que contiene información de metadatos que se aplicará al documento del PDF
    • A BLOB parámetro de salida utilizado para almacenar el documento del PDF
    • A BLOB parámetro de salida utilizado para almacenar el registro
  5. Guarde el documento del PDF.

    • Cree un System.IO.FileStream invocando su constructor. Pase un valor de cadena que represente la ubicación del archivo del documento del PDF firmado y el modo en que se abre el archivo.
    • Cree una matriz de bytes que almacene el contenido del BLOB objeto devuelto por el CreatePDF2 (el parámetro de salida). Rellene la matriz de bytes obteniendo el valor de la variable BLOB del objeto MTOM miembro de datos.
    • Cree un System.IO.BinaryWriter invocando su constructor y pasando el System.IO.FileStream objeto.
    • Escriba el contenido de la matriz de bytes en un archivo de PDF invocando la variable System.IO.BinaryWriter del objeto Write y pasando la matriz de bytes.

Consulte también lo siguiente

Resumen de los pasos

Invocación de AEM Forms mediante MTOM

Invocación de AEM Forms mediante SwaRef

En esta página