Utilizzo dei documenti PDF/A working-with-pdf-a-documents
Informazioni sul servizio DocConverter
Il servizio DocConverter può convertire i documenti PDF in documenti PDA/A. Puoi eseguire queste attività utilizzando questo servizio:
- Conversione di documenti PDF in documenti PDF/A. (Vedi Conversione di documenti in documenti PDF/A.)
- Determinare se i documenti PDF sono documenti PDF/A. (Vedi Determinazione programmatica della conformità PDF/A.)
Conversione di documenti in documenti PDF/A converting-documents-to-pdf-a-documents
È possibile utilizzare il servizio DocConverter per convertire un documento PDF in un documento PDF/A. Poiché PDF/A è un formato di archiviazione per la conservazione a lungo termine del contenuto del documento, tutti i font vengono incorporati e il file non viene compresso. Di conseguenza, un documento PDF/A è generalmente più grande di un documento PDF standard. Inoltre, un documento PDF/A non include contenuti audio e video. Prima di convertire un documento PDF in un documento PDF/A, verificare che il documento PDF non sia un documento PDF/A.
La specifica PDF/A-1 è costituita da due livelli di conformità, ovvero A e B. La differenza principale tra i due è relativa al supporto della struttura logica (accessibilità), che non è necessario per il livello di conformità B. Indipendentemente dal livello di conformità, PDF/A-1 determina che tutti i font sono incorporati nel documento PDF/A generato. Al momento, la convalida (e la conversione) supporta solo PDF/A-1b.
Sebbene PDF/A sia lo standard per l’archiviazione dei documenti PDF, non è obbligatorio utilizzare PDF/A per l’archiviazione se un documento PDF standard soddisfa i requisiti aziendali. Lo scopo dello standard PDF/A è quello di stabilire un file PDF destinato alle esigenze di archiviazione e conservazione a lungo termine dei documenti.
Riepilogo dei passaggi summary-of-steps
Per convertire un documento PDF in un documento PDF/A, eseguire le operazioni seguenti:
- Includi file di progetto.
- Creare un client DocConvert
- Fare riferimento a un documento PDF per la conversione in documento PDF/A.
- Imposta le informazioni di tracciamento.
- Converti 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, assicurati 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 su JBoss Application Server)
- jbossall-client.jar (richiesto se AEM Forms è distribuito su JBoss Application Server)
Per informazioni sulla posizione di questi file JAR, vedi Inclusione dei file libreria Java di AEM Forms.
Creare un client DocConvert
Prima di eseguire un'operazione DocConverter a livello di programmazione, è necessario creare un client DocConverter. Se utilizzi l’API Java, crea un DocConverterServiceClient
oggetto. Se utilizzi l'API del servizio Web DocConverter, crea un DocConverterServiceService
oggetto.
Riferimento a un documento PDF per la conversione in documento PDF/A
Recupera un documento PDF da convertire 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.
Impostare le informazioni di tracciamento
Puoi impostare un’opzione di esecuzione che determina la quantità di informazioni tracciate durante il processo di conversione. In altre parole, è possibile impostare nove livelli diversi per specificare la quantità di informazioni che il servizio DocConverter tiene traccia quando converte un documento PDF in un documento PDF/A.
Conversione del documento
Dopo aver creato il client di servizio DocConverter, fare riferimento al documento PDF per convertire e impostare l'opzione di esecuzione che specifica la quantità di informazioni da tenere traccia, è 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
Convertire documenti in documenti PDF/A utilizzando l’API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Determinazione programmatica della conformità PDF/A
Conversione di documenti in documenti PDF/A tramite API Java convert-documents-to-pdf-a-documents-using-the-java-api
Convertire un documento PDF in un documento PDF/A utilizzando l’API Java:
-
Includi file di progetto
Includi file JAR client, come adobe-docconverter-client.jar, nel percorso di classe del progetto Java.
-
Creare un client DocConvert
- Crea un
ServiceClientFactory
oggetto contenente le proprietà di connessione. - Crea un
DocConverterServiceClient
utilizzando il relativo costruttore e passandoServiceClientFactory
oggetto.
- Crea un
-
Riferimento a un documento PDF per la conversione in documento PDF/A
- Crea 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 file PDF. - Crea un
com.adobe.idp.Document
utilizzando il relativo costruttore e passandojava.io.FileInputStream
oggetto.
- Crea un
-
Impostare le informazioni di tracciamento
- Crea un
PDFAConversionOptionSpec
utilizzando il relativo costruttore. - Imposta il livello di tracciamento delle informazioni richiamando il
PDFAConversionOptionSpec
dell’oggettosetLogLevel
e passare un valore stringa che specifica il livello di tracciamento. Ad esempio, passa il valoreFINE
. Per informazioni sui diversi valori, consulta la sezionesetLogLevel
nel Riferimento API di AEM Forms.
- Crea un
-
Conversione del documento
Convertire il documento PDF in un documento PDF/A richiamando il
DocConverterServiceClient
dell’oggettotoPDFA
e passando i seguenti valori:- La
com.adobe.idp.Document
oggetto contenente il documento PDF da convertire - La
PDFAConversionOptionSpec
oggetto che specifica le informazioni di tracciamento
La
toPDFA
restituisce unPDFAConversionResult
oggetto contenente il documento PDF/A. - La
-
Salvare il documento PDF/A
- Recupera il documento PDF/A richiamando il
PDFAConversionResult
dell’oggettogetPDFA
metodo . Questo metodo restituisce uncom.adobe.idp.Document
oggetto che rappresenta il documento PDF/A. - Crea un
java.io.File
oggetto che rappresenta il file PDF/A. Assicurati che l'estensione del nome file sia .pdf. - Compilare il file con i dati PDF/A richiamando il
com.adobe.idp.Document
dell’oggettocopyToFile
e passarejava.io.File
oggetto.
- Recupera il documento PDF/A richiamando il
Consulta anche
Avvio rapido (modalità SOAP): Conversione di un documento in un documento PDF/A tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Convertire documenti in documenti PDF/A utilizzando l’API del servizio Web convert-documents-to-pdf-a-documents-using-the-web-service-api
Convertire un documento PDF in un documento PDF/A utilizzando l’API DocConverter (servizio Web):
-
Includi file di progetto
- Creare un assembly client Microsoft .NET che utilizzi la WSDL DocConverter.
- Fare riferimento all'assembly client Microsoft .NET.
-
Creare un client DocConvert
- Utilizzando l'assembly client Microsoft .NET, creare un
DocConverterServiceService
richiamando il relativo costruttore predefinito. - Imposta la
DocConverterServiceService
dell’oggettoCredentials
membro con unSystem.Net.NetworkCredential
che specifica il nome utente e il valore della password.
- Utilizzando l'assembly client Microsoft .NET, creare un
-
Riferimento a un documento PDF per la conversione in documento PDF/A
- Crea un
BLOB
utilizzando il relativo costruttore. LaBLOB
viene utilizzato per memorizzare il documento PDF convertito in documento PDF/A. - Crea un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF e la modalità in cui aprire il file. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStream
oggetto. È possibile determinare le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStream
dell’oggettoLength
proprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStream
dell’oggettoRead
e passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOB
oggetto assegnando il relativobinaryData
con il contenuto dell'array di byte.
- Crea un
-
Impostare le informazioni di tracciamento
- Crea un
PDFAConversionOptionSpec
utilizzando il relativo costruttore. - Imposta il livello di tracciamento delle informazioni assegnando un valore che specifica il livello di tracciamento al
PDFAConversionOptionSpec
dell’oggettologLevel
membro dati. Ad esempio, assegna il valoreFINE
a questo membro dati.
- Crea un
-
Conversione del documento
Convertire il documento PDF in un documento PDF/A richiamando il
DocConverterServiceService
dell’oggettotoPDFA
e passando i seguenti valori:- La
BLOB
oggetto contenente il documento PDF da convertire - La
PDFAConversionOptionSpec
oggetto che specifica le informazioni di tracciamento
La
toPDFA
restituisce unPDFAConversionResult
oggetto contenente il documento PDF/A. - La
-
Salvare il documento PDF/A
- Crea un
BLOB
oggetto che memorizza il documento PDF/A ottenendo il valore delPDFAConversionResult
dell’oggettoPDFADocument
membro dati. - Creare un array di byte che memorizza il contenuto del
BLOB
oggetto restituito utilizzandoPDFAConversionResult
oggetto. Compilare l’array di byte ottenendo il valore delBLOB
dell’oggettobinaryData
membro dati. - Crea un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF/A. - Crea un
System.IO.BinaryWriter
richiamando il relativo costruttore e passandoSystem.IO.FileStream
oggetto. - Scrivi il contenuto dell’array di byte in un file PDF richiamando il
System.IO.BinaryWriter
dell’oggettoWrite
e passare l'array di byte.
- Crea un
Consulta anche
Richiamo di AEM Forms con codifica Base64
Creazione di un assembly client .NET che utilizza la codifica Base64
Determinazione programmatica della conformità PDF/A programmatically-determining-pdf-a-compliancy
È possibile utilizzare il servizio DocConverter per determinare se un documento PDF è conforme a PDF/A. Per informazioni su un documento PDF/A e su come convertire un documento PDF in un documento PDF/A, vedere Conversione di documenti in documenti PDF/A.
Riepilogo dei passaggi summary_of_steps-1
Per determinare la conformità di PDF/A, effettua le seguenti operazioni:
- Includi file di progetto.
- Creare un client DocConvert
- Fare riferimento a un documento PDF utilizzato per determinare la conformità di PDF/A.
- Impostare le opzioni di esecuzione.
- Recupera informazioni sul 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.
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 su JBoss Application Server)
- jbossall-client.jar (richiesto se AEM Forms è distribuito su JBoss Application Server)
Per informazioni sulla posizione di questi file JAR, vedi Inclusione dei file libreria Java di AEM Forms.
Creare un client DocConvert
Prima di eseguire un'operazione DocConverter a livello di programmazione, è necessario creare un client DocConverter. Se utilizzi l’API Java, crea un DocConverterServiceClient
oggetto. Se utilizzi l'API del servizio Web DocConverter, crea un DocConverterServiceService
oggetto.
Riferimento a un documento PDF utilizzato per determinare la conformità di PDF/A
Per determinare se il documento PDF è conforme a PDF/A, è necessario fare riferimento a un documento PDF e passarlo al servizio DocConverter.
Impostare le opzioni di esecuzione
Puoi impostare un’opzione di esecuzione che determina la quantità di informazioni tracciate durante il processo di conversione. In altre parole, è possibile impostare nove livelli diversi per specificare la quantità di informazioni che il servizio DocConverter tiene traccia quando converte un documento PDF in un documento PDF/A.
Recupera informazioni sul documento PDF
Dopo aver creato il client di servizio DocConverter, fare riferimento al documento PDF e impostare le opzioni di esecuzione, è possibile determinare se il documento di PDF è un documento conforme a PDF/A.
Consulta anche
Determinare la conformità di PDF/A utilizzando l’API Java
Determinare la conformità di PDF/A utilizzando l’API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Determinare la conformità di PDF/A utilizzando l’API Java determine-pdf-a-compliancy-using-the-java-api
Determina la conformità di PDF/A utilizzando l’API Java:
-
Includi file di progetto
Includi file JAR client, come adobe-docconverter-client.jar, nel percorso di classe del progetto Java.
-
Creare un client DocConvert
- Crea un
ServiceClientFactory
oggetto contenente le proprietà di connessione. - Crea un
DocConverterServiceClient
utilizzando il relativo costruttore e passandoServiceClientFactory
oggetto.
- Crea un
-
Riferimento a un documento PDF utilizzato per determinare la conformità di PDF/A
- Crea 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 file PDF. - Crea un
com.adobe.idp.Document
utilizzando il relativo costruttore e passandojava.io.FileInputStream
oggetto.
- Crea un
-
Impostare le opzioni di esecuzione
- Crea un
PDFAValidationOptionSpec
utilizzando il relativo costruttore. - Imposta il livello di conformità richiamando il
PDFAValidationOptionSpec
dell’oggettosetCompliance
metodo e passaggioPDFAValidationOptionSpec.Compliance.PDFA_1B
. - Imposta il livello di tracciamento delle informazioni richiamando il
PDFAValidationOptionSpec
dell’oggettosetLogLevel
e passare un valore stringa che specifica il livello di tracciamento. Ad esempio, passa il valoreFINE
. Per informazioni sui diversi valori, consulta la sezionesetLogLevel
nel Riferimento API di AEM Forms.
- Crea un
-
Recupera informazioni sul documento PDF
Determinare la conformità di PDF/A richiamando il
DocConverterServiceClient
dell’oggettoisPDFA
e passando i seguenti valori:- La
com.adobe.idp.Document
oggetto contenente il documento PDF. - La
PDFAValidationOptionSpec
oggetto che specifica le opzioni di esecuzione.
La
isPDFA
restituisce unPDFAValidationResult
oggetto contenente i risultati dell'operazione. - La
Consulta anche
Avvio rapido (modalità SOAP): Determinazione della conformità PDF/A tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Determinare la conformità di PDF/A utilizzando l’API del servizio Web determine-pdf-a-compliancy-using-the-web-service-api
Determina la conformità di PDF/A utilizzando l’API del servizio Web:
-
Includi file di progetto
- Creare un assembly client Microsoft .NET che utilizzi la WSDL DocConverter.
- Fare riferimento all'assembly client Microsoft .NET.
-
Creare un client DocConvert
- Utilizzando l'assembly client Microsoft .NET, creare un
DocConverterServiceService
richiamando il relativo costruttore predefinito. - Imposta la
DocConverterServiceService
dell’oggettoCredentials
membro con unSystem.Net.NetworkCredential
che specifica il nome utente e il valore della password.
- Utilizzando l'assembly client Microsoft .NET, creare un
-
Riferimento a un documento PDF utilizzato per determinare la conformità di PDF/A
- Crea un
BLOB
utilizzando il relativo costruttore. LaBLOB
viene utilizzato per memorizzare il documento PDF convertito in documento PDF/A. - Crea un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF e la modalità in cui aprire il file. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStream
oggetto. È possibile determinare le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStream
dell’oggettoLength
proprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStream
dell’oggettoRead
e passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOB
oggetto assegnando il relativobinaryData
con il contenuto dell'array di byte.
- Crea un
-
Impostare le opzioni di esecuzione
- Crea un
PDFAValidationOptionSpec
utilizzando il relativo costruttore. - Imposta il livello di conformità assegnando il
PDFAValidationOptionSpec
dell’oggettocompliance
membro dati con il valorePDFAConversionOptionSpec_Compliance.PDFA_1B
. - Imposta il livello di tracciamento delle informazioni assegnando il
PDFAValidationOptionSpec
dell’oggettoresultLevel
membro dati con il valorePDFAValidationOptionSpec_ResultLevel.DETAILED
.
- Crea un
-
Recupera informazioni sul documento PDF
Determinare la conformità di PDF/A richiamando il
DocConverterServiceService
dell’oggettoisPDFA
e passando i seguenti valori:- La
BLOB
oggetto contenente il documento PDF. - La
PDFAValidationOptionSpec
oggetto contenente opzioni di esecuzione.
La
isPDFA
restituisce unPDFAValidationResult
oggetto contenente i risultati dell'operazione. - La
Consulta anche
Richiamo di AEM Forms con codifica Base64
Creazione di un assembly client .NET che utilizza la codifica Base64