Conversione di PostScript in documenti PDF converting-postscript-to-pdf-documents
Gli esempi e gli esempi contenuti in questo documento sono solo per AEM Forms in ambiente JEE.
Informazioni sul servizio Distiller about-the-distiller-service
Il servizio Distiller® converte i file PostScript®, EPS (Encapsulated PostScript) e PRN in file PDF compatti, affidabili e più sicuri in rete. Il servizio Distiller viene spesso utilizzato per convertire grandi quantità di documenti stampati in documenti elettronici, come fatture e rendiconti. 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.
Conversione di documenti PostScript in PDF converting-postscript-to-pdf-documents-inner
In questo argomento viene descritto come utilizzare l'API del servizio Distiller (Java e servizio Web) per convertire in modo programmatico i file PostScript (PS), Encapsulated PostScript (EPS) e PRN in documenti PDF.
Riepilogo dei passaggi summary-of-steps
Per convertire uno qualsiasi dei tipi supportati in un documento PDF, effettuare le seguenti operazioni:
- Includi file di progetto.
- Creazione di un client di servizio Distiller.
- Recuperate il file da convertire.
- Richiama l’operazione di creazione di PDF.
- Salvare il documento PDF.
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.
Crea un client del servizio Distiller
Prima di poter eseguire un'operazione di servizio Distiller a livello di programmazione, è necessario creare un client di servizio Distiller. Se si utilizza l'API Java, creare un oggetto DistillerServiceClient
. Se si utilizza l'API del servizio Web, creare un oggetto DistillerServiceService
.
Recupera il file da convertire
Recuperate il file da convertire. Ad esempio, per convertire un file PS in un documento PDF, è necessario recuperare il file PS.
Richiama l'operazione di creazione di PDF
Dopo aver creato il client del servizio, è possibile richiamare l'operazione di creazione PDF. Questa operazione richiede informazioni sul documento da convertire, incluso il percorso del documento di destinazione.
Salva 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 della libreria Java di AEM Forms
Convertire un file PostScript in PDF utilizzando l’API Java convert-a-postscript-file-to-pdf-using-the-java-api
Converti un file PostScript in documento PDF utilizzando l’API di servizio Distiller (Java):
-
Includi file di progetto.
Includi i file JAR client, come adobe-distiller-client.jar, nel percorso di classe del progetto Java.
-
Creazione di un client di servizio Distiller.
- Creare un oggetto
ServiceClientFactory
contenente le proprietà di connessione. - Creare un oggetto
DistillerServiceClient
utilizzando il relativo costruttore e passando l'oggettoServiceClientFactory
.
- Creare un oggetto
-
Recuperate il file da convertire.
- Creare un oggetto
java.io.FileInputStream
che rappresenta il file da convertire utilizzando il relativo costruttore e passando un valore stringa che specifica la posizione del file. - Creare un oggetto
com.adobe.idp.Document
utilizzando il relativo costruttore e passando l'oggettojava.io.FileInputStream
.
- Creare un oggetto
-
Richiama l’operazione di creazione di PDF.
Richiama il metodo
createPDF
dell'oggettoDistillerServiceClient
e passa i seguenti valori:- Oggetto
com.adobe.idp.Document
che rappresenta il file PS, EPS o PRN da convertire - Oggetto
java.lang.String
contenente il nome del file da convertire - Oggetto
java.lang.String
contenente il nome delle impostazioni Adobe PDF da utilizzare - Oggetto
java.lang.String
contenente il nome delle impostazioni di protezione da utilizzare - Oggetto
com.adobe.idp.Document
facoltativo contenente le impostazioni da applicare durante la generazione del documento PDF - Oggetto
com.adobe.idp.Document
facoltativo contenente informazioni sui metadati da applicare al documento PDF
Il metodo
createPDF
restituisce un oggettoCreatePDFResult
che contiene il nuovo documento PDF e un file di log che può essere generato. Il file di registro contiene in genere messaggi di errore o di avviso generati dalla richiesta di conversione. - Oggetto
-
Salvare il documento PDF.
Per ottenere il documento di PDF appena creato, effettuare le seguenti operazioni:
- Richiama il metodo
getCreatedDocument
dell'oggettoCreatePDFResult
. Restituisce un oggettocom.adobe.idp.Document
. - Richiama il metodo
copyToFile
dell'oggettocom.adobe.idp.Document
per estrarre il documento PDF.
Analogamente, per ottenere il documento di registro, effettuare le seguenti operazioni.
- Richiama il metodo
getLogDocument
dell'oggettoCreatePDFResult
. Restituisce un oggettocom.adobe.idp.Document
. - Richiama il metodo
copyToFile
dell'oggettocom.adobe.idp.Document
per estrarre il documento di log.
- Richiama il metodo
Consulta anche
Conversione di un file PostScript in PDF tramite l’API del servizio web converting-a-postscript-file-to-pdf-using-the-web-service-api
Converti un file PostScript in documento PDF utilizzando l’API del servizio Distiller (servizio web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/DistillerService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l'indirizzo IP del server che ospita AEM Forms. -
Creazione di un client di servizio Distiller.
-
Creare un oggetto
DistillerServiceClient
utilizzando il relativo costruttore predefinito. -
Creare un oggetto
DistillerServiceClient.Endpoint.Address
utilizzando il costruttoreSystem.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'attributolc_version
. Questo attributo viene utilizzato quando si crea un riferimento a un servizio. Tuttavia, specificare?blob=mtom
per utilizzare MTOM. -
Creare un oggetto
System.ServiceModel.BasicHttpBinding
ottenendo il valore del campoDistillerServiceClient.Endpoint.Binding
. Eseguire il cast del valore restituito inBasicHttpBinding
. -
Impostare il campo
MessageEncoding
dell'oggettoSystem.ServiceModel.BasicHttpBinding
suWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente dei moduli AEM al campo
DistillerServiceClient.ClientCredentials.UserName.UserName
. - Assegnare il valore della password corrispondente al campo
DistillerServiceClient.ClientCredentials.UserName.Password
. - Assegnare il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Assegnare il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
- Assegnare il nome utente dei moduli AEM al campo
-
-
Recuperate il file da convertire.
- Creare un oggetto
BLOB
utilizzando il relativo costruttore. Questo oggettoBLOB
viene utilizzato per memorizzare il file per la conversione in un documento PDF. - Creare un oggetto
System.IO.FileStream
richiamandone il costruttore e passando un valore stringa che rappresenta la posizione del file e la modalità di apertura del file in. - Creare una matrice di byte che memorizza il contenuto dell'oggetto
System.IO.FileStream
. È possibile determinare le dimensioni della matrice di byte ottenendo la proprietàLength
dell'oggettoSystem.IO.FileStream
. - Compilare la matrice di byte con i dati di flusso richiamando il metodo
Read
dell'oggettoSystem.IO.FileStream
e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Compilare l'oggetto
BLOB
assegnando la relativa proprietàMTOM
al contenuto della matrice di byte.
- Creare un oggetto
-
Richiama l’operazione di creazione di PDF.
Richiama il metodo
CreatePDF2
dell'oggettoDistillerServiceService
e passa i seguenti valori richiesti:- Oggetto
BLOB
che rappresenta il file PS da convertire - Una stringa che contiene il percorso del file da convertire
- Oggetto stringa contenente le impostazioni Adobe PDF da utilizzare (ad esempio,
Standard
) - Oggetto stringa contenente le impostazioni di protezione da utilizzare (ad esempio,
No Securit
y) - Oggetto
BLOB
facoltativo contenente le impostazioni da applicare durante la generazione del documento PDF - Oggetto
BLOB
facoltativo contenente informazioni sui metadati da applicare al documento PDF - Un parametro di output
BLOB
utilizzato per memorizzare il documento PDF - Un parametro di output
BLOB
utilizzato per memorizzare il registro
- Oggetto
-
Salvare il documento PDF.
- Creare un oggetto
System.IO.FileStream
richiamando il relativo costruttore. Passa un valore stringa che rappresenta la posizione del file del documento PDF firmato e la modalità di apertura del file. - Creare una matrice di byte che memorizza il contenuto dell'oggetto
BLOB
restituito dal metodoCreatePDF2
(parametro di output). Popolare la matrice di byte ottenendo il valore del membro datiMTOM
dell'oggettoBLOB
. - Creare un oggetto
System.IO.BinaryWriter
richiamandone il costruttore e passando l'oggettoSystem.IO.FileStream
. - Scrivere il contenuto della matrice di byte in un file PDF richiamando il metodo
Write
dell'oggettoSystem.IO.BinaryWriter
e passando la matrice di byte.
- Creare un oggetto
Consulta anche
Richiamare AEM Forms tramite MTOM
Richiamare AEM Forms con SwaRef