Conversión de Postscript a Documentos PDF

Acerca del servicio de Distiller

El servicio Distiller® convierte archivos PostScript®, Encapsulated PostScript (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 puede utilizar la API de servicio de Distiller (Java y servicio web) para convertir en forma programada archivos PostScript (PS), PostScript encapsulado (EPS) y PRN en 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 a documentos PDF, debe instalarse una de las siguientes opciones en el servidor que aloja 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, lleve a cabo 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 de PDF.
  5. Guarde el documento PDF.

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 de servicio de Distiller

Antes de 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.

Recuperar el archivo para convertir

Debe recuperar el archivo que desea convertir. Por ejemplo, para convertir un archivo PS a 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 destinatario.

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

Inicios rápidos de API de servicio de salida

Convertir un archivo PostScript a PDF mediante la API de Java

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

  1. Incluir archivos de proyecto.

    Incluya archivos JAR de cliente, como adobe-distiller-client.jar, en la ruta de clases del 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 se va a convertir utilizando 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. Invoque 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 aplicará al generar el documento PDF
    • Un objeto com.adobe.idp.Document opcional que contiene información de metadatos que se 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 puede generar. El archivo de registro generalmente contiene 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:

    • Invocar 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.

    • Invocar 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 a 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 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

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

  2. Cree un cliente de servicio de Distiller.

    • Cree un objeto DistillerServiceClient utilizando su constructor predeterminado.

    • Cree un objeto DistillerServiceClient.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/DistillerService?blob=mtom). No es necesario usar el atributo lc_version. Este atributo se utiliza al crear una referencia de servicio. Sin embargo, especifique ?blob=mtom para utilizar MTOM.

    • Cree un objeto System.ServiceModel.BasicHttpBinding obteniendo el valor del campo DistillerServiceClient.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 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 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 que se va a leer.
    • Rellene el objeto BLOB asignando su propiedad MTOM con el contenido de la matriz de bytes.
  4. Invoque 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 aplicará al generar el documento PDF
    • Un objeto BLOB opcional que contiene información de metadatos que se aplicará al documento PDF
    • Parámetro de salida BLOB utilizado para almacenar el documento PDF
    • 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 devuelto por el método CreatePDF2 (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