Esempi ed esempi in questo documento sono solo per AEM Forms in ambiente JEE.
Informazioni sul servizio Converti PDF
Il servizio Converti PDF converte i documenti PDF in PostScript e in diversi formati di immagine (JPEG, JPEG 2000, PNG e TIFF). La conversione di un documento PDF in PostScript è utile per la stampa automatica basata su server su qualsiasi stampante PostScript. La conversione di un documento PDF in un file TIFF multipagina è pratica quando si archiviano documenti in sistemi di gestione dei contenuti che non supportano documenti PDF.
È possibile eseguire queste operazioni utilizzando il servizio Converti PDF:
Per ulteriori informazioni sul servizio Converti PDF, vedere Riferimento servizi per AEM Forms.
In questo argomento viene descritto come utilizzare l’API di servizio Converti PDF (Java e servizio Web) per convertire programmaticamente i documenti PDF in file PostScript. Il documento PDF convertito in file PostScript deve essere un documento PDF non interattivo. In altre parole, se si tenta di convertire un documento PDF interattivo in un file PostScript, viene generata un'eccezione.
Per ulteriori informazioni sul servizio Converti PDF, vedere Riferimento servizi per AEM Forms.
Per convertire un documento PDF in un file PostScript, eseguire le operazioni seguenti:
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 conversione PDF
Prima di poter eseguire in modo programmatico un’operazione del servizio Converti PDF, è necessario creare un client di servizio Converti PDF. Se utilizzi l’API Java, crea un oggetto ConvertPdfServiceClient
. Se utilizzi l’API del servizio Web, crea un oggetto ConvertPDFServiceService
.
Questa sezione utilizza la funzionalità del servizio Web introdotta in AEM Forms. Per accedere alle nuove funzionalità, è necessario creare l'oggetto proxy utilizzando l'attributo lc_version
. (Vedere "Accesso a nuove funzionalità tramite i servizi Web" in Richiamo di AEM Forms tramite i servizi Web.)
Fare riferimento al documento PDF per la conversione in un file PostScript
Fare riferimento al documento PDF che si desidera convertire in un file PostScript. Come indicato in precedenza in questo argomento, il documento PDF deve essere un documento PDF non interattivo. Se si tenta di convertire un documento PDF interattivo in un file PostScript, viene generata un'eccezione.
Impostare le opzioni di esecuzione della conversione
Durante la conversione di un documento PDF in un file PostScript, è possibile definire le opzioni di esecuzione che specificano il tipo PostScript creato. Ad esempio, è possibile definire un file PostScript di livello 3.
In genere, il file PostScript generato riflette le dimensioni del documento PDF di input. Se si seleziona l'opzione ShrinkToFit
(che riduce l'output del file PostScript per adattarlo alla pagina), non si vedrà una differenza tra il documento PDF di input e il file PostScript generato. L’opzione ShrinkToFit
ha effetto solo se si sceglie di stampare su una pagina di dimensioni inferiori rispetto al documento PDF di input. Per selezionare una dimensione di pagina più piccola, definisci l’opzione PageSize
. Inoltre, si consiglia di impostare l'opzione RotateAndCenter
su true
per ottenere l'output PostScript corretto.
Allo stesso modo, se si seleziona l'opzione ExpandToFit
(che espande l'output del file PostScript per adattarlo alla pagina), l'operazione ha effetto solo se si sceglie di stampare su una pagina di dimensioni maggiori rispetto al documento PDF di input. Per selezionare una dimensione di pagina maggiore, definisci l’opzione PageSize
. Inoltre, si consiglia di impostare l'opzione RotateAndCenter
su true
per ottenere l'output PostScript corretto.
Per informazioni sui valori di esecuzione impostabili, vedere il riferimento alla classe ToPSOptionsSpec
in Riferimento API di AEM Forms.
Convertire il documento PDF in un file PostScript
Dopo aver creato il client di servizio e impostato le opzioni di esecuzione, è possibile richiamare l'operazione di conversione PostScript. Questa operazione richiede informazioni sul documento da convertire, compreso il livello PostScript preferito per il documento di destinazione.
Salva il file PostScript
Dopo aver convertito il documento PDF in PostScript, è possibile salvare l'output come file PostScript.
Consulta anche
Convertire un documento PDF in PS utilizzando l’API Java
Convertire un documento PDF in PS utilizzando l'API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Guida rapida alla conversione delle API del servizio PDF
Convertire un documento PDF in PostScript utilizzando l’API di servizio PDF (Java) Converti:
Includi file di progetto.
Includi file JAR client, ad esempio adobe-convertpdf-client.jar, nel percorso di classe del progetto Java.
Creare un client Converti PDF.
ServiceClientFactory
contenente le proprietà di connessione.ConvertPdfServiceClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Fare riferimento al documento PDF per la conversione in un file PostScript.
java.io.FileInputStream
utilizzando il relativo costruttore e passare un valore stringa che specifichi la posizione del documento PDF da convertire.com.adobe.idp.Document
che memorizza il documento PDF utilizzando il costruttore com.adobe.idp.Document
. Passa l'oggetto java.io.FileInputStream
che contiene il documento PDF.Imposta le opzioni di esecuzione della conversione.
ToPSOptionsSpec
richiamando il relativo costruttore.ToPSOptionsSpec
. Ad esempio, per definire il livello PostScript creato, richiamare il metodo setPsLevel
dell'oggetto ToPSOptionsSpec
e passare un valore di enumerazione PSLevel
che specifica il livello PostScript. Per informazioni su tutti i valori di runtime impostabili, vedere il riferimento alla classe ToPSOptionsSpec
in Riferimento API di AEM Forms.Convertire il documento PDF in un file PostScript.
Richiama il metodo toPS2
dell'oggetto ConvertPdfServiceClient
e passa i seguenti valori:
com.adobe.idp.Document
che rappresenta il documento PDF da convertire in un file PostScript.ToPSOptionsSpec
che specifica le opzioni di esecuzione PostScript.Il metodo toPS2
restituisce un oggetto Document
contenente il nuovo documento PostScript.
Salvare il file PostScript.
java.io.File
e assicurati che l'estensione del nome file sia .ps.copyToFile
dell'oggetto Document
per copiare il contenuto dell'oggetto Document
nel file (assicurarsi di utilizzare l'oggetto Document
restituito dal metodo toPS2
).Consulta anche
Avvio rapido (modalità SOAP): Conversione di un documento PDF in PostScript tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Convertire un documento PDF in PostScript utilizzando l'API di servizio PDF Convert (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/ConvertPDFService?WSDL&lc_version=9.0.1
.
Sostituisci localhost
con l'indirizzo IP del server che ospita AEM Forms.
Creare un client Converti PDF.
Creare un oggetto ConvertPdfServiceClient
utilizzando il relativo costruttore predefinito.
Creare un oggetto ConvertPdfServiceClient.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/ConvertPDFService?blob=mtom
). Non è necessario utilizzare l'attributo lc_version
. Tuttavia, specifica ?blob=mtom
.
Crea un oggetto System.ServiceModel.BasicHttpBinding
ottenendo il valore del campo ConvertPdfServiceClient.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à:
ConvertPdfServiceClient.ClientCredentials.UserName.UserName
.ConvertPdfServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Fare riferimento al documento PDF per la conversione in un file PostScript.
BLOB
utilizzando il relativo costruttore. L'oggetto BLOB
viene utilizzato per memorizzare un documento PDF convertito in un file PostScript.System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF da convertire e la modalità di apertura del 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 il relativo campo MTOM
con il contenuto dell'array di byte.Imposta le opzioni di esecuzione della conversione.
ToPSOptionsSpec
richiamando il relativo costruttore.ToPSOptionsSpec
. Ad esempio, per definire il livello PostScript creato, assegnare un valore di enumerazione PSLevel
al membro dati ToPSOptionsSpec
dell'oggetto psLevel
.Convertire il documento PDF in un file PostScript.
Richiama il metodo toPS2
dell'oggetto GeneratePDFServiceService
e passa i seguenti valori:
BLOB
che rappresenta il documento PDF da convertire in un file PostScriptToPSOptionsSpec
che specifica le opzioni di esecuzioneAl termine della conversione, estrarre i dati binari che rappresentano il documento PostScript accedendo alla proprietà BLOB
dell'oggetto MTOM
corrispondente. Restituisce un array di byte che è possibile scrivere in un file PostScript.
Salvare il file PostScript.
System.IO.FileStream
richiamando il relativo costruttore. Passa un valore stringa che rappresenta la posizione del file PS.BLOB
restituito dal metodo encryptPDFUsingPassword
. Compilare l’array di byte ottenendo il valore del campo BLOB
dell’oggetto MTOM
.System.IO.BinaryWriter
richiamandone il costruttore e passando l'oggetto System.IO.FileStream
.System.IO.BinaryWriter
dell'oggetto Write
e passando l'array di byte.Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
È possibile utilizzare il servizio Converti PDF per convertire programmaticamente i documenti PDF in formati immagine, quali JPEG, JPEG 2000, TIFF e PNG. Convertendo un documento PDF in un file di immagine, è possibile utilizzare il documento PDF come file di immagine. Ad esempio, è possibile inserire l'immagine in un sistema di gestione dei contenuti aziendali per lo storage.
Durante la conversione di un documento PDF in un’immagine, il servizio Converti PDF crea un’immagine separata per ogni pagina del documento. In altre parole, se il documento ha 20 pagine, il servizio Converti PDF crea 20 file di immagine. Durante la conversione di un documento PDF in un formato immagine, è possibile creare immagini singole per ogni pagina all’interno del documento PDF o un singolo file di immagine per l’intero documento PDF.
Per ulteriori informazioni sul servizio Converti PDF, vedere Riferimento servizi per AEM Forms.
Per convertire un documento PDF in uno qualsiasi dei tipi supportati, eseguire le operazioni seguenti:
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 conversione PDF
Prima di poter eseguire in modo programmatico un’operazione del servizio Converti PDF, è necessario creare un client di servizio Converti PDF. Se utilizzi l’API Java, crea un oggetto ConvertPdfServiceClient
. Se utilizzi l’API del servizio Web, crea un oggetto ConvertPDFServiceService
.
Recupera il documento PDF da convertire
È necessario recuperare il documento PDF per convertirlo in un’immagine. Non è possibile convertire un documento PDF interattivo in un’immagine. Se tenti di farlo, viene generata un'eccezione. Per convertire un documento PDF interattivo in un file di immagine, è necessario appiattire il documento PDF prima di convertirlo. (Vedere Flattening dei documenti PDF.)
Impostare le opzioni di esecuzione
È necessario impostare le opzioni di esecuzione, ad esempio il formato immagine e i valori di risoluzione. Per informazioni sui valori di runtime, consulta il riferimento alla classe ToImageOptionsSpec
in Riferimento API di AEM Forms.
Convertire il PDF in un’immagine
Dopo aver creato il client di servizio e impostato le opzioni di esecuzione, è possibile convertire il documento PDF in un'immagine. Viene restituito un oggetto raccolta contenente le immagini.
Recuperare i file immagine da una raccolta
È possibile recuperare i file immagine da un oggetto raccolta restituito dal servizio Converti PDF. Ogni elemento della raccolta è un'istanza com.adobe.idp.Document
(o un'istanza BLOB
se utilizzi i servizi web) che puoi salvare come file di immagine, ad esempio un file JPG.
Il formato del file di immagine dipende dall'opzione ImageConvertFormat
runtime. In altre parole, se imposti l'opzione ImageConvertFormat
run-time su ImageConvertFormat.JPEG
, puoi salvare i file immagine come file JPG.
Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Guida rapida alla conversione delle API del servizio PDF
Convertire un documento PDF in un formato immagine utilizzando l’API del servizio Converti PDF (Java):
Includi file di progetto.
Includi file JAR client, ad esempio adobe-convertpdf-client.jar, nel percorso di classe del progetto Java.
Creare un client Converti PDF.
ServiceClientFactory
contenente le proprietà di connessione.ConvertPdfServiceClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Recuperare il documento PDF da convertire.
java.io.FileInputStream
che rappresenta il documento PDF da convertire utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento PDF.com.adobe.idp.Document
utilizzando il relativo costruttore e passando l'oggetto java.io.FileInputStream
.Impostare le opzioni di esecuzione.
ToImageOptionsSpec
utilizzando il relativo costruttore.setImageConvertFormat
e passando un valore di enum ImageConvertFormat
che specifica il tipo di formato.L'impostazione del valore di enumerazione ImageConvertFormat
è obbligatoria.
Converti il PDF in un’immagine.
Richiama il metodo toImage2
dell'oggetto ConvertPdfServiceClient
e passa i seguenti valori:
com.adobe.idp.Document
che rappresenta il file PDF da convertire.com.adobe.livecycle.converpdfservice.client.ToImageOptionsSpec
che contiene le varie preferenze relative al formato immagine di destinazione.Il metodo toImage2
restituisce un oggetto java.util.List
che contiene immagini. Ogni elemento della raccolta è un'istanza com.adobe.idp.Document
.
Recupera i file immagine da una raccolta.
Itera attraverso l'oggetto java.util.List
per determinare se le immagini sono presenti. Ogni elemento è un'istanza com.adobe.idp.Document
. Salvare l’immagine richiamando il metodo copyToFile
dell’oggetto java.io.File
e passando un oggetto com.adobe.idp.Document
.
Consulta anche
Avvio rapido (modalità SOAP): Conversione di un documento PDF in file JPEG utilizzando l’API Java
Convertire un documento PDF in un formato immagine utilizzando l’API del servizio PDF Converti (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/ConvertPDFService?WSDL&lc_version=9.0.1
.
Sostituisci localhost
con l'indirizzo IP del server che ospita AEM Forms.
Crea un client PDF convertito.
Creare un oggetto ConvertPdfServiceClient
utilizzando il relativo costruttore predefinito.
Creare un oggetto ConvertPdfServiceClient.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/ConvertPDFService?blob=mtom
). Non è necessario utilizzare l'attributo lc_version
. Tuttavia, specifica ?blob=mtom
.
Crea un oggetto System.ServiceModel.BasicHttpBinding
ottenendo il valore del campo ConvertPdfServiceClient.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à:
ConvertPdfServiceClient.ClientCredentials.UserName.UserName
.ConvertPdfServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Recuperare il documento PDF da convertire.
BLOB
utilizzando il relativo costruttore. Questo oggetto BLOB
viene utilizzato per memorizzare il modulo PDF.System.IO.FileStream
richiamando il relativo costruttore. Passare un valore stringa che specifichi la posizione del modulo PDF e la modalità di apertura del file.System.IO.FileStream
. Determina le dimensioni dell'array di byte ottenendo la proprietà Length
dell'oggetto System.IO.FileStream
.Read
dell’oggetto System.IO.FileStream
. Passa la matrice dei byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
assegnando il relativo campo MTOM
con il contenuto dell'array di byte.Impostare le opzioni di esecuzione.
ToImageOptionsSpec
utilizzando il relativo costruttore.setImageConvertFormat
e passando un valore di enumerazione ImageConvertFormat
che specifica il tipo di formato.L'impostazione del valore di enumerazione ImageConvertFormat
è obbligatoria.
Converti il PDF in un’immagine.
Richiama il metodo toImage2
dell'oggetto ConvertPDFServiceService
e passa i seguenti valori:
BLOB
che rappresenta il file da convertireToImageOptionsSpec
che contiene le varie preferenze relative al formato immagine di destinazioneIl metodo toImage2
restituisce un oggetto MyArrayOfBLOB
contenente i file di immagine appena creati.
Recupera i file immagine da una raccolta.
MyArrayOfBLOB
ottenendo il valore del relativo campo Count
. Ogni elemento è un oggetto BLOB
che contiene l'immagine.MyArrayOfBLOB
e salva ogni file di immagine.Consulta anche