Conversione di PostScript in documenti PDF

Informazioni su Distiller Service

Il servizio Distiller® converte i file PostScript®, Encapsulated PostScript (EPS) e PRN in file PDF compatti, affidabili e più sicuri in rete. Il servizio Distiller è spesso utilizzato per convertire grandi volumi di documenti stampati in documenti elettronici, come fatture e rendiconti. La conversione dei documenti in PDF consente inoltre alle aziende di inviare ai clienti una versione cartacea e una versione elettronica di un documento.

NOTA

Per ulteriori informazioni sul servizio Distiller, vedere Guida di riferimento dei servizi per AEM Forms.

Conversione di PostScript in documenti PDF

Questo argomento descrive come utilizzare Distiller Service API (Java e servizio Web) per convertire i file PostScript (PS), Encapsulated PostScript (EPS) e PRN in documenti PDF a livello di programmazione.

NOTA

Per ulteriori informazioni sul servizio Distiller, vedere Guida di riferimento dei servizi per AEM Forms.

NOTA

Per convertire i file PostScript in documenti PDF, è necessario installare uno dei seguenti file sul server in cui è installato AEM Forms: pacchetto ridistribuibile Acrobat 9 o Microsoft Visual C++ 2005.

Riepilogo dei passaggi

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

  1. Includere i file di progetto.
  2. Creare un client di servizi Distiller.
  3. Recuperate il file da convertire.
  4. Richiamate l’operazione di creazione del PDF.
  5. Salvare il documento PDF.

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 di servizi Distiller

Prima di eseguire un'operazione di servizio Distiller a livello di programmazione, è necessario creare un client di servizi Distiller. Se utilizzate l'API Java, create un oggetto DistillerServiceClient. Se utilizzate l'API del servizio Web, create un oggetto DistillerServiceService.

Recuperare il file da convertire

È necessario recuperare il file da convertire. Ad esempio, per convertire un file PS in un documento PDF, dovete recuperare il file PS.

Richiamo dell’operazione di creazione PDF

Dopo aver creato il client di servizi, potete richiamare l’operazione di creazione 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 file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Avvio rapido API di Output Service

Convertire un file PostScript in PDF utilizzando l'API Java

Convertite un file PostScript in un documento PDF utilizzando Distiller Service API (Java):

  1. Includere i file di progetto.

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

  2. Creare un client di servizi Distiller.

    • Creare un oggetto ServiceClientFactory che contiene le proprietà di connessione.
    • Creare un oggetto DistillerServiceClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.
  3. Recuperate il file da convertire.

    • Creare un oggetto java.io.FileInputStream che rappresenta il file da convertire utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del file.
    • Creare un oggetto com.adobe.idp.Document utilizzando il relativo costruttore e passando l'oggetto java.io.FileInputStream.
  4. Richiamate l’operazione di creazione del PDF.

    Richiamare il metodo DistillerServiceClient dell'oggetto createPDF e trasmettere i seguenti valori:

    • L'oggetto com.adobe.idp.Document che rappresenta il file PS, EPS o PRN da convertire
    • Un oggetto java.lang.String che contiene il nome del file da convertire
    • Un oggetto java.lang.String che contiene il nome delle impostazioni Adobe PDF da utilizzare
    • Un oggetto java.lang.String che contiene il nome delle impostazioni di protezione da utilizzare
    • Un oggetto com.adobe.idp.Document facoltativo che contiene le impostazioni da applicare durante la generazione del documento PDF
    • Un oggetto com.adobe.idp.Document facoltativo che contiene le informazioni sui metadati da applicare al documento PDF

    Il metodo createPDF restituisce un oggetto CreatePDFResult che contiene 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.

  5. Salvare il documento PDF.

    Per ottenere il documento PDF appena creato, effettuare le seguenti operazioni:

    • Richiamare il metodo CreatePDFResult dell'oggetto getCreatedDocument. Questo restituisce un oggetto com.adobe.idp.Document.
    • Richiamare il metodo com.adobe.idp.Document dell'oggetto copyToFile per estrarre il documento PDF.

    Analogamente, per ottenere il documento di registro, eseguire le operazioni seguenti.

    • Richiamare il metodo CreatePDFResult dell'oggetto getLogDocument. Questo restituisce un oggetto com.adobe.idp.Document.
    • Richiamare il metodo com.adobe.idp.Document dell'oggetto copyToFile per estrarre il documento di registro.

Consulta anche

Riepilogo dei passaggi

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

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

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

Convertite un file PostScript in un documento PDF utilizzando l'API di Distiller 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/DistillerService?WSDL&lc_version=9.0.1.

    NOTA

    Sostituire localhost con l'indirizzo IP del server che ospita AEM Forms.

  2. Creare un client di servizi Distiller.

    • Creare un oggetto DistillerServiceClient utilizzando il relativo costruttore predefinito.

    • Creare un oggetto DistillerServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passate un valore di stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/DistillerService?blob=mtom). Non è necessario utilizzare l'attributo lc_version. Questo attributo viene utilizzato quando create un riferimento a un servizio. Tuttavia, specificate ?blob=mtom per utilizzare MTOM.

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

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

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

      • Assegnare il nome utente del modulo AEM al campo DistillerServiceClient.ClientCredentials.UserName.UserName.
      • Assegnare il valore della password corrispondente al campo DistillerServiceClient.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. Recuperate il file da convertire.

    • Creare un oggetto BLOB utilizzando il relativo costruttore. Questo oggetto BLOB viene utilizzato per memorizzare il file da convertire in un documento PDF.
    • Creare un oggetto System.IO.FileStream richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file e la modalità in cui aprire il file.
    • Creare un array di byte che memorizza il contenuto dell'oggetto System.IO.FileStream. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà System.IO.FileStream dell'oggetto Length.
    • Compilare l'array di byte con i dati del flusso richiamando il metodo Read dell'oggetto System.IO.FileStream e passando l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l'oggetto BLOB assegnandone la proprietà MTOM con il contenuto dell'array di byte.
  4. Richiamate l’operazione di creazione del PDF.

    Richiamare il metodo DistillerServiceService dell'oggetto CreatePDF2 e trasmettere i seguenti valori obbligatori:

    • L'oggetto BLOB che rappresenta il file PS da convertire
    • Una stringa che contiene il nome percorso del file da convertire
    • Un oggetto stringa che contiene le impostazioni Adobe PDF da utilizzare (ad esempio, Standard)
    • Un oggetto stringa che contiene le impostazioni di protezione da utilizzare (ad esempio, No Security)
    • Un oggetto BLOB facoltativo che contiene le impostazioni da applicare durante la generazione del documento PDF
    • Un oggetto BLOB facoltativo che contiene le informazioni sui metadati da applicare al documento PDF
    • Un parametro di output BLOB utilizzato per memorizzare il documento PDF
    • Un parametro di output BLOB utilizzato per memorizzare il registro
  5. Salvare il documento PDF.

    • Creare un oggetto System.IO.FileStream richiamandone il costruttore. Passa un valore di 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 dell'oggetto BLOB restituito dal metodo CreatePDF2 (il parametro di output). Compilare l'array di byte ottenendo il valore del membro di dati BLOB dell'oggetto MTOM.
    • Creare un oggetto System.IO.BinaryWriter richiamandone il costruttore e passando l'oggetto System.IO.FileStream.
    • Scrivere il contenuto dell'array di byte in un file PDF richiamando il metodo System.IO.BinaryWriter dell'oggetto Write e passando l'array di byte.

Consulta anche

Riepilogo dei passaggi

Chiamata AEM Forms tramite MTOM

Chiamata AEM Forms tramite SwaRef

In questa pagina