Conversione di Postscript in documenti PDF converting-postscript-to-pdf-documents
Informazioni sul servizio Distiller about-the-distiller-service
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.
Conversione di documenti PostScript in documenti 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 programmaticamente 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, eseguire le operazioni seguenti:
- Includi file di progetto.
- Crea un client di servizio Distiller.
- Recupera 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.
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 DistillerServiceClient oggetto. Se utilizzi l’API del servizio Web, crea un DistillerServiceService oggetto.
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 di PDF
Dopo aver creato il client di servizio, è possibile richiamare l’operazione di creazione di 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 PDF utilizzando l’API Java convert-a-postscript-file-to-pdf-using-the-java-api
Convertire un file PostScript in un documento PDF utilizzando l’API del 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.
- Crea un
ServiceClientFactoryoggetto contenente le proprietà di connessione. - Crea un
DistillerServiceClientutilizzando il relativo costruttore e passandoServiceClientFactoryoggetto.
- Crea un
-
Recupera il file da convertire.
- Crea un
java.io.FileInputStreamoggetto che rappresenta il file da convertire utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del file. - Crea un
com.adobe.idp.Documentutilizzando il relativo costruttore e passandojava.io.FileInputStreamoggetto.
- Crea un
-
Richiama l’operazione di creazione di PDF.
Richiama il
DistillerServiceClientdell’oggettocreatePDFe passare i seguenti valori:- La
com.adobe.idp.Documentoggetto che rappresenta il file PS, EPS o PRN da convertire - A
java.lang.Stringoggetto contenente il nome del file da convertire - A
java.lang.Stringoggetto contenente il nome delle impostazioni Adobe PDF da utilizzare - A
java.lang.Stringoggetto contenente il nome delle impostazioni di protezione da utilizzare - Facoltativo
com.adobe.idp.Documentoggetto contenente le impostazioni da applicare durante la generazione del documento PDF - Facoltativo
com.adobe.idp.Documentoggetto contenente le informazioni sui metadati da applicare al documento PDF
La
createPDFrestituisce unCreatePDFResultoggetto 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. - La
-
Salvare il documento PDF.
Per ottenere il documento PDF appena creato, eseguire le operazioni seguenti:
- Richiama il
CreatePDFResultdell’oggettogetCreatedDocumentmetodo . Questo restituisce uncom.adobe.idp.Documentoggetto. - Richiama il
com.adobe.idp.Documentdell’oggettocopyToFileper estrarre il documento PDF.
Analogamente, per ottenere il documento di registro, eseguire le operazioni seguenti.
- Richiama il
CreatePDFResultdell’oggettogetLogDocumentmetodo . Questo restituisce uncom.adobe.idp.Documentoggetto. - Richiama il
com.adobe.idp.Documentdell’oggettocopyToFilemetodo per estrarre il documento di registro.
- Richiama il
Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Conversione di un file PostScript in PDF tramite l’API del servizio Web converting-a-postscript-file-to-pdf-using-the-web-service-api
Convertire un file PostScript in un documento PDF utilizzando l’API del servizio Distiller (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.note note NOTE Sostituisci localhostcon l’indirizzo IP del server che ospita AEM Forms. -
Crea un client di servizio Distiller.
-
Crea un
DistillerServiceClientutilizzando il relativo costruttore predefinito. -
Crea un
DistillerServiceClient.Endpoint.AddressutilizzandoSystem.ServiceModel.EndpointAddresscostruttore. 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 illc_versionattributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio. Tuttavia, specifica?blob=mtomper utilizzare MTOM. -
Crea un
System.ServiceModel.BasicHttpBindingottenendo il valore delDistillerServiceClient.Endpoint.Bindingcampo . Imposta il valore restituito suBasicHttpBinding. -
Imposta la
System.ServiceModel.BasicHttpBindingdell’oggettoMessageEncodingcampo aWSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
DistillerServiceClient.ClientCredentials.UserName.UserName. - Assegna il valore della password corrispondente al campo
DistillerServiceClient.ClientCredentials.UserName.Password. - Assegna il valore costante
HttpClientCredentialType.Basical campoBasicHttpBindingSecurity.Transport.ClientCredentialType. - Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnlyal campoBasicHttpBindingSecurity.Security.Mode.
- Assegnare il nome utente del modulo di AEM al campo
-
-
Recupera il file da convertire.
- Crea un
BLOButilizzando il relativo costruttore. QuestoBLOBviene utilizzato per memorizzare il file da convertire in un documento PDF. - Crea un
System.IO.FileStreamrichiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file e la modalità di apertura del file. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStreamoggetto. È possibile determinare le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStreamdell’oggettoLengthproprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStreamdell’oggettoReade passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOBoggetto assegnando il relativoMTOMcon il contenuto dell'array di byte.
- Crea un
-
Richiama l’operazione di creazione di PDF.
Richiama il
DistillerServiceServicedell’oggettoCreatePDF2e trasmettere i seguenti valori richiesti:- La
BLOBoggetto che rappresenta il file PS da convertire - Una stringa che contiene il nome del percorso del file da convertire
- Un oggetto stringa contenente le impostazioni Adobe PDF da utilizzare, ad esempio
Standard) - Un oggetto stringa contenente le impostazioni di protezione da utilizzare, ad esempio
No Securita) - Facoltativo
BLOBoggetto contenente le impostazioni da applicare durante la generazione del documento PDF - Facoltativo
BLOBoggetto contenente le informazioni sui metadati da applicare al documento PDF - A
BLOBparametro di output utilizzato per memorizzare il documento PDF - A
BLOBparametro di output utilizzato per memorizzare il registro
- La
-
Salvare il documento PDF.
- Crea un
System.IO.FileStreamrichiamando 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 un array di byte che memorizza il contenuto del
BLOBoggetto restituito daCreatePDF2(il parametro di output). Compilare l’array di byte ottenendo il valore delBLOBdell’oggettoMTOMmembro dati. - Crea un
System.IO.BinaryWriterrichiamando il relativo costruttore e passandoSystem.IO.FileStreamoggetto. - Scrivi il contenuto dell’array di byte in un file PDF richiamando il
System.IO.BinaryWriterdell’oggettoWritee passare l'array di byte.
- Crea un
Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef