AEM 6.4 ha llegado al final de la compatibilidad ampliada y esta documentación ya no se actualiza. Para obtener más información, consulte nuestra períodos de asistencia técnica. Buscar las versiones compatibles here.
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 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 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.
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, 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.
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 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
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
Convierta un archivo PostScript a un documento de PDF mediante la API de servicio de Distiller (Java):
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-distiller-client.jar, en la ruta de clase de su proyecto Java.
Cree un cliente de servicio de Distiller.
ServiceClientFactory
objeto que contiene propiedades de conexión.DistillerServiceClient
usando su constructor y pasando el ServiceClientFactory
objeto.Recupere el archivo que desea convertir.
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.com.adobe.idp.Document
usando su constructor y pasando el java.io.FileInputStream
objeto.Invoque la operación de creación del PDF.
Invocar el DistillerServiceClient
del objeto createPDF
y pase los siguientes valores:
com.adobe.idp.Document
objeto que representa el archivo PS, EPS o PRN que se va a convertirjava.lang.String
objeto que contiene el nombre del archivo que se va a convertirjava.lang.String
objeto 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á al generar el documento PDFcom.adobe.idp.Document
objeto que contiene información de metadatos que se aplicará al documento del PDFLa 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.
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
método para extraer el documento 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
método para extraer el documento de registro.Consulte también
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Convierta un archivo PostScript a un documento de PDF mediante la API de servicio de Distiller (servicio web):
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
.
Reemplazar localhost
con la dirección IP del servidor que hospeda AEM Forms.
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:
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
usando su constructor. Esta BLOB
se utiliza para almacenar el archivo y convertirlo en un documento PDF.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.System.IO.FileStream
objeto. Puede determinar el tamaño de la matriz de bytes obteniendo la variable 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 flujo para leer.BLOB
asignando su MTOM
con el contenido de la matriz de bytes.Invoque la operación de creación del PDF.
Invocar el DistillerServiceService
del objeto CreatePDF2
y pase los siguientes valores obligatorios:
BLOB
objeto que representa el archivo PS a convertirStandard
)No Securit
y)BLOB
objeto que contiene la configuración que se aplicará al generar el documento PDFBLOB
objeto que contiene información de metadatos que se aplicará al documento del PDFBLOB
parámetro de salida utilizado para almacenar el documento del 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 del PDF firmado y el modo en que se abre el archivo.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.System.IO.BinaryWriter
invocando su constructor y pasando el System.IO.FileStream
objeto.System.IO.BinaryWriter
del objeto Write
y pasando la matriz de bytes.Consulte también
Invocación de AEM Forms mediante MTOM
Invocación de AEM Forms mediante SwaRef