Utilizzo dei documenti di 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:
- Convertire documenti PDF in documenti PDF/A. (vedere Conversione di documenti in documenti PDF/A.)
- Determina se i documenti PDF sono documenti PDF/A. (vedere Determinazione a livello di programmazione della conformità di 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 sono incorporati e il file non è compresso. Di conseguenza, un documento PDF/A è generalmente più grande di un documento PDF standard. Inoltre, un documento PDF/A non contiene contenuti audio e video. Prima di convertire un documento PDF in un documento PDF/A, accertatevi 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 è richiesto per il livello di conformità B. Indipendentemente dal livello di conformità, PDF/A-1 impone che tutti i font siano incorporati all'interno del documento PDF/A generato. Al momento, solo PDF/A-1b è supportato nella convalida (e nella conversione).
Sebbene PDF/A sia lo standard per l’archiviazione dei documenti PDF PDF, non è obbligatorio utilizzarlo per l’archiviazione se un documento PDF standard soddisfa i requisiti aziendali. Lo scopo dello standard PDF/A è quello di stabilire un file PDF per esigenze di archiviazione a lungo termine e conservazione dei documenti.
Riepilogo dei passaggi summary-of-steps
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 sulla posizione di questi file JAR, vedi Inclusione dei 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 utilizzi l’API Java, crea un’ DocConverterServiceClient
oggetto. Se utilizzi l’API del servizio web DocConverter, crea un’ DocConverterServiceService
oggetto.
Fare riferimento a un documento PDF da convertire 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.
Impostare le 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.
Converti 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 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 i file JAR client, come adobe-docconverter-client.jar, nel percorso di classe del progetto Java.
-
Creare un client DocConvert
- Creare un
ServiceClientFactory
oggetto che contiene proprietà di connessione. - Creare un
DocConverterServiceClient
mediante il costruttore e passando ilServiceClientFactory
oggetto.
- Creare un
-
Fare riferimento a un documento PDF da convertire in un documento PDF/A
- Creare un
java.io.FileInputStream
oggetto 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
com.adobe.idp.Document
mediante il costruttore e passando iljava.io.FileInputStream
oggetto.
- Creare un
-
Impostare le informazioni di tracciamento
- Creare un
PDFAConversionOptionSpec
mediante il costruttore. - Imposta il livello di tracciamento delle informazioni richiamando
PDFAConversionOptionSpec
dell'oggettosetLogLevel
e passando un valore stringa che specifica il livello di tracciamento. Ad esempio, passa il valoreFINE
. Per informazioni sui diversi valori, vederesetLogLevel
metodo in Riferimento API di AEM Forms.
- Creare un
-
Converti il documento
Convertire il documento PDF in un documento PDF/A richiamando il
DocConverterServiceClient
dell'oggettotoPDFA
e fornendo i seguenti valori:- Il
com.adobe.idp.Document
oggetto contenente il documento PDF da convertire - Il
PDFAConversionOptionSpec
oggetto che specifica le informazioni di tracciamento
Il
toPDFA
il metodo restituisce unPDFAConversionResult
oggetto che contiene il documento PDF/A. - Il
-
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. - Creare un
java.io.File
oggetto che rappresenta il file PDF/A. Assicurati che l’estensione del nome file sia .pdf. - Popola il file con i dati di PDF/A richiamando il
com.adobe.idp.Document
dell'oggettocopyToFile
e passando iljava.io.File
oggetto.
- Recupera il documento PDF/A richiamando il
Consulta anche
Utilizzo dei documenti di PDF/A
Guida rapida (modalità SOAP): conversione di un documento in un documento PDF/A tramite l’API Java
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Conversione di documenti in documenti PDF/A tramite l’API del servizio web convert-documents-to-pdf-a-documents-using-the-web-service-api
Converti 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 utilizza il 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 il
DocConverterServiceService
dell'oggettoCredentials
membro dati con unSystem.Net.NetworkCredential
valore che specifica il nome utente e la password.
- Utilizzando l'assembly client Microsoft .NET, creare un
-
Fare riferimento a un documento PDF da convertire in un documento PDF/A
- Creare un
BLOB
mediante il costruttore. IlBLOB
L'oggetto viene utilizzato per memorizzare il documento PDF convertito in un documento PDF/A. - Creare un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF 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 ottenendoSystem.IO.FileStream
dell'oggettoLength
proprietà. - Compilare la matrice di byte con i dati di flusso richiamando
System.IO.FileStream
dell'oggettoRead
e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare il
BLOB
oggetto assegnando il relativobinaryData
con il contenuto della matrice di byte.
- Creare un
-
Impostare le informazioni di tracciamento
- Creare un
PDFAConversionOptionSpec
mediante il 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.
- Creare un
-
Converti il documento
Convertire il documento PDF in un documento PDF/A richiamando il
DocConverterServiceService
dell'oggettotoPDFA
e fornendo i seguenti valori:- Il
BLOB
oggetto contenente il documento PDF da convertire - Il
PDFAConversionOptionSpec
oggetto che specifica le informazioni di tracciamento
Il
toPDFA
il metodo restituisce unPDFAConversionResult
oggetto che contiene il documento PDF/A. - Il
-
Salvare il documento PDF/A
- Creare un
BLOB
oggetto che memorizza il documento PDF/A ottenendo il valore delPDFAConversionResult
dell'oggettoPDFADocument
membro dati. - Creare una matrice di byte che memorizza il contenuto della
BLOB
oggetto restituito utilizzandoPDFAConversionResult
oggetto. Popolare la matrice di byte ottenendo il valore dellaBLOB
dell'oggettobinaryData
membro dati. - Creare un
System.IO.FileStream
oggetto richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF/A. - Creare un
System.IO.BinaryWriter
oggetto richiamando il relativo costruttore e passando ilSystem.IO.FileStream
oggetto. - Scrivere il contenuto della matrice di byte in un file PDF richiamando
System.IO.BinaryWriter
dell'oggettoWrite
e passando la matrice di byte.
- Creare un
Consulta anche
Utilizzo dei documenti di PDF/A
Richiamare AEM Forms utilizzando la codifica Base64
Creazione di un assembly client .NET che utilizza la codifica Base64
Determinazione a livello di programmazione della conformità di 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, consulta Conversione di documenti in documenti PDF/A.
Riepilogo dei passaggi summary_of_steps-1
Per determinare la conformità di PDF/A, effettuare le seguenti operazioni:
- Includi file di progetto.
- Creare un client DocConvert
- Fai riferimento a un documento PDF utilizzato per determinare la conformità di PDF/A.
- Impostare le opzioni di runtime.
- Recuperare 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, 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 sulla posizione di questi file JAR, vedi Inclusione dei 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 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à PDF/A
È necessario fare riferimento a un documento PDF e passarlo al servizio DocConverter per determinare se il documento PDF è compatibile con PDF/A.
Impostare le opzioni di runtime
È 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 diversi livelli che specificano la quantità di informazioni che il servizio DocConverter tiene traccia quando converte un documento PDF in un documento PDF/A.
Recuperare informazioni sul documento PDF
Dopo aver creato il client del servizio DocConverter, aver creato un riferimento al documento PDF e aver impostato le opzioni di runtime, è possibile determinare se il documento PDF è compatibile con PDF/A.
Consulta anche
Determinare la conformità PDF/A utilizzando l’API Java
Determinare la conformità PDF/A utilizzando l’API del servizio web
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Determinare la conformità PDF/A utilizzando l’API Java determine-pdf-a-compliancy-using-the-java-api
Determinare la conformità di 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
ServiceClientFactory
oggetto che contiene proprietà di connessione. - Creare un
DocConverterServiceClient
mediante il costruttore e passando ilServiceClientFactory
oggetto.
- Creare un
-
Riferimento a un documento PDF utilizzato per determinare la conformità PDF/A
- Creare un
java.io.FileInputStream
oggetto 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
com.adobe.idp.Document
mediante il costruttore e passando iljava.io.FileInputStream
oggetto.
- Creare un
-
Impostare le opzioni di runtime
- Creare un
PDFAValidationOptionSpec
mediante il costruttore. - Impostare il livello di conformità richiamando
PDFAValidationOptionSpec
dell'oggettosetCompliance
metodo e passaggioPDFAValidationOptionSpec.Compliance.PDFA_1B
. - Imposta il livello di tracciamento delle informazioni richiamando
PDFAValidationOptionSpec
dell'oggettosetLogLevel
e passando un valore stringa che specifica il livello di tracciamento. Ad esempio, passa il valoreFINE
. Per informazioni sui diversi valori, vederesetLogLevel
metodo in Riferimento API di AEM Forms.
- Creare un
-
Recuperare informazioni sul documento PDF
Determinare la conformità PDF/A richiamando
DocConverterServiceClient
dell'oggettoisPDFA
e fornendo i seguenti valori:- Il
com.adobe.idp.Document
oggetto che contiene il documento PDF. - Il
PDFAValidationOptionSpec
oggetto che specifica le opzioni di runtime.
Il
isPDFA
il metodo restituisce unPDFAValidationResult
oggetto che contiene i risultati dell'operazione. - Il
Consulta anche
Utilizzo dei documenti di PDF/A
Quick Start (modalità SOAP): determinazione della conformità PDF/A tramite l’API Java
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Determinare la conformità PDF/A utilizzando l’API del servizio web determine-pdf-a-compliancy-using-the-web-service-api
Determinare la conformità di PDF/A utilizzando l’API del servizio web:
-
Includi file di progetto
- Creare un assembly client Microsoft .NET che utilizza il 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 il
DocConverterServiceService
dell'oggettoCredentials
membro dati con unSystem.Net.NetworkCredential
valore che specifica il nome utente e la password.
- Utilizzando l'assembly client Microsoft .NET, creare un
-
Riferimento a un documento PDF utilizzato per determinare la conformità PDF/A
- Creare un
BLOB
mediante il costruttore. IlBLOB
L'oggetto viene utilizzato per memorizzare il documento PDF convertito in un documento PDF/A. - Creare un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF 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 ottenendoSystem.IO.FileStream
dell'oggettoLength
proprietà. - Compilare la matrice di byte con i dati di flusso richiamando
System.IO.FileStream
dell'oggettoRead
e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare il
BLOB
oggetto assegnando il relativobinaryData
con il contenuto della matrice di byte.
- Creare un
-
Impostare le opzioni di runtime
- Creare un
PDFAValidationOptionSpec
mediante il costruttore. - Impostare il livello di conformità assegnando
PDFAValidationOptionSpec
dell'oggettocompliance
membro dati con il valorePDFAConversionOptionSpec_Compliance.PDFA_1B
. - Imposta il livello di tracciamento delle informazioni assegnando
PDFAValidationOptionSpec
dell'oggettoresultLevel
membro dati con il valorePDFAValidationOptionSpec_ResultLevel.DETAILED
.
- Creare un
-
Recuperare informazioni sul documento PDF
Determinare la conformità PDF/A richiamando
DocConverterServiceService
dell'oggettoisPDFA
e fornendo i seguenti valori:- Il
BLOB
oggetto che contiene il documento PDF. - Il
PDFAValidationOptionSpec
oggetto contenente opzioni di runtime.
Il
isPDFA
il metodo restituisce unPDFAValidationResult
oggetto che contiene i risultati dell'operazione. - Il
Consulta anche
Utilizzo dei documenti di PDF/A
Richiamare AEM Forms utilizzando la codifica Base64
Creazione di un assembly client .NET che utilizza la codifica Base64