Convertir documentos Postscript a PDF converting-postscript-to-pdf-documents
Las muestras y los ejemplos de este documento solo son para AEM Forms en un entorno JEE.
Acerca del servicio Distiller about-the-distiller-service
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.
Conversión de documentos de PostScript a PDF converting-postscript-to-pdf-documents-inner
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.
Resumen de los pasos summary-of-steps
Para convertir cualquiera de los tipos admitidos en un documento de PDF, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un cliente de servicio de Distiller.
- Recupere el archivo que desea convertir.
- Invoque la operación de creación del PDF.
- 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 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 está usando la API de Java, cree un objeto DistillerServiceClient
. Si está usando la API del servicio web, cree un objeto DistillerServiceService
.
Recuperar el archivo para convertir
Recupere 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 un PDF mediante la API de Java
Conversión de un archivo PostScript a un PDF mediante la API de servicio web
Incluir archivos de biblioteca Java de AEM Forms
Conversión de un archivo PostScript a un PDF mediante la API de Java convert-a-postscript-file-to-pdf-using-the-java-api
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.
- Cree un objeto
ServiceClientFactory
que contenga propiedades de conexión. - Cree un objeto
DistillerServiceClient
utilizando su constructor y pasando el objetoServiceClientFactory
.
- Cree un objeto
-
Recupere el archivo que desea convertir.
- Cree un objeto
java.io.FileInputStream
que represente el archivo que se va a convertir mediante 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 objetojava.io.FileInputStream
.
- Cree un objeto
-
Invoque la operación de creación del PDF.
Invoque el método
createPDF
del objetoDistillerServiceClient
y pase los siguientes valores:- El objeto
com.adobe.idp.Document
que representa el archivo PS, EPS o PRN que se va a convertir - Objeto
java.lang.String
que contiene el nombre del archivo que se va a convertir - Objeto
java.lang.String
que contiene el nombre de la configuración de Adobe PDF que se va a usar - 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á durante la generación del documento del PDF - Un objeto
com.adobe.idp.Document
opcional que contiene información de metadatos que se aplicará al documento del PDF
El método
createPDF
devuelve un objetoCreatePDFResult
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. - El objeto
-
Guarde el documento del PDF.
Para obtener el documento de PDF recién creado, realice las siguientes acciones:
- Invoque el método
getCreatedDocument
del objetoCreatePDFResult
. Devuelve un objetocom.adobe.idp.Document
. - Invoque el método
copyToFile
del objetocom.adobe.idp.Document
para extraer el documento del PDF.
Del mismo modo, para obtener el documento de registro, realice las siguientes acciones.
- Invoque el método
getLogDocument
del objetoCreatePDFResult
. Devuelve un objetocom.adobe.idp.Document
. - Invoque el método
copyToFile
del objetocom.adobe.idp.Document
para extraer el documento de registro.
- Invoque el método
Consulte también
Conversión de un archivo PostScript a un PDF mediante la API de servicio web converting-a-postscript-file-to-pdf-using-the-web-service-api
Conversión de un archivo PostScript en un documento de PDF mediante la API de servicio web 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 de WSDL:
http://localhost:8080/soap/services/DistillerService?WSDL&lc_version=9.0.1
.note note NOTE Reemplace localhost
por la dirección IP del servidor que hospeda AEM Forms. -
Cree un cliente de servicio de Distiller.
-
Cree un objeto
DistillerServiceClient
utilizando su constructor predeterminado. -
Cree un objeto
DistillerServiceClient.Endpoint.Address
mediante el constructorSystem.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 necesita usar el atributolc_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 campoDistillerServiceClient.Endpoint.Binding
. Convertir el valor devuelto enBasicHttpBinding
. -
Establezca el campo
MessageEncoding
del objetoSystem.ServiceModel.BasicHttpBinding
enWSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- AEM Asigne el nombre de usuario de los formularios de la 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 campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Asigne el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
- AEM Asigne el nombre de usuario de los formularios de la al campo
-
-
Recupere el archivo que desea convertir.
- Crear un objeto
BLOB
mediante su constructor. Este objetoBLOB
se usa para almacenar el archivo que se convertirá en un documento de 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 para abrirlo en. - 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 propiedadLength
del objetoSystem.IO.FileStream
. - Rellene la matriz de bytes con datos de secuencia invocando el método
Read
del objetoSystem.IO.FileStream
y pasando a leer la matriz de bytes, la posición inicial y la longitud de secuencia. - Rellene el objeto
BLOB
asignando su propiedadMTOM
con el contenido de la matriz de bytes.
- Crear un objeto
-
Invoque la operación de creación del PDF.
Invoque el método
CreatePDF2
del objetoDistillerServiceService
y pase los siguientes valores necesarios:- El objeto
BLOB
que representa el archivo PS que se va a convertir - Cadena que contiene el nombre de ruta del archivo que se va a convertir
- Objeto de cadena que contiene la configuración de Adobe PDF que se va a utilizar (por ejemplo,
Standard
) - Objeto de cadena que contiene la configuración de seguridad que se va a utilizar (por ejemplo,
No Securit
y) - Un objeto
BLOB
opcional que contiene la configuración que se aplicará durante la generación del documento del PDF - Un objeto
BLOB
opcional que contiene información de metadatos que se aplicará al documento del PDF - Un parámetro de salida
BLOB
utilizado para almacenar el documento de PDF - Un parámetro de salida
BLOB
utilizado para almacenar el registro
- El objeto
-
Guarde el documento del PDF.
- Cree un objeto
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. - Cree una matriz de bytes que almacene el contenido del objeto
BLOB
devuelto por el métodoCreatePDF2
(el parámetro de salida). Rellene la matriz de bytes obteniendo el valor del miembro de datosMTOM
del objetoBLOB
. - Cree un objeto
System.IO.BinaryWriter
invocando su constructor y pasando el objetoSystem.IO.FileStream
. - Escriba el contenido de la matriz de bytes en un archivo PDF invocando el método
Write
del objetoSystem.IO.BinaryWriter
y pasando la matriz de bytes.
- Cree un objeto
Consulte también
Invocar AEM Forms mediante MTOM
Invocar AEM Forms mediante SwaRef