Il servizio Distiller® converte i file PostScript®, Encapsulated PostScript (EPS) e PRN in file PDF compatti, affidabili e più sicuri su una rete. Il servizio Distiller viene spesso utilizzato per convertire grandi volumi di documenti stampati in documenti elettronici, ad esempio fatture e dichiarazioni. La conversione dei documenti in PDF consente inoltre alle aziende di inviare ai propri clienti una versione cartacea e una versione elettronica di un documento.
Per ulteriori informazioni sul servizio Distiller, consulta Riferimento servizi per AEM Forms.
In questo argomento viene descritto come utilizzare l'API del servizio Distiller (Java e servizio Web) per convertire programmaticamente i file PostScript (PS), Encapsulated PostScript (EPS) e PRN in documenti PDF.
Per ulteriori informazioni sul servizio Distiller, consulta Riferimento servizi per AEM Forms.
Per convertire i file PostScript in documenti PDF, è necessario installare uno dei seguenti file sul server che ospita AEM Forms: Pacchetto ridistribuibile Acrobat 9 o Microsoft Visual C++ 2005.
Per convertire uno qualsiasi dei tipi supportati in un documento PDF, eseguire la procedura seguente:
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
Creare un client di servizio Distiller
Prima di poter eseguire un’operazione di servizio Distiller a livello di programmazione, è necessario creare un client di servizio Distiller. Se utilizzi l’API Java, crea un oggetto DistillerServiceClient
. Se utilizzi l’API del servizio Web, crea un oggetto DistillerServiceService
.
Recupera il file da convertire
È necessario recuperare il file da convertire. Ad esempio, per convertire un file PS in un documento PDF, è necessario recuperare il file PS.
Richiamare l’operazione di creazione del PDF
Dopo aver creato il client di servizio, è possibile richiamare l’operazione di creazione PDF. Questa operazione richiede informazioni sul documento da convertire, compreso il percorso del documento di destinazione.
Salvare il documento PDF
È possibile salvare il documento PDF come file PDF.
Consulta anche
Convertire un file PostScript in PDF utilizzando l’API Java
Conversione di un file PostScript in PDF tramite l’API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API del servizio di output
Convertire un file PostScript in un documento PDF utilizzando l’API di servizio Distiller (Java):
Includi file di progetto.
Includi file JAR client, come adobe-distiller-client.jar, nel percorso di classe del progetto Java.
Crea un client di servizio Distiller.
ServiceClientFactory
contenente le proprietà di connessione.DistillerServiceClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Recupera il file da convertire.
java.io.FileInputStream
che rappresenta il file da convertire utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del file.com.adobe.idp.Document
utilizzando il relativo costruttore e passando l'oggetto java.io.FileInputStream
.Richiamare l’operazione di creazione del PDF.
Richiama il metodo createPDF
dell'oggetto DistillerServiceClient
e passa i seguenti valori:
com.adobe.idp.Document
che rappresenta il file PS, EPS o PRN da convertirejava.lang.String
che contiene il nome del file da convertirejava.lang.String
che contiene il nome delle impostazioni Adobe PDF da utilizzarejava.lang.String
che contiene il nome delle impostazioni di protezione da utilizzarecom.adobe.idp.Document
facoltativo che contiene le impostazioni da applicare durante la generazione del documento PDFcom.adobe.idp.Document
facoltativo che contiene informazioni sui metadati da applicare al documento PDFIl metodo createPDF
restituisce un oggetto CreatePDFResult
contenente il nuovo documento PDF e un file di registro che può essere generato. Il file di registro in genere contiene messaggi di errore o di avviso generati dalla richiesta di conversione.
Salvare il documento PDF.
Per ottenere il documento PDF appena creato, eseguire le operazioni seguenti:
getCreatedDocument
dell'oggetto CreatePDFResult
. Restituisce un oggetto com.adobe.idp.Document
.copyToFile
dell'oggetto com.adobe.idp.Document
per estrarre il documento PDF.Analogamente, per ottenere il documento di registro, eseguire le operazioni seguenti.
getLogDocument
dell'oggetto CreatePDFResult
. Restituisce un oggetto com.adobe.idp.Document
.copyToFile
dell'oggetto com.adobe.idp.Document
per estrarre il documento di registro.Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Convertire un file PostScript in un documento PDF utilizzando l'API di Distiller Service (servizio Web):
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/DistillerService?WSDL&lc_version=9.0.1
.
Sostituisci localhost
con l'indirizzo IP del server che ospita AEM Forms.
Crea un client di servizio Distiller.
Creare un oggetto DistillerServiceClient
utilizzando il relativo costruttore predefinito.
Creare un oggetto DistillerServiceClient.Endpoint.Address
utilizzando il costruttore System.ServiceModel.EndpointAddress
. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/DistillerService?blob=mtom
). Non è necessario utilizzare l'attributo lc_version
. Questo attributo viene utilizzato quando si crea un riferimento a un servizio. Tuttavia, specifica ?blob=mtom
per utilizzare MTOM.
Crea un oggetto System.ServiceModel.BasicHttpBinding
ottenendo il valore del campo DistillerServiceClient.Endpoint.Binding
. Imposta il valore restituito su BasicHttpBinding
.
Impostare il campo MessageEncoding
dell'oggetto System.ServiceModel.BasicHttpBinding
su WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
DistillerServiceClient.ClientCredentials.UserName.UserName
.DistillerServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Recupera il file da convertire.
BLOB
utilizzando il relativo costruttore. Questo oggetto BLOB
viene utilizzato per memorizzare il file da convertire in un documento PDF.System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file e la modalità in cui aprire il file.System.IO.FileStream
. È possibile determinare le dimensioni dell'array di byte ottenendo la proprietà Length
dell'oggetto System.IO.FileStream
.Read
dell’oggetto System.IO.FileStream
e passando l’array di byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
assegnando la relativa proprietà MTOM
con il contenuto dell'array di byte.Richiamare l’operazione di creazione del PDF.
Richiama il metodo CreatePDF2
dell'oggetto DistillerServiceService
e passa i seguenti valori obbligatori:
BLOB
che rappresenta il file PS da convertireStandard
)No Securit
y)BLOB
facoltativo che contiene le impostazioni da applicare durante la generazione del documento PDFBLOB
facoltativo che contiene informazioni sui metadati da applicare al documento PDFBLOB
utilizzato per memorizzare il documento PDFBLOB
utilizzato per memorizzare il registroSalvare il documento PDF.
System.IO.FileStream
richiamando il relativo costruttore. Passare un valore di stringa che rappresenta la posizione del file del documento PDF firmato e la modalità di apertura del file.BLOB
restituito dal metodo CreatePDF2
(il parametro di output). Compilare l'array di byte ottenendo il valore del membro dati BLOB
dell'oggetto MTOM
.System.IO.BinaryWriter
richiamandone il costruttore e passando l'oggetto System.IO.FileStream
.Write
dell’oggetto System.IO.BinaryWriter
e passando l’array di byte.Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef