Conversione di PDF in file Postscript e di immagine converting-pdf-to-postscript-andimage-files
Informazioni sul servizio Converti PDF
Il servizio Convert PDF converte i documenti PDF in formato PostScript e in diversi formati 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.
Puoi eseguire queste attività utilizzando il servizio Convert PDF:
-
Convertire documenti PDF in PostScript.
-
Convertire i documenti PDF in formati immagine.
note note NOTE Per ulteriori informazioni sul servizio Convert PDF, consulta Riferimento servizi per AEM Forms.
Conversione di documenti PDF in PostScript converting-pdf-documents-to-postscript
In questo argomento viene descritto come utilizzare l’API di Convert PDF Service (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.
Riepilogo dei passaggi summary-of-steps
Per convertire un documento PDF in un file PostScript, eseguire le operazioni seguenti:
- Includi file di progetto.
- Creare un client di servizio Convert PDF.
- Fare riferimento al documento PDF per la conversione in un file PostScript.
- Imposta le opzioni di esecuzione della conversione.
- Convertire il documento PDF in un file PostScript.
- Salvare il file PostScript.
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 Convert PDF
Prima di poter eseguire in modo programmatico un’operazione del servizio Convert PDF, è necessario creare un client di servizio Convert PDF. Se utilizzi l’API Java, crea un ConvertPdfServiceClient
oggetto. Se utilizzi l’API del servizio Web, crea un ConvertPDFServiceService
oggetto.
Questa sezione utilizza la funzionalità del servizio Web introdotta in AEM Forms. Per accedere alle nuove funzionalità, è necessario creare l'oggetto proxy utilizzando lc_version
attributo. (Consultare "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 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 di input PDF. Se selezioni la ShrinkToFit
(che riduce l'output del file PostScript per adattarlo alla pagina), non si vedrà una differenza tra il documento di input PDF e il file PostScript generato. La ShrinkToFit
l’opzione ha effetto solo se si sceglie di stampare su una pagina di dimensioni inferiori rispetto al documento di input PDF. Per selezionare una dimensione di pagina più piccola, definisci la PageSize
opzione . Inoltre, è consigliabile impostare la variabile RotateAndCenter
opzione per true
per ottenere l'output PostScript corretto.
Allo stesso modo, se selezioni la ExpandToFit
(che espande l'output del file PostScript per adattarlo alla pagina), ha effetto solo se si sceglie di stampare su una pagina di dimensioni maggiori rispetto al documento di input PDF. Per selezionare una dimensione di pagina più grande, definisci la PageSize
opzione . Inoltre, è consigliabile impostare la variabile RotateAndCenter
opzione per true
per ottenere l'output PostScript corretto.
ToPSOptionsSpec
riferimento di classe 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
Avvio rapido dell’API per la conversione di PDF Service
Convertire un documento PDF in PS utilizzando l’API Java convert-a-pdf-document-to-ps-using-the-java-api
Convertire un documento PDF in PostScript utilizzando l’API Convert PDF Service (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 Convert PDF.
- Crea un
ServiceClientFactory
oggetto contenente le proprietà di connessione. - Crea un
ConvertPdfServiceClient
utilizzando il relativo costruttore e passandoServiceClientFactory
oggetto.
- Crea un
-
Fare riferimento al documento PDF per la conversione in un file PostScript.
- Crea un
java.io.FileInputStream
utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento PDF da convertire. - Crea un
com.adobe.idp.Document
oggetto che memorizza il documento PDF utilizzandocom.adobe.idp.Document
costruttore. Passa lajava.io.FileInputStream
oggetto contenente il documento PDF.
- Crea un
-
Imposta le opzioni di esecuzione della conversione.
- Crea un
ToPSOptionsSpec
richiamando il relativo costruttore. - Imposta le opzioni di esecuzione richiamando un metodo appropriato che appartiene al
ToPSOptionsSpec
oggetto. Ad esempio, per definire il livello PostScript creato, richiamare laToPSOptionsSpec
dell’oggettosetPsLevel
e passare unPSLevel
valore di enumerazione che specifica il livello PostScript. Per informazioni su tutti i valori di runtime che è possibile impostare, vedere laToPSOptionsSpec
riferimento di classe in Riferimento API di AEM Forms.
- Crea un
-
Convertire il documento PDF in un file PostScript.
Richiama il
ConvertPdfServiceClient
dell’oggettotoPS2
e passare i seguenti valori:- A
com.adobe.idp.Document
oggetto che rappresenta il documento PDF da convertire in un file PostScript. - A
ToPSOptionsSpec
oggetto che specifica le opzioni di esecuzione PostScript.
La
toPS2
restituisce unDocument
oggetto contenente il nuovo documento PostScript. - A
-
Salvare il file PostScript.
- Crea un
java.io.File
e assicurati che l'estensione del nome del file sia .ps. - Richiama il
Document
dell’oggettocopyToFile
per copiare il contenuto delDocument
al file (assicurati di utilizzareDocument
oggetto restituito datoPS2
metodo).
- Crea un
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 PS utilizzando l’API del servizio Web convert-a-pdf-document-to-ps-using-the-web-service-api
Convertire un documento PDF in PostScript utilizzando l’API Convert PDF 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/ConvertPDFService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms. -
Creare un client Convert PDF.
-
Crea un
ConvertPdfServiceClient
utilizzando il relativo costruttore predefinito. -
Crea un
ConvertPdfServiceClient.Endpoint.Address
utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. 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 illc_version
attributo. Tuttavia, specifica?blob=mtom
. -
Crea un
System.ServiceModel.BasicHttpBinding
ottenendo il valore delConvertPdfServiceClient.Endpoint.Binding
campo . Imposta il valore restituito suBasicHttpBinding
. -
Imposta la
System.ServiceModel.BasicHttpBinding
dell’oggettoMessageEncoding
campo 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
ConvertPdfServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore della password corrispondente al campo
ConvertPdfServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
- Assegnare il nome utente del modulo di AEM al campo
-
-
Fare riferimento al documento PDF per la conversione in un file PostScript.
- Crea un
BLOB
utilizzando il relativo costruttore. LaBLOB
viene utilizzato per memorizzare un documento PDF convertito in un file PostScript. - Crea un
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à in cui aprire il file. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStream
oggetto. È possibile determinare le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStream
dell’oggettoLength
proprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStream
dell’oggettoRead
e passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOB
oggetto assegnando il relativoMTOM
con il contenuto dell'array di byte.
- Crea un
-
Imposta le opzioni di esecuzione della conversione.
- Crea un
ToPSOptionsSpec
richiamando il relativo costruttore. - Impostare le opzioni di esecuzione assegnando un valore al
ToPSOptionsSpec
membro dati dell’oggetto. Ad esempio, per definire il livello PostScript creato, assegnare unPSLevel
valore di enumerazione nelToPSOptionsSpec
dell’oggettopsLevel
membro dati.
- Crea un
-
Convertire il documento PDF in un file PostScript.
Richiama il
GeneratePDFServiceService
dell’oggettotoPS2
e passare i seguenti valori:- A
BLOB
oggetto che rappresenta il documento PDF da convertire in un file PostScript - A
ToPSOptionsSpec
oggetto che specifica le opzioni di esecuzione
Al termine della conversione, estrarre i dati binari che rappresentano il documento PostScript accedendo al relativo
BLOB
dell’oggettoMTOM
proprietà. Restituisce un array di byte che è possibile scrivere in un file PostScript. - A
-
Salvare il file PostScript.
- Crea un
System.IO.FileStream
richiamando il relativo costruttore. Passa un valore stringa che rappresenta la posizione del file PS. - Creare un array di byte che memorizza il contenuto dei dati del
BLOB
oggetto restituito daencryptPDFUsingPassword
metodo . Compilare l’array di byte ottenendo il valore delBLOB
dell’oggettoMTOM
campo . - Crea un
System.IO.BinaryWriter
richiamando il relativo costruttore e passandoSystem.IO.FileStream
oggetto. - Scrivi il contenuto dell'array di byte al file PostScript richiamando il
System.IO.BinaryWriter
dell’oggettoWrite
e passare l'array di byte.
- Crea un
Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
Conversione di documenti PDF in formati immagine converting-pdf-documents-to-image-formats
È possibile utilizzare il servizio Convert 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 Convert PDF crea un’immagine separata per ogni pagina del documento. In altre parole, se il documento ha 20 pagine, il servizio Convert 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.
Riepilogo dei passaggi summary_of_steps-1
Per convertire un documento PDF in uno qualsiasi dei tipi supportati, eseguire le operazioni seguenti:
- Includi file di progetto.
- Creare un client di servizio Convert PDF.
- Recupera il documento PDF da convertire.
- Impostare le opzioni di esecuzione.
- Converti il PDF in un’immagine.
- Recupera i file immagine da una raccolta.
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 Convert PDF
Prima di poter eseguire in modo programmatico un’operazione del servizio Convert PDF, è necessario creare un client di servizio Convert PDF. Se utilizzi l’API Java, crea un ConvertPdfServiceClient
oggetto. Se utilizzi l’API del servizio Web, crea un ConvertPDFServiceService
oggetto.
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. (Vedi Flatting 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 la sezione ToImageOptionsSpec
riferimento di classe in Riferimento API di AEM Forms.
Convertire PDF in un’immagine
Dopo aver creato il client di servizio e impostato le opzioni di esecuzione, è possibile convertire il documento di 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 Convert PDF. Ogni elemento della raccolta è un com.adobe.idp.Document
istanza (o BLOB
se si utilizzano servizi Web) è possibile salvare come file immagine, ad esempio un file JPG.
Il formato del file di immagine dipende dal ImageConvertFormat
opzione di esecuzione. Se si imposta il ImageConvertFormat
opzione di esecuzione su ImageConvertFormat.JPEG
, è possibile salvare i file immagine come file di JPG.
Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido dell’API per la conversione di PDF Service
Convertire un documento PDF in file di immagini utilizzando l’API Java convert-a-pdf-document-to-image-files-using-the-java-api
Convertire un documento PDF in un formato immagine utilizzando l’API del servizio Convert 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 Convert PDF.
- Crea un
ServiceClientFactory
oggetto contenente le proprietà di connessione. - Crea un
ConvertPdfServiceClient
utilizzando il relativo costruttore e passandoServiceClientFactory
oggetto.
- Crea un
-
Recupera il documento PDF da convertire.
- Crea un
java.io.FileInputStream
oggetto che rappresenta il documento PDF da convertire utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento PDF. - Crea un
com.adobe.idp.Document
utilizzando il relativo costruttore e passandojava.io.FileInputStream
oggetto.
- Crea un
-
Impostare le opzioni di esecuzione.
- Crea un
ToImageOptionsSpec
utilizzando il relativo costruttore. - Richiama i metodi che appartengono a questo oggetto come richiesto. Ad esempio, imposta il tipo di immagine richiamando il
setImageConvertFormat
metodo e passaggio di unImageConvertFormat
valore enum che specifica il tipo di formato.
note note NOTE Impostazione della ImageConvertFormat
il valore di enumerazione è obbligatorio. - Crea un
-
Converti il PDF in un’immagine.
Richiama il
ConvertPdfServiceClient
dell’oggettotoImage2
e passare i seguenti valori:- A
com.adobe.idp.Document
oggetto che rappresenta il file PDF da convertire. - A
com.adobe.livecycle.converpdfservice.client.ToImageOptionsSpec
oggetto contenente le varie preferenze relative al formato immagine di destinazione.
La
toImage2
restituisce unjava.util.List
oggetto che contiene immagini. Ogni elemento della raccolta è uncom.adobe.idp.Document
istanza. - A
-
Recupera i file immagine da una raccolta.
Itera attraverso il
java.util.List
per determinare se le immagini sono presenti. Ogni elemento è uncom.adobe.idp.Document
istanza. Salva l’immagine richiamando ilcom.adobe.idp.Document
dell’oggettocopyToFile
e passare unjava.io.File
oggetto.
Consulta anche
Avvio rapido (modalità SOAP): Conversione di un documento PDF in file JPEG tramite l’API Java
Convertire un documento PDF in file di immagini utilizzando l’API del servizio Web convert-a-pdf-document-to-image-files-using-the-web-service-api
Convertire un documento PDF in un formato immagine utilizzando l’API Convert PDF 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/ConvertPDFService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms. -
Crea un client PDF convertito.
-
Crea un
ConvertPdfServiceClient
utilizzando il relativo costruttore predefinito. -
Crea un
ConvertPdfServiceClient.Endpoint.Address
utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. 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 illc_version
attributo. Tuttavia, specifica?blob=mtom
. -
Crea un
System.ServiceModel.BasicHttpBinding
ottenendo il valore delConvertPdfServiceClient.Endpoint.Binding
campo . Imposta il valore restituito suBasicHttpBinding
. -
Imposta la
System.ServiceModel.BasicHttpBinding
dell’oggettoMessageEncoding
campo 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
ConvertPdfServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore della password corrispondente al campo
ConvertPdfServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
- Assegnare il nome utente del modulo di AEM al campo
-
-
Recupera il documento PDF da convertire.
- Crea un
BLOB
utilizzando il relativo costruttore. QuestoBLOB
viene utilizzato per memorizzare il modulo PDF. - Crea un
System.IO.FileStream
richiamando il relativo costruttore. Passa un valore stringa che specifica la posizione del modulo PDF e la modalità di apertura del file. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStream
oggetto. Determina le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStream
dell’oggettoLength
proprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStream
dell’oggettoRead
metodo . Passa la matrice dei byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOB
oggetto assegnando il relativoMTOM
con il contenuto dell'array di byte.
- Crea un
-
Impostare le opzioni di esecuzione.
- Crea un
ToImageOptionsSpec
utilizzando il relativo costruttore. - Richiama i metodi che appartengono a questo oggetto come richiesto. Ad esempio, imposta il tipo di immagine richiamando il
setImageConvertFormat
metodo e passaggio di unImageConvertFormat
valore di enumerazione che specifica il tipo di formato.
note note NOTE Impostazione della ImageConvertFormat
il valore di enumerazione è obbligatorio. - Crea un
-
Converti il PDF in un’immagine.
Richiama il
ConvertPDFServiceService
dell’oggettotoImage2
e passare i seguenti valori:- A
BLOB
oggetto che rappresenta il file da convertire - A
ToImageOptionsSpec
oggetto contenente le varie preferenze relative al formato immagine di destinazione
La
toImage2
restituisce unMyArrayOfBLOB
che contiene i file immagine appena creati. - A
-
Recupera i file immagine da una raccolta.
- Determinare il numero di elementi nel
MyArrayOfBLOB
ottenendo il valore del relativoCount
campo . Ogni elemento è unBLOB
oggetto che contiene l'immagine. - Itera attraverso il
MyArrayOfBLOB
e salvare ogni file di immagine.
- Determinare il numero di elementi nel
Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef