Conversione di PDF in file PostScript e Image converting-pdf-to-postscript-andimage-files
Gli esempi e gli esempi contenuti in questo documento sono solo per AEM Forms in ambiente JEE.
Informazioni sul servizio Convert PDF
Il servizio Convert 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 del contenuto che non supportano i documenti PDF.
Puoi eseguire queste attività utilizzando il servizio Convert PDF:
- Convertire documenti PDF in PostScript.
- Converte i documenti PDF in formati immagine.
Conversione di documenti PDF in PostScript converting-pdf-documents-to-postscript
Questo argomento descrive come utilizzare l’API Convert PDF Service (Java e servizio web) per convertire in modo programmatico i documenti PDF in file PostScript. Il documento PDF convertito in un 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, effettuare le seguenti operazioni:
- Includi file di progetto.
- Creare un client del servizio Convert PDF.
- Fare riferimento al documento PDF per la conversione in un file PostScript.
- Impostare le opzioni di runtime di conversione.
- Converte il documento PDF in un file PostScript.
- Salva 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 a livello di programmazione un'operazione del servizio Convert PDF, è necessario creare un client del servizio Convert PDF. Se si utilizza l'API Java, creare un oggetto ConvertPdfServiceClient. Se si utilizza l'API del servizio Web, creare un oggetto ConvertPDFServiceService.
In questa sezione vengono utilizzate le funzionalità dei servizi web introdotte in AEM Forms. Per accedere a una nuova funzionalità, è necessario creare l'oggetto proxy utilizzando l'attributo lc_version. (Vedi "Accesso alle nuove funzionalità tramite i servizi Web" in Richiamo di AEM Forms tramite i servizi Web.)
Fai riferimento al documento PDF per convertirlo 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 runtime di conversione
Quando si converte un documento PDF in un file PostScript, è possibile definire opzioni di runtime che specificano il tipo di PostScript creato. Ad esempio, puoi definire un file PostScript di livello 3.
In genere, il file PostScript generato rifletterà le dimensioni del documento di input PDF. Se si seleziona l'opzione ShrinkToFit (che riduce l'output del file PostScript per adattarlo alla pagina), non verrà visualizzata alcuna differenza tra il documento di input PDF 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 di input PDF. Per selezionare una dimensione di pagina inferiore, definire l'opzione PageSize. È inoltre consigliabile impostare l'opzione RotateAndCenter su true per ottenere l'output PostScript corretto.
Analogamente, se si seleziona l'opzione ExpandToFit (che espande l'output del file PostScript per adattarlo alla pagina), l'opzione avrà effetto solo se si sceglie di stampare su una pagina di dimensioni maggiori rispetto al documento di input PDF. Per selezionare una pagina di dimensioni maggiori, definire l'opzione PageSize. È inoltre consigliabile impostare l'opzione RotateAndCenter su true per ottenere l'output PostScript corretto.
ToPSOptionsSpec in Riferimento API di AEM Forms.Convertire il documento PDF in un file PostScript
Dopo aver creato il client del servizio e impostato le opzioni di runtime, è possibile richiamare l'operazione di conversione PostScript. Questa operazione richiede informazioni sul documento da convertire, incluso 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 della libreria Java di AEM Forms
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 i file JAR client, come adobe-convertpdf-client.jar, nel percorso di classe del progetto Java.
-
Creare un client Convert PDF.
- Creare un oggetto
ServiceClientFactorycontenente le proprietà di connessione. - Creare un oggetto
ConvertPdfServiceClientutilizzando il relativo costruttore e passando l'oggettoServiceClientFactory.
- Creare un oggetto
-
Fare riferimento al documento PDF per la conversione in un file PostScript.
- Creare un oggetto
java.io.FileInputStreamutilizzando il relativo costruttore e passare un valore stringa che specifichi la posizione del documento PDF da convertire. - Creare un oggetto
com.adobe.idp.Documentche memorizza il documento PDF utilizzando il costruttorecom.adobe.idp.Document. Passa l'oggettojava.io.FileInputStreamche contiene il documento PDF.
- Creare un oggetto
-
Impostare le opzioni di runtime di conversione.
- Creare un oggetto
ToPSOptionsSpecrichiamando il relativo costruttore. - Impostare le opzioni di runtime richiamando un metodo appropriato appartenente all'oggetto
ToPSOptionsSpec. Per definire ad esempio il livello PostScript creato, richiamare il metodosetPsLeveldell'oggettoToPSOptionsSpece passare un valore di enumerazionePSLevelche specifica il livello PostScript. Per informazioni su tutti i valori di runtime che è possibile impostare, vedere il riferimento alla classeToPSOptionsSpecin Riferimento API di AEM Forms.
- Creare un oggetto
-
Converte il documento PDF in un file PostScript.
Richiama il metodo
toPS2dell'oggettoConvertPdfServiceCliente passa i seguenti valori:- Oggetto
com.adobe.idp.Documentche rappresenta il documento PDF da convertire in un file PostScript. - Oggetto
ToPSOptionsSpecche specifica le opzioni di runtime di PostScript.
Il metodo
toPS2restituisce un oggettoDocumentcontenente il nuovo documento PostScript. - Oggetto
-
Salva il file PostScript.
- Creare un oggetto
java.io.Filee verificare che l'estensione del nome file sia ps. - Richiamare il metodo
copyToFiledell'oggettoDocumentper copiare il contenuto dell'oggettoDocumentnel file (assicurarsi di utilizzare l'oggettoDocumentrestituito dal metodotoPS2).
- Creare un oggetto
Consulta anche
Guida rapida (modalità SOAP): conversione di un documento PDF in PostScript tramite API Java
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 del servizio PDF Convert (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/ConvertPDFService?WSDL&lc_version=9.0.1.note note NOTE Sostituisci localhostcon l'indirizzo IP del server che ospita AEM Forms. -
Creare un client Convert PDF.
-
Creare un oggetto
ConvertPdfServiceClientutilizzando il relativo costruttore predefinito. -
Creare un oggetto
ConvertPdfServiceClient.Endpoint.Addressutilizzando il costruttoreSystem.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'attributolc_version. Tuttavia, specificare?blob=mtom. -
Creare un oggetto
System.ServiceModel.BasicHttpBindingottenendo il valore del campoConvertPdfServiceClient.Endpoint.Binding. Eseguire il cast del valore restituito inBasicHttpBinding. -
Impostare il campo
MessageEncodingdell'oggettoSystem.ServiceModel.BasicHttpBindingsuWSMessageEncoding.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
ConvertPdfServiceClient.ClientCredentials.UserName.UserName. - Assegnare il valore della password corrispondente al campo
ConvertPdfServiceClient.ClientCredentials.UserName.Password. - Assegnare il valore costante
HttpClientCredentialType.Basical campoBasicHttpBindingSecurity.Transport.ClientCredentialType. - Assegnare il valore costante
BasicHttpSecurityMode.TransportCredentialOnlyal campoBasicHttpBindingSecurity.Security.Mode.
- Assegnare il nome utente dei moduli AEM al campo
-
-
Fare riferimento al documento PDF per la conversione in un file PostScript.
- Creare un oggetto
BLOButilizzando il relativo costruttore. L'oggettoBLOBviene utilizzato per memorizzare un documento PDF convertito in un file PostScript. - Creare un oggetto
System.IO.FileStreamrichiamandone il costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF da convertire 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àLengthdell'oggettoSystem.IO.FileStream. - Compilare la matrice di byte con i dati di flusso richiamando il metodo
Readdell'oggettoSystem.IO.FileStreame passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Compilare l'oggetto
BLOBassegnando il relativo campoMTOMal contenuto della matrice di byte.
- Creare un oggetto
-
Impostare le opzioni di runtime di conversione.
- Creare un oggetto
ToPSOptionsSpecrichiamando il relativo costruttore. - Impostare le opzioni di runtime assegnando un valore al membro dati dell'oggetto
ToPSOptionsSpec. Per definire ad esempio il livello PostScript creato, assegnare un valore di enumerazionePSLevelal membro datipsLeveldell'oggettoToPSOptionsSpec.
- Creare un oggetto
-
Converte il documento PDF in un file PostScript.
Richiama il metodo
toPS2dell'oggettoGeneratePDFServiceServicee passa i seguenti valori:- Oggetto
BLOBche rappresenta il documento PDF da convertire in un file PostScript - Oggetto
ToPSOptionsSpecche specifica le opzioni di runtime
Al termine della conversione, estrarre i dati binari che rappresentano il documento PostScript accedendo alla proprietà
MTOMdell'oggettoBLOB. Restituisce una matrice di byte che è possibile scrivere in un file PostScript. - Oggetto
-
Salva il file PostScript.
- Creare un oggetto
System.IO.FileStreamrichiamando il relativo costruttore. Passa un valore stringa che rappresenta la posizione del file PS. - Creare una matrice di byte che memorizza il contenuto dei dati dell'oggetto
BLOBrestituito dal metodoencryptPDFUsingPassword. Compilare la matrice di byte ottenendo il valore del campoMTOMdell'oggettoBLOB. - Creare un oggetto
System.IO.BinaryWriterrichiamandone il costruttore e passando l'oggettoSystem.IO.FileStream. - Scrivere il contenuto della matrice di byte nel file PostScript richiamando il metodo
Writedell'oggettoSystem.IO.BinaryWritere passando la matrice di byte.
- Creare un oggetto
Consulta anche
Conversione di documenti PDF in formati immagine converting-pdf-documents-to-image-formats
È possibile utilizzare il servizio Converti PDF per convertire in modo programmatico i documenti PDF in formati immagine, tra cui 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.
Quando si converte 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 contiene 20 pagine, il servizio Convert PDF crea 20 file di immagine. Quando si converte un documento PDF in un formato immagine, è possibile creare singole immagini per ogni pagina all'interno del documento PDF o un singolo file immagine per l'intero documento PDF.
Riepilogo dei passaggi summary_of_steps-1
Per convertire un documento PDF in uno qualsiasi dei tipi supportati, effettuare le seguenti operazioni:
- Includi file di progetto.
- Creare un client del servizio Convert PDF.
- Recuperare il documento PDF da convertire.
- Impostare le opzioni di runtime.
- 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 a livello di programmazione un'operazione del servizio Convert PDF, è necessario creare un client del servizio Convert PDF. Se si utilizza l'API Java, creare un oggetto ConvertPdfServiceClient. Se si utilizza l'API del servizio Web, creare un oggetto ConvertPDFServiceService.
Recupera il documento PDF da convertire
Recuperate il documento PDF per convertirlo in immagine. Impossibile 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 Appiattimento dei documenti di PDF.)
Impostare le opzioni di runtime
Impostate le opzioni di runtime, ad esempio il formato dell'immagine e i valori di risoluzione. Per informazioni sui valori di runtime, vedere il riferimento alla classe ToImageOptionsSpec in Riferimento API di AEM Forms.
Convertire il PDF in un'immagine
Dopo aver creato il client del servizio e aver impostato le opzioni di runtime, è possibile convertire il documento PDF in un'immagine. Viene restituito un insieme di immagini.
Recupera i file di immagine da una raccolta
È possibile recuperare i file di immagine da un oggetto insieme restituito dal servizio Convert PDF. Ogni elemento della raccolta è un'istanza com.adobe.idp.Document (o un'istanza BLOB se si utilizzano i servizi Web) che è possibile salvare come file di immagine, ad esempio un file JPG.
Il formato del file di immagine dipende dall'opzione di runtime ImageConvertFormat. In altre parole, se si imposta l'opzione di runtime ImageConvertFormat su ImageConvertFormat.JPEG, è possibile salvare i file immagine come file JPG.
Consulta anche
Inclusione dei file della libreria Java di AEM Forms
Convertire un documento PDF in file di immagine 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 PDF Convert (Java):
-
Includi file di progetto.
Includi i file JAR client, come adobe-convertpdf-client.jar, nel percorso di classe del progetto Java.
-
Creare un client Convert PDF.
- Creare un oggetto
ServiceClientFactorycontenente le proprietà di connessione. - Creare un oggetto
ConvertPdfServiceClientutilizzando il relativo costruttore e passando l'oggettoServiceClientFactory.
- Creare un oggetto
-
Recuperare il documento PDF da convertire.
- Creare un oggetto
java.io.FileInputStreamche rappresenta il documento PDF da convertire utilizzando il relativo costruttore e passando un valore stringa che specifica la posizione del documento PDF. - Creare un oggetto
com.adobe.idp.Documentutilizzando il relativo costruttore e passando l'oggettojava.io.FileInputStream.
- Creare un oggetto
-
Impostare le opzioni di runtime.
- Creare un oggetto
ToImageOptionsSpecutilizzando il relativo costruttore. - Richiama i metodi che appartengono a questo oggetto come richiesto. Ad esempio, impostare il tipo di immagine richiamando il metodo
setImageConvertFormate passando un valore enumImageConvertFormatche specifica il tipo di formato.
note note NOTE L'impostazione del valore di enumerazione ImageConvertFormatè obbligatoria. - Creare un oggetto
-
Converti il PDF in un’immagine.
Richiama il metodo
toImage2dell'oggettoConvertPdfServiceCliente passa i seguenti valori:- Oggetto
com.adobe.idp.Documentche rappresenta il file PDF da convertire. - Oggetto
com.adobe.livecycle.converpdfservice.client.ToImageOptionsSpeccontenente le varie preferenze relative al formato immagine di destinazione.
Il metodo
toImage2restituisce un oggettojava.util.Listcontenente immagini. Ogni elemento della raccolta è un'istanzacom.adobe.idp.Document. - Oggetto
-
Recupera i file immagine da una raccolta.
Scorrere l'oggetto
java.util.Listper determinare se le immagini sono presenti. Ogni elemento è un'istanzacom.adobe.idp.Document. Salvare l'immagine richiamando il metodocopyToFiledell'oggettocom.adobe.idp.Documente passando un oggettojava.io.File.
Consulta anche
Guida rapida (modalità SOAP): conversione di un documento PDF in file JPEG tramite l’API Java
Convertire un documento PDF in file immagine utilizzando l’API del servizio web convert-a-pdf-document-to-image-files-using-the-web-service-api
Converti un documento PDF in un formato immagine utilizzando l’API del servizio PDF (servizio web) Convert:
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/ConvertPDFService?WSDL&lc_version=9.0.1.note note NOTE Sostituisci localhostcon l'indirizzo IP del server che ospita AEM Forms. -
Creare un client di conversione PDF.
-
Creare un oggetto
ConvertPdfServiceClientutilizzando il relativo costruttore predefinito. -
Creare un oggetto
ConvertPdfServiceClient.Endpoint.Addressutilizzando il costruttoreSystem.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'attributolc_version. Tuttavia, specificare?blob=mtom. -
Creare un oggetto
System.ServiceModel.BasicHttpBindingottenendo il valore del campoConvertPdfServiceClient.Endpoint.Binding. Eseguire il cast del valore restituito inBasicHttpBinding. -
Impostare il campo
MessageEncodingdell'oggettoSystem.ServiceModel.BasicHttpBindingsuWSMessageEncoding.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
ConvertPdfServiceClient.ClientCredentials.UserName.UserName. - Assegnare il valore della password corrispondente al campo
ConvertPdfServiceClient.ClientCredentials.UserName.Password. - Assegnare il valore costante
HttpClientCredentialType.Basical campoBasicHttpBindingSecurity.Transport.ClientCredentialType. - Assegnare il valore costante
BasicHttpSecurityMode.TransportCredentialOnlyal campoBasicHttpBindingSecurity.Security.Mode.
- Assegnare il nome utente dei moduli AEM al campo
-
-
Recuperare il documento PDF da convertire.
- Creare un oggetto
BLOButilizzando il relativo costruttore. Questo oggettoBLOBviene utilizzato per memorizzare il modulo PDF. - Creare un oggetto
System.IO.FileStreamrichiamando il relativo costruttore. Passa un valore stringa che specifica la posizione del modulo PDF e la modalità di apertura del file in. - Creare una matrice di byte che memorizza il contenuto dell'oggetto
System.IO.FileStream. Determinare le dimensioni della matrice di byte ottenendo la proprietàLengthdell'oggettoSystem.IO.FileStream. - Compilare la matrice di byte con i dati di flusso richiamando il metodo
Readdell'oggettoSystem.IO.FileStream. Passare la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Compilare l'oggetto
BLOBassegnando il relativo campoMTOMal contenuto della matrice di byte.
- Creare un oggetto
-
Impostare le opzioni di runtime.
- Creare un oggetto
ToImageOptionsSpecutilizzando il relativo costruttore. - Richiama i metodi che appartengono a questo oggetto come richiesto. Ad esempio, impostare il tipo di immagine richiamando il metodo
setImageConvertFormate passando un valore di enumerazioneImageConvertFormatche specifica il tipo di formato.
note note NOTE L'impostazione del valore di enumerazione ImageConvertFormatè obbligatoria. - Creare un oggetto
-
Converti il PDF in un’immagine.
Richiama il metodo
toImage2dell'oggettoConvertPDFServiceServicee passa i seguenti valori:- Oggetto
BLOBche rappresenta il file da convertire - Oggetto
ToImageOptionsSpeccontenente le varie preferenze relative al formato immagine di destinazione
Il metodo
toImage2restituisce un oggettoMyArrayOfBLOBcontenente i file immagine appena creati. - Oggetto
-
Recupera i file immagine da una raccolta.
- Determinare il numero di elementi nell'oggetto
MyArrayOfBLOBottenendo il valore del relativo campoCount. Ogni elemento è un oggettoBLOBche contiene l'immagine. - Scorrere l'oggetto
MyArrayOfBLOBe salvare ogni file di immagine.
- Determinare il numero di elementi nell'oggetto
Consulta anche
Richiamare AEM Forms tramite MTOM
Richiamare AEM Forms con SwaRef