Riepilogo dei passaggi
Per convertire un documento PDF in un documento PDF/A, effettuare le seguenti operazioni:
- Includi file di progetto.
- Creare un client DocConvert
- Fare riferimento a un documento PDF da convertire in un documento PDF/A.
- Imposta le informazioni di tracciamento.
- Convertire il documento.
- 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:
-
Includi file di progetto
Includi i file JAR client, come adobe-docconverter-client.jar, nel percorso di classe del progetto Java.
-
Creare un client DocConvert
- Creare un oggetto
ServiceClientFactory
contenente le proprietà di connessione. - Creare un oggetto
DocConverterServiceClient
utilizzando il relativo costruttore e passando l'oggettoServiceClientFactory
.
- Creare un oggetto
-
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'oggettojava.io.FileInputStream
.
- Creare un oggetto
-
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'oggettoPDFAConversionOptionSpec
e passando un valore stringa che specifica il livello di verifica. Ad esempio, passare il valoreFINE
. Per informazioni sui diversi valori, vedere il metodosetLogLevel
in Riferimento API di AEM Forms.
- Creare un oggetto
-
Converti il documento
Convertire il documento PDF in un documento PDF/A richiamando il metodo
toPDFA
dell'oggettoDocConverterServiceClient
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 oggettoPDFAConversionResult
che contiene il documento PDF/A. - L'oggetto
-
Salvare il documento PDF/A
- Recuperare il documento PDF/A richiamando il metodo
getPDFA
dell'oggettoPDFAConversionResult
. Questo metodo restituisce un oggettocom.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'oggettocom.adobe.idp.Document
e passando l'oggettojava.io.File
.
- Recuperare il documento PDF/A richiamando il metodo