Los ejemplos de este documento solo son para AEM Forms en un entorno JEE.
El servicio Distiller® convierte los archivos PostScript®, PostScript encapsulado (EPS) y PRN en archivos de 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 e instrucciones. La conversión de documentos a PDF también permite a las empresas enviar a sus clientes una versión en papel y otra electrónica de un documento.
Para obtener más información sobre el servicio Distiller, consulte Referencia de servicios para AEM Forms.
En este tema se describe cómo puede utilizar la API del servicio Distiller (Java y servicio web) para convertir mediante programación archivos PostScript (PS), PostScript encapsulado (EPS) y PRN en documentos de PDF.
Para obtener más información sobre el servicio Distiller, consulte Referencia de servicios para AEM Forms.
Para convertir archivos PostScript en documentos de PDF, es necesario instalar uno de los siguientes en el servidor que aloja AEM Forms: Acrobat 9 o paquete redistribuible de Microsoft Visual C++ 2005.
Para convertir cualquiera de los tipos admitidos en un documento de PDF, realice los siguientes pasos:
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.
Crear un cliente de servicio de Distiller
Para poder realizar mediante programación una operación de servicio de Distiller, debe crear un cliente de servicio de Distiller. Si utiliza la API de Java, cree un DistillerServiceClient
objeto. Si utiliza la API del 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 de PDF, debe recuperar el archivo PS.
Invocar la operación de creación del PDF
Después de crear el cliente de servicios, puede invocar la operación de creación del PDF. Esta operación necesita 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 de PDF como un archivo de PDF.
Consulte también
Conversión de un archivo PostScript a PDF mediante la API de Java
Conversión de un archivo PostScript a PDF mediante la API de servicio web
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Inicios rápidos de API del servicio de salida
Conversión de un archivo PostScript en un documento de PDF mediante la API de servicio de Distiller (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-distiller-client.jar, en la ruta de clase del proyecto Java.
Cree un cliente de servicio de Distiller.
ServiceClientFactory
que contiene las propiedades de conexión.DistillerServiceClient
usando su constructor y pasando el objeto ServiceClientFactory
objeto.Recupere el archivo que desea convertir.
java.io.FileInputStream
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.com.adobe.idp.Document
usando su constructor y pasando el objeto java.io.FileInputStream
objeto.Invoque la operación de creación del PDF.
Invoque el DistillerServiceClient
del objeto createPDF
y pasar los siguientes valores:
com.adobe.idp.Document
que representa el archivo PS, EPS o PRN que se va a convertirjava.lang.String
que contiene el nombre del archivo que se va a convertirjava.lang.String
que contiene el nombre de la configuración de Adobe PDF que se va a utilizarjava.lang.String
objeto que contiene el nombre de la configuración de seguridad que se va a utilizarcom.adobe.idp.Document
objeto que contiene la configuración que se aplicará durante la generación del documento de PDFcom.adobe.idp.Document
que contiene información de metadatos que se aplicará al documento del PDFEl createPDF
El método devuelve un valor CreatePDFResult
que contiene el nuevo documento de PDF y un archivo de registro que se puede generar. El archivo de registro suele contener mensajes de error o advertencia generados por la solicitud de conversión.
Guarde el documento del PDF.
Para obtener el documento de PDF recién creado, realice las siguientes acciones:
CreatePDFResult
del objeto getCreatedDocument
método. Esto devuelve un com.adobe.idp.Document
objeto.com.adobe.idp.Document
del objeto copyToFile
para extraer el documento del PDF.Del mismo modo, para obtener el documento de registro, realice las siguientes acciones.
CreatePDFResult
del objeto getLogDocument
método. Esto devuelve un com.adobe.idp.Document
objeto.com.adobe.idp.Document
del objeto copyToFile
para extraer el documento de registro.Consulte también
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Conversión de un archivo PostScript en un documento de PDF mediante la API de servicio Distiller (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/DistillerService?WSDL&lc_version=9.0.1
.
Reemplazar localhost
con la dirección IP del servidor que aloja AEM Forms.
Cree un cliente de servicio de Distiller.
Crear un DistillerServiceClient
mediante su constructor predeterminado.
Crear un DistillerServiceClient.Endpoint.Address
mediante el uso del objeto System.ServiceModel.EndpointAddress
constructor. 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 que utilice el lc_version
atributo. Este atributo se utiliza al crear una referencia de servicio. Sin embargo, especifique ?blob=mtom
para utilizar MTOM.
Crear un System.ServiceModel.BasicHttpBinding
al obtener el valor de la variable DistillerServiceClient.Endpoint.Binding
field. Convierta el valor devuelto en BasicHttpBinding
.
Configure las variables System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
field a WSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
DistillerServiceClient.ClientCredentials.UserName.UserName
.DistillerServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Recupere el archivo que desea convertir.
BLOB
mediante su constructor. Esta BLOB
se utiliza para almacenar el archivo que se va a convertir en un documento de PDF.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo y el modo para abrir el archivo en.System.IO.FileStream
objeto. Puede determinar el tamaño de la matriz de bytes obteniendo el System.IO.FileStream
del objeto Length
propiedad.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición inicial y la longitud de la secuencia que se va a leer.BLOB
al asignar su MTOM
con el contenido de la matriz de bytes.Invoque la operación de creación del PDF.
Invoque el DistillerServiceService
del objeto CreatePDF2
y pasar los siguientes valores obligatorios:
BLOB
que representa el archivo PS que se va a convertirStandard
)No Securit
y)BLOB
objeto que contiene la configuración que se aplicará durante la generación del documento de PDFBLOB
que contiene información de metadatos que se aplicará al documento del PDFBLOB
parámetro de salida utilizado para almacenar el documento de PDFBLOB
parámetro de salida utilizado para almacenar el registroGuarde el documento del PDF.
System.IO.FileStream
invocando su constructor. Pase un valor de cadena que represente la ubicación del archivo del documento de PDF firmado y el modo en que se abrirá el archivo.BLOB
objeto que ha devuelto el CreatePDF2
(el parámetro de salida). Rellene la matriz de bytes obteniendo el valor de BLOB
del objeto MTOM
miembro de datos.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
objeto.System.IO.BinaryWriter
del objeto Write
y pasando la matriz de bytes.Consulte también
Invocar AEM Forms mediante MTOM
Invocar AEM Forms mediante SwaRef