Conversione di PostScript in documenti PDF converting-postscript-to-pdf-documents

Gli esempi e gli esempi contenuti in questo documento sono solo per l’ambiente AEM Forms su JEE.

Informazioni sul servizio Distiller about-the-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 viene spesso utilizzato per convertire grandi quantità di documenti stampati in documenti elettronici, come fatture e rendiconti. La conversione dei documenti in PDF consente inoltre alle aziende di inviare ai propri clienti una versione cartacea e una versione elettronica di un documento.

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

Conversione di documenti PostScript in documenti PDF converting-postscript-to-pdf-documents-inner

In questo argomento viene descritto come utilizzare l'API di Distiller Service (Java e servizio Web) per convertire in modo programmatico i file PostScript (PS), Encapsulated PostScript (EPS) e PRN in documenti PDF.

NOTE
Per ulteriori informazioni sul servizio Distiller, consulta Guida di riferimento dei servizi per AEM Forms.
NOTE
Per convertire i file PostScript in documenti PDF, è necessario che nel server che ospita AEM Forms sia installato uno dei seguenti pacchetti ridistribuibili: Acrobat 9 o Microsoft Visual C++ 2005.

Riepilogo dei passaggi summary-of-steps

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

  1. Includi file di progetto.
  2. Creazione di un client di servizio Distiller.
  3. Recuperate il file da convertire.
  4. Richiama l’operazione di creazione di PDF.
  5. Salvare il documento PDF.

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.

Creazione di un client di servizio Distiller

Prima di poter eseguire un'operazione di servizio Distiller a livello di programmazione, è necessario creare un client di servizio Distiller. Se utilizzi l’API Java, crea un’ DistillerServiceClient oggetto. Se utilizzi l’API del servizio web, crea un’ DistillerServiceService oggetto.

Recupera il file da convertire

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

Richiama l’operazione di creazione di PDF

Dopo aver creato il client del servizio, è possibile richiamare l'operazione di creazione PDF. Questa operazione richiede informazioni sul documento da convertire, incluso il percorso del documento di destinazione.

Salva 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 dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Avvio rapido API servizio di output

Convertire un file PostScript in PDF utilizzando l’API Java convert-a-postscript-file-to-pdf-using-the-java-api

Converti un file PostScript in documento PDF utilizzando l’API di servizio Distiller (Java):

  1. Includi file di progetto.

    Includi i file JAR client, come adobe-distiller-client.jar, nel percorso di classe del progetto Java.

  2. Creazione di un client di servizio Distiller.

    • Creare un ServiceClientFactory oggetto che contiene proprietà di connessione.
    • Creare un DistillerServiceClient mediante il costruttore e passando il ServiceClientFactory oggetto.
  3. Recuperate il file da convertire.

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

    Richiama DistillerServiceClient dell'oggetto createPDF e trasmettere i seguenti valori:

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

    Il createPDF il metodo restituisce un CreatePDFResult oggetto contenente il nuovo documento PDF e un file di registro che può essere generato. Il file di registro contiene in genere messaggi di errore o di avviso generati dalla richiesta di conversione.

  5. Salvare il documento PDF.

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

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

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

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

Consulta anche

Riepilogo dei passaggi

Guida rapida (modalità SOAP): conversione di un file PostScript in un documento PDF tramite l’API Java

Inclusione dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Conversione di un file PostScript in PDF tramite l’API del servizio web converting-a-postscript-file-to-pdf-using-the-web-service-api

Convertire un file PostScript in un documento PDF utilizzando l’API del servizio Distiller (servizio web):

  1. Includi 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.

    note note
    NOTE
    Sostituisci localhost con l’indirizzo IP del server che ospita AEM Forms.
  2. Creazione di un client di servizio Distiller.

    • Creare un DistillerServiceClient utilizzando il costruttore predefinito.

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

    • Creare un System.ServiceModel.BasicHttpBinding dell'oggetto ottenendo il valore del DistillerServiceClient.Endpoint.Binding campo. Invia il valore restituito a BasicHttpBinding.

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

    • Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:

      • Assegna al campo il nome utente dei moduli AEM DistillerServiceClient.ClientCredentials.UserName.UserName.
      • Assegna il valore password corrispondente al campo DistillerServiceClient.ClientCredentials.UserName.Password.
      • Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.
  3. Recuperate il file da convertire.

    • Creare un BLOB mediante il costruttore. Questo BLOB L'oggetto viene utilizzato per memorizzare il file da convertire in un documento PDF.
    • Creare un System.IO.FileStream richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file e la modalità di apertura del file in.
    • Creare una matrice di byte che memorizza il contenuto della System.IO.FileStream oggetto. È possibile determinare le dimensioni della matrice di byte ottenendo System.IO.FileStream dell'oggetto Length proprietà.
    • Compilare la matrice di byte con i dati di flusso richiamando System.IO.FileStream dell'oggetto Read e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Popolare il BLOB oggetto assegnando il relativo MTOM con il contenuto della matrice di byte.
  4. Richiama l’operazione di creazione di PDF.

    Richiama DistillerServiceService dell'oggetto CreatePDF2 e trasmettere i seguenti valori richiesti:

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

    • Creare un System.IO.FileStream richiamando il relativo costruttore. Passa un valore stringa che rappresenta la posizione del file del documento PDF firmato e la modalità di apertura del file.
    • Creare una matrice di byte che memorizza il contenuto della BLOB oggetto restituito da CreatePDF2 (il parametro di output). Popolare la matrice di byte ottenendo il valore della BLOB dell'oggetto MTOM membro dati.
    • Creare un System.IO.BinaryWriter oggetto richiamando il relativo costruttore e passando il System.IO.FileStream oggetto.
    • Scrivere il contenuto della matrice di byte in un file PDF richiamando System.IO.BinaryWriter dell'oggetto Write e passando la matrice di byte.

Consulta anche

Riepilogo dei passaggi

Richiamare AEM Forms tramite MTOM

Richiamare AEM Forms con SwaRef

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2