Utilizzo dei documenti di PDF/A

Ultimo aggiornamento: 29 novembre 2024
  • Argomenti:

Creato per:

  • Sviluppatore

Informazioni sul servizio DocConverter

Il servizio DocConverter può convertire i documenti PDF in documenti PDA/A. Puoi eseguire queste attività utilizzando questo servizio:

NOTE
Per ulteriori informazioni sul servizio DocConverter, vedere Riferimento servizi per AEM Forms.

Conversione di documenti in documenti PDF/A

È 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.

Gli standard di conformità PDF/A supportati includono PDF/A-1a, 1b, 2a, 2b, 3a e 3b.

NOTE
Per ulteriori informazioni sul servizio DocConverter, vedere Riferimento servizi per AEM Forms.

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.

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

Converti un documento PDF in un documento PDF/A utilizzando l’API DocConverter (servizio web):

  1. Includi file di progetto

    • Creare un assembly client Microsoft .NET che utilizza il WSDL DocConverter.
    • Fare riferimento all'assembly client Microsoft .NET.

  2. Creare un client DocConvert

    • Utilizzando l'assembly client Microsoft .NET, creare un oggetto DocConverterServiceService richiamando il relativo costruttore predefinito.
    • Impostare il membro dati Credentials dell'oggetto DocConverterServiceService con un valore System.Net.NetworkCredential che specifica il nome utente e il valore della password.

  3. Fare riferimento a un documento PDF da convertire in un documento PDF/A

    • Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare il documento PDF convertito in un documento PDF/A.
    • Creare un oggetto System.IO.FileStream richiamandone il 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 dell'oggetto System.IO.FileStream. È possibile determinare le dimensioni della matrice di byte ottenendo la proprietà Length dell'oggetto System.IO.FileStream.
    • Compilare la matrice di byte con i dati di flusso richiamando il metodo Read dell'oggetto System.IO.FileStream e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l'oggetto BLOB assegnando la relativa proprietà binaryData al contenuto della matrice di byte.

  4. Impostare le informazioni di tracciamento

    • Creare un oggetto PDFAConversionOptionSpec utilizzando il relativo costruttore.
    • Impostare il livello di rilevamento delle informazioni assegnando un valore che specifichi il livello di rilevamento al membro dati logLevel dell'oggetto PDFAConversionOptionSpec. Ad esempio, assegnare il valore FINE a questo membro dati.

  5. Converti il documento

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

    • L'oggetto BLOB 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

    • Creare un oggetto BLOB che memorizza il documento PDF/A ottenendo il valore del membro dati PDFADocument dell'oggetto PDFAConversionResult.
    • Creare una matrice di byte che memorizza il contenuto dell'oggetto BLOB restituito utilizzando l'oggetto PDFAConversionResult. Popolare la matrice di byte ottenendo il valore del membro dati binaryData dell'oggetto BLOB.
    • Creare un oggetto System.IO.FileStream richiamandone il costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF/A.
    • Creare un oggetto System.IO.BinaryWriter richiamandone il costruttore e passando l'oggetto System.IO.FileStream.
    • Scrivere il contenuto della matrice di byte in un file PDF richiamando il metodo Write dell'oggetto System.IO.BinaryWriter e passando la matrice di byte.

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

È 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.

NOTE
Per ulteriori informazioni sul servizio DocConverter, vedere Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

Per determinare la conformità di PDF/A, effettuare le seguenti operazioni:

  1. Includi file di progetto.
  2. Creare un client DocConvert
  3. Fai riferimento a un documento PDF utilizzato per determinare la conformità di PDF/A.
  4. Impostare le opzioni di runtime.
  5. 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 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 utilizzato per determinare la conformità di 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.

Recupera 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

Determinare la conformità di 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. Riferimento a un documento PDF utilizzato per determinare la conformità 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 opzioni di runtime

    • Creare un oggetto PDFAValidationOptionSpec utilizzando il relativo costruttore.
    • Impostare il livello di conformità richiamando il metodo setCompliance dell'oggetto PDFAValidationOptionSpec e passando PDFAValidationOptionSpec.Compliance.PDFA_1B.
    • Impostare il livello di verifica delle informazioni richiamando il metodo setLogLevel dell'oggetto PDFAValidationOptionSpec 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. Recuperare informazioni sul documento PDF

    Determinare la conformità di PDF/A richiamando il metodo isPDFA dell'oggetto DocConverterServiceClient e passando i valori seguenti:

    • L'oggetto com.adobe.idp.Document che contiene il documento PDF.
    • Oggetto PDFAValidationOptionSpec che specifica le opzioni di runtime.

    Il metodo isPDFA restituisce un oggetto PDFAValidationResult che contiene i risultati dell'operazione.

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