Conversione di PDF in file PostScript e immagine

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 del contenuto che non supportano documenti PDF.

È possibile eseguire le operazioni seguenti utilizzando il servizio Converti PDF:

  • Convertire i documenti PDF in PostScript.
  • Convertire i documenti PDF in formati immagine.
Nota

Per ulteriori informazioni sul servizio Converti PDF, consulta Riferimento servizi per AEM Forms.

Conversione di documenti PDF in PostScript

Questo argomento descrive come utilizzare l'API Convert PDF Service (Java e il servizio Web) per convertire i documenti PDF in file PostScript a livello di programmazione. Il documento PDF convertito in file PostScript deve essere un documento PDF non interattivo. Se si tenta di convertire un documento PDF interattivo in un file PostScript, viene generata un'eccezione.

Nota

Per ulteriori informazioni sul servizio Converti PDF, consulta Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

Per convertire un documento PDF in un file PostScript, effettuare le seguenti operazioni:

  1. Includere i file di progetto.
  2. Creare un client di servizi Converti PDF.
  3. Fare riferimento al documento PDF per la conversione in file PostScript.
  4. Impostare le opzioni di esecuzione della conversione.
  5. Convertire il documento PDF in un file PostScript.
  6. Salvare il file PostScript.

Includi file di progetto

Includete i file necessari nel progetto di sviluppo. Se create un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate i servizi Web, accertatevi di includere i file proxy.

Creare un client Converti PDF

Prima di eseguire un'operazione di servizio Converti PDF a livello di programmazione, è necessario creare un client di servizi Converti PDF. Se utilizzate l'API Java, create un ConvertPdfServiceClient oggetto. Se si utilizza l'API del servizio Web, creare 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 l' lc_version attributo . (vedere "Accesso a nuove funzionalità tramite i servizi Web" in Attivazione di moduli AEM tramite i serviziWeb.)

Fare riferimento al documento PDF per la conversione in file PostScript

Fare riferimento al documento PDF da convertire in 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.

Impostazione delle opzioni di esecuzione della conversione

Quando si converte 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 PDF di input. Se si seleziona l' ShrinkToFit opzione (che riduce l'output del file PostScript per adattarlo alla pagina), non si verificherà alcuna differenza tra il documento PDF di input e il file PostScript generato. L' ShrinkToFit opzione ha effetto solo se si seleziona la stampa su una dimensione di pagina inferiore rispetto al documento PDF di input. Per selezionare una dimensione pagina più piccola, definite l’ PageSize opzione. Inoltre, si consiglia di impostare l' RotateAndCenter opzione per true ottenere l'output PostScript corretto.

Analogamente, se si seleziona l' ExpandToFit opzione (che espande l'output del file PostScript per adattarlo alla pagina), l'operazione ha effetto solo se si seleziona la stampa su una pagina di dimensioni maggiori rispetto al documento PDF di input. Per selezionare una dimensione di pagina più grande, definite l’ PageSize opzione. Inoltre, si consiglia di impostare l' RotateAndCenter opzione per true ottenere l'output PostScript corretto.

Nota

Per informazioni sui valori di runtime che è possibile impostare, consultate il riferimento di ToPSOptionsSpec classe in Riferimento API AEM Forms.

Conversione del documento PDF in un file PostScript

Dopo aver creato il client del 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.

Salvare il file PostScript

Dopo aver convertito il documento PDF in PostScript, è possibile salvare l'output come file PostScript.

Consulta anche

Conversione di un documento PDF in PS tramite l'API Java

Conversione di un documento PDF in PS tramite l'API del servizio Web

Inclusione di file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Converti API servizio PDF - Avvio rapido

Conversione di un documento PDF in PS tramite l'API Java

Convertire un documento PDF in PostScript utilizzando l'API Convert PDF Service (Java):

  1. Includere i file di progetto.

    Includete file JAR client, ad esempio adobe-convertpdf-client.jar, nel percorso di classe del progetto Java.

  2. Creare un client Converti PDF.

    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un ConvertPdfServiceClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Fare riferimento al documento PDF per la conversione in file PostScript.

    • Creare un java.io.FileInputStream oggetto utilizzando il relativo costruttore e passare un valore di stringa che specifica la posizione del documento PDF da convertire.
    • Creare un com.adobe.idp.Document oggetto che memorizza il documento PDF utilizzando il com.adobe.idp.Document costruttore. Passa l' java.io.FileInputStream oggetto che contiene il documento PDF.
  4. Impostare le opzioni di esecuzione della conversione.

    • Creare un ToPSOptionsSpec oggetto richiamandone il costruttore.
    • Impostare le opzioni di esecuzione richiamando un metodo appropriato appartenente all' ToPSOptionsSpec oggetto. Ad esempio, per definire il livello PostScript creato, richiamare il metodo dell' ToPSOptionsSpec oggetto setPsLevel e passare un valore di PSLevel enumerazione che specifica il livello PostScript. Per informazioni su tutti i valori di runtime che è possibile impostare, consultate il riferimento alla ToPSOptionsSpec classe in Riferimento API perAEM Forms.
  5. Convertire il documento PDF in un file PostScript.

    Richiamare il metodo dell' ConvertPdfServiceClientoggetto e toPS2 passare i seguenti valori:

    • Un com.adobe.idp.Document oggetto che rappresenta il documento PDF da convertire in file PostScript.
    • Un ToPSOptionsSpec oggetto che specifica le opzioni di esecuzione PostScript.

    Il toPS2 metodo restituisce un Document oggetto che contiene il nuovo documento PostScript.

  6. Salvare il file PostScript.

    • Create un java.io.File oggetto e accertatevi che l'estensione del nome del file sia .ps.
    • Richiamare il metodo Document dell'oggetto copyToFile per copiare il contenuto dell' Document oggetto nel file (assicurarsi di utilizzare l' Document oggetto restituito dal toPS2 metodo).

Consulta anche

Riepilogo dei passaggi

Avvio rapido (modalità SOAP): Conversione di un documento PDF in PostScript tramite l'API Java

Inclusione di file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Conversione di un documento PDF in PS tramite l'API del servizio Web

Convertire un documento PDF in PostScript utilizzando l'API Convert PDF Service (servizio Web):

  1. Includere i 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.

    Nota

    Sostituire localhost con l'indirizzo IP del server in cui è installato AEM Forms.

  2. Creare un client Converti PDF.

    • Creare un ConvertPdfServiceClient oggetto utilizzando il relativo costruttore predefinito.

    • Creare un ConvertPdfServiceClient.Endpoint.Address oggetto utilizzando il System.ServiceModel.EndpointAddress costruttore. Passa un valore di stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/ConvertPDFService?blob=mtom.) Non è necessario utilizzare l' lc_version attributo. Tuttavia, specificate ?blob=mtom.

    • Creare un System.ServiceModel.BasicHttpBinding oggetto ottenendo il valore del ConvertPdfServiceClient.Endpoint.Binding campo. Inserite il valore restituito in BasicHttpBinding.

    • Impostare il campo System.ServiceModel.BasicHttpBinding dell' MessageEncoding oggetto su WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.

    • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:

      • 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.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.
  3. Fare riferimento al documento PDF per la conversione in file PostScript.

    • Creare un BLOB oggetto utilizzando il relativo costruttore. L' BLOB oggetto viene utilizzato per memorizzare un documento PDF convertito in un file PostScript.
    • Creare un System.IO.FileStream oggetto 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.
    • Creare un array di byte che memorizza il contenuto dell' System.IO.FileStream oggetto. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà dell' System.IO.FileStream oggetto Length .
    • Compilare l'array di byte con i dati del flusso richiamando il metodo dell' System.IO.FileStream Read oggetto e passando l'array di byte, la posizione iniziale e la lunghezza del flusso per la lettura.
    • Compilare l' BLOB oggetto assegnandone MTOM il campo con il contenuto dell'array di byte.
  4. Impostare le opzioni di esecuzione della conversione.

    • Creare un ToPSOptionsSpec oggetto richiamandone il costruttore.
    • Impostare le opzioni di esecuzione assegnando un valore al membro dati dell' ToPSOptionsSpec oggetto. Ad esempio, per definire il livello PostScript creato, assegnare un valore di PSLevel enumerazione al membro ToPSOptionsSpec dati dell' psLevel oggetto.
  5. Convertire il documento PDF in un file PostScript.

    Richiama il metodo dell’ GeneratePDFServiceService oggetto toPS2 e passa i seguenti valori:

    • Un BLOB oggetto che rappresenta il documento PDF da convertire in un file PostScript
    • Un oggetto ToPSOptionsSpec che specifica le opzioni di esecuzione

    Al termine della conversione, estrarre i dati binari che rappresentano il documento PostScript accedendo alla proprietà BLOB dell' MTOM oggetto. Questo restituisce un array di byte che è possibile scrivere in un file PostScript.

  6. Salvare il file PostScript.

    • Creare un System.IO.FileStream oggetto richiamandone il costruttore. Passate un valore di stringa che rappresenta la posizione del file PS.
    • Creare un array di byte che memorizza il contenuto dei dati dell' BLOB oggetto restituito dal encryptPDFUsingPassword metodo. Compilare l'array di byte ottenendo il valore del campo dell' BLOB oggetto MTOM .
    • Creare un System.IO.BinaryWriter oggetto richiamando il relativo costruttore e passando l' System.IO.FileStream oggetto.
    • Scrivere il contenuto dell'array di byte nel file PostScript richiamando il metodo dell' System.IO.BinaryWriter oggetto Write e passando l'array di byte.

Consulta anche

Riepilogo dei passaggi

Attivazione di moduli AEM tramite MTOM

Richiamo di moduli AEM con SwaRef

Conversione di documenti PDF in formati immagine

È possibile utilizzare il servizio Converti PDF per convertire in modo programmatico i documenti PDF in formati immagine, quali JPEG, JPEG 2000, TIFF e PNG. Convertendo un documento PDF in un file immagine, è possibile utilizzare il documento PDF come file immagine. Ad esempio, potete inserire l'immagine in un sistema di gestione del contenuto aziendale per l'archiviazione.

Durante la conversione di un documento PDF in un'immagine, il servizio Converti PDF crea un'immagine separata per ogni pagina del documento. 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 ciascuna pagina del documento PDF o un singolo file di immagine per l'intero documento PDF.

Nota

Per ulteriori informazioni sul servizio Converti PDF, consulta Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

Per convertire un documento PDF in uno dei tipi supportati, effettuare le seguenti operazioni:

  1. Includere i file di progetto.
  2. Creare un client di servizi Converti PDF.
  3. Recuperare il documento PDF da convertire.
  4. Impostare le opzioni di esecuzione.
  5. Convertire il PDF in un’immagine.
  6. Recuperate i file immagine da una raccolta.

Includi file di progetto

Includete i file necessari nel progetto di sviluppo. Se create un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate i servizi Web, accertatevi di includere i file proxy.

Creare un client Converti PDF

Prima di eseguire un'operazione di servizio Converti PDF a livello di programmazione, è necessario creare un client di servizi Converti PDF. Se utilizzate l'API Java, create un ConvertPdfServiceClient oggetto. Se si utilizza l'API del servizio Web, creare un ConvertPDFServiceService oggetto.

Recuperare il documento PDF da convertire

Per convertire un’immagine è necessario recuperare il documento PDF. Non è possibile convertire un documento PDF interattivo in un’immagine. Se tentate di farlo, viene generata un'eccezione. Per convertire un documento PDF interattivo in un file immagine, è necessario appiattire il documento PDF prima di convertirlo. (Vedere Conversione di documentiPDF).

Impostazione delle 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, consultate il riferimento alla ToImageOptionsSpec classe nella Guida di riferimento delle API diAEM Forms.

Conversione del PDF in un’immagine

Dopo aver creato il client del servizio e impostato le opzioni di esecuzione, è possibile convertire il documento PDF in un'immagine. Viene restituito un oggetto raccolta che contiene le immagini.

Recuperare i file di immagine da una raccolta

È possibile recuperare i file immagine da un oggetto raccolta restituito dal servizio Converti PDF. Ciascun elemento della raccolta è un' com.adobe.idp.Document istanza (o un' BLOB istanza se si utilizzano i servizi Web) che è possibile salvare come file di immagine, ad esempio un file JPG.

Il formato del file immagine dipende dall’opzione di ImageConvertFormat esecuzione. Se impostate l’opzione di ImageConvertFormat esecuzione su ImageConvertFormat.JPEG, potete salvare i file immagine come file JPG.

Consulta anche

Inclusione di file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Converti API servizio PDF - Avvio rapido

Conversione di un documento PDF in file di immagine mediante l'API Java

Convertire un documento PDF in un formato immagine utilizzando l'API del servizio Converti PDF (Java):

  1. Includere i file di progetto.

    Includete file JAR client, ad esempio adobe-convertpdf-client.jar, nel percorso di classe del progetto Java.

  2. Creare un client Converti PDF.

    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un ConvertPdfServiceClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Recuperare il documento PDF da convertire.

    • Creare 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.
    • Creare un com.adobe.idp.Document oggetto utilizzando il relativo costruttore e passando l' java.io.FileInputStream oggetto.
  4. Impostare le opzioni di esecuzione.

    • Creare un ToImageOptionsSpec oggetto utilizzando il relativo costruttore.
    • Richiama i metodi che appartengono a questo oggetto come richiesto. Ad esempio, impostare il tipo di immagine richiamando il setImageConvertFormat metodo e passando un valore di ImageConvertFormat enum che specifica il tipo di formato.
    Nota

    L'impostazione del valore di ImageConvertFormat enumerazione è obbligatoria.

  5. Convertire il PDF in un’immagine.

    Richiama il metodo dell’ ConvertPdfServiceClient oggetto toImage2 e passa i seguenti valori:

    • Un com.adobe.idp.Document oggetto che rappresenta il file PDF da convertire.
    • Un com.adobe.livecycle.converpdfservice.client.ToImageOptionsSpec oggetto che contiene le varie preferenze relative al formato immagine di destinazione.

    Il toImage2 metodo restituisce un java.util.List oggetto che contiene immagini. Ciascun elemento della raccolta è un' com.adobe.idp.Document istanza.

  6. Recuperate i file immagine da una raccolta.

    Scorrere l' java.util.List oggetto per determinare se le immagini sono presenti. Ogni elemento è un' com.adobe.idp.Document istanza. Salvate l'immagine richiamando il metodo dell' com.adobe.idp.Document oggetto copyToFile e passando un java.io.File oggetto.

Consulta anche

Avvio rapido (modalità SOAP): Conversione di un documento PDF in file JPEG mediante l'API Java

Conversione di un documento PDF in file immagine tramite l'API del servizio Web

Convertire un documento PDF in un formato immagine utilizzando l'API di servizio PDF Convert (servizio Web):

  1. Includere i 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.

    Nota

    Sostituire localhost con l'indirizzo IP del server in cui è installato AEM Forms.

  2. Creare un client PDF convertito.

    • Creare un ConvertPdfServiceClient oggetto utilizzando il relativo costruttore predefinito.

    • Creare un ConvertPdfServiceClient.Endpoint.Address oggetto utilizzando il System.ServiceModel.EndpointAddress costruttore. Passa un valore di stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/ConvertPDFService?blob=mtom.) Non è necessario utilizzare l' lc_version attributo. Tuttavia, specificate ?blob=mtom.

    • Creare un System.ServiceModel.BasicHttpBinding oggetto ottenendo il valore del ConvertPdfServiceClient.Endpoint.Binding campo. Inserite il valore restituito in BasicHttpBinding.

    • Impostare il campo System.ServiceModel.BasicHttpBinding dell' MessageEncoding oggetto su WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.

    • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:

      • 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.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.
  3. Recuperare il documento PDF da convertire.

    • Creare un BLOB oggetto utilizzando il relativo costruttore. Questo BLOB oggetto viene utilizzato per memorizzare il modulo PDF.
    • Creare un System.IO.FileStream oggetto richiamandone il costruttore. Passa un valore di stringa che specifica la posizione del modulo PDF e la modalità di apertura del file.
    • Creare un array di byte che memorizza il contenuto dell' System.IO.FileStream oggetto. Determinare la dimensione dell'array di byte ottenendo la System.IO.FileStream proprietà dell' Length oggetto.
    • Compilare l'array di byte con i dati del flusso richiamando il metodo dell' System.IO.FileStream oggetto Read . Passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l' BLOB oggetto assegnandone MTOM il campo con il contenuto dell'array di byte.
  4. Impostare le opzioni di esecuzione.

    • Creare un ToImageOptionsSpec oggetto utilizzando il relativo costruttore.
    • Richiama i metodi che appartengono a questo oggetto come richiesto. Ad esempio, impostare il tipo di immagine richiamando il setImageConvertFormat metodo e passando un valore di ImageConvertFormat enumerazione che specifica il tipo di formato.
    Nota

    L'impostazione del valore di ImageConvertFormat enumerazione è obbligatoria.

  5. Convertire il PDF in un’immagine.

    Richiama il metodo dell’ ConvertPDFServiceService oggetto toImage2 e passa i seguenti valori:

    • Un BLOB oggetto che rappresenta il file da convertire
    • Un ToImageOptionsSpec oggetto che contiene le varie preferenze relative al formato immagine di destinazione

    Il toImage2 metodo restituisce un MyArrayOfBLOB oggetto che contiene i file immagine appena creati.

  6. Recuperate i file immagine da una raccolta.

    • Determinare il numero di elementi nell' MyArrayOfBLOB oggetto ottenendo il valore del relativo Count campo. Ogni elemento è un BLOB oggetto che contiene l'immagine.
    • Eseguire un'iterazione sull' MyArrayOfBLOB oggetto e salvare ciascun file immagine.

Consulta anche

Attivazione di moduli AEM tramite MTOM

Richiamo di moduli AEM con SwaRef

In questa pagina