Conversión de Postscript a documentos PDF

Acerca del servicio de Distiller

El servicio Distiller® convierte archivos de PostScript®, PostScript encapsulado (EPS) y PRN en archivos PDF compactos, fiables 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 a documentos PDF

En este tema se describe cómo 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 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 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 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. Invocar la operación de creación de PDF.
  5. Guarde el documento 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 objeto DistillerServiceClient. Si utiliza la API de servicio web, cree un objeto DistillerServiceService.

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 de PDF

Después de crear el cliente de servicio, puede invocar la operación de creación de 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 PDF

Puede guardar el documento PDF como un archivo PDF.

Consulte también

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

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

Convertir un archivo PostScript a un documento 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 objeto ServiceClientFactory que contenga propiedades de conexión.
    • Cree un objeto DistillerServiceClient utilizando su constructor y pasando el objeto ServiceClientFactory.
  3. Recupere el archivo que desea convertir.

    • Cree un objeto java.io.FileInputStream que represente el archivo que desea convertir empleando su constructor y pasando un valor de cadena que especifique la ubicación del archivo.
    • Cree un objeto com.adobe.idp.Document utilizando su constructor y pasando el objeto java.io.FileInputStream.
  4. Invocar la operación de creación de PDF.

    Invoque el método DistillerServiceClient del objeto createPDF y pase los siguientes valores:

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

    El método createPDF devuelve un objeto CreatePDFResult que contiene el nuevo documento 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 PDF.

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

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

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

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

Consulte también

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

Convertir un archivo PostScript a un documento 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

    Sustituya localhost por la dirección IP del servidor que hospeda AEM Forms.

  2. Cree un cliente de servicio de Distiller.

    • Cree un objeto DistillerServiceClient utilizando su constructor predeterminado.

    • Cree un objeto DistillerServiceClient.Endpoint.Address utilizando el constructor System.ServiceModel.EndpointAddress. 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 utilizar el atributo lc_version. Este atributo se utiliza al crear una referencia de servicio. Sin embargo, especifique ?blob=mtom para usar MTOM.

    • Cree un objeto System.ServiceModel.BasicHttpBinding obteniendo el valor del campo DistillerServiceClient.Endpoint.Binding. Establezca el valor devuelto en 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 DistillerServiceClient.ClientCredentials.UserName.UserName.
      • Asigne el valor de contraseña correspondiente al campo DistillerServiceClient.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 archivo que desea convertir.

    • Cree un objeto BLOB utilizando su constructor. Este objeto BLOB se utiliza para almacenar el archivo y convertirlo en un documento PDF.
    • Cree un objeto System.IO.FileStream invocando su constructor y pasando un valor de cadena que represente 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 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 de inicio y la longitud de flujo para leer.
    • Rellene el objeto BLOB asignando su propiedad MTOM con el contenido de la matriz de bytes.
  4. Invocar la operación de creación de PDF.

    Invoque el método DistillerServiceService del objeto CreatePDF2 y pase los siguientes valores obligatorios:

    • El objeto BLOB que representa el archivo PS que se va 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 objeto BLOB opcional que contiene la configuración que se debe aplicar al generar el documento PDF
    • Un objeto BLOB opcional que contiene información de metadatos que se debe aplicar al documento PDF
    • Un parámetro de salida BLOB utilizado para almacenar el documento PDF
    • Un parámetro de salida BLOB utilizado para almacenar el registro
  5. Guarde el documento PDF.

    • Cree un objeto System.IO.FileStream invocando su constructor. Pase un valor de cadena que represente la ubicación del archivo del documento PDF firmado y el modo en que se abre el archivo.
    • Cree una matriz de bytes que almacene el contenido del objeto BLOB que el método CreatePDF2 devolvió (el parámetro de salida). Rellene la matriz de bytes obteniendo el valor del miembro de datos 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 un archivo PDF 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

En esta página