Riepilogo dei passaggi

Per convertire un documento PDF in un documento PDF/A, effettuare le seguenti operazioni:

  1. Includi file di progetto.
  2. Creare un client DocConvert
  3. Fare riferimento a un documento PDF da convertire in un documento PDF/A.
  4. Imposta le informazioni di tracciamento.
  5. Convertire il documento.
  6. Salvare il documento PDF/A.

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, accertati di includere i file proxy.

I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-docconverter-client.jar
  • adobe-utilities.jar (richiesto se AEM Forms è distribuito sul server applicazioni JBoss)
  • jbossall-client.jar (richiesto se AEM Forms è distribuito sul server applicazioni JBoss)

Per informazioni sul percorso di questi file JAR, vedi Inclusi i file della libreria Java di AEM Forms.

Creare un client DocConvert

Prima di poter eseguire un'operazione DocConverter a livello di programmazione, è necessario creare un client DocConverter. Se si utilizza l'API Java, creare un oggetto DocConverterServiceClient. Se si utilizza l'API del servizio Web DocConverter, creare un oggetto DocConverterServiceService.

Fai riferimento a un documento PDF per la conversione in un documento PDF/A

Recuperare un documento PDF per convertirlo in un documento PDF/A. Se si tenta di convertire un documento PDF, ad esempio un modulo Acrobat, in un documento PDF/A, verrà generata un'eccezione.

Imposta informazioni di tracciamento

È possibile impostare un'opzione di run-time che determina la quantità di informazioni tracciate durante il processo di conversione. In altre parole, è possibile impostare nove livelli diversi che specificano la quantità di informazioni che il servizio DocConverter tiene traccia quando converte un documento PDF in un documento PDF/A.

Convertire il documento

Dopo aver creato il client del servizio DocConverter, fare riferimento al documento PDF per la conversione e impostare l'opzione di runtime che specifica la quantità di informazioni tracciate, è possibile convertire il documento PDF in un documento PDF/A.

Salvare il documento PDF/A

È possibile salvare il documento PDF/A come file PDF.

Consulta anche

Conversione di documenti in documenti PDF/A tramite API Java

Conversione di documenti in documenti PDF/A tramite l’API del servizio web

Inclusione dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Determinazione a livello di programmazione della conformità di PDF/A

Conversione di documenti in documenti PDF/A tramite API Java

Convertire un documento PDF in un documento PDF/A utilizzando l’API Java:

  1. Includi file di progetto

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

  2. Creare un client DocConvert

    • Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
    • Creare un oggetto DocConverterServiceClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.
  3. Fare riferimento a un documento PDF da convertire in un documento PDF/A

    • Creare un oggetto java.io.FileInputStream che rappresenta il documento PDF da convertire utilizzando il relativo costruttore e passando un valore stringa che specifica la posizione del file PDF.
    • Creare un oggetto com.adobe.idp.Document utilizzando il relativo costruttore e passando l'oggetto java.io.FileInputStream.
  4. Impostare le informazioni di tracciamento

    • Creare un oggetto PDFAConversionOptionSpec utilizzando il relativo costruttore.
    • Impostare il livello di verifica delle informazioni richiamando il metodo setLogLevel dell'oggetto PDFAConversionOptionSpec e passando un valore stringa che specifica il livello di verifica. Ad esempio, passare il valore FINE. Per informazioni sui diversi valori, vedere il metodo setLogLevel in Riferimento API di AEM Forms.
  5. Converti il documento

    Convertire il documento PDF in un documento PDF/A richiamando il metodo toPDFA dell'oggetto DocConverterServiceClient e passando i valori seguenti:

    • L'oggetto com.adobe.idp.Document che contiene il documento PDF da convertire
    • Oggetto PDFAConversionOptionSpec che specifica le informazioni di tracciamento

    Il metodo toPDFA restituisce un oggetto PDFAConversionResult che contiene il documento PDF/A.

  6. Salvare il documento PDF/A

    • Recuperare il documento PDF/A richiamando il metodo getPDFA dell'oggetto PDFAConversionResult. Questo metodo restituisce un oggetto com.adobe.idp.Document che rappresenta il documento PDF/A.
    • Creare un oggetto java.io.File che rappresenta il file PDF/A. Assicurati che l’estensione del nome file sia .pdf.
    • Compilare il file con dati PDF/A richiamando il metodo copyToFile dell'oggetto com.adobe.idp.Document e passando l'oggetto java.io.File.