Utilizzo di documenti PDF/A

Informazioni sul servizio DocConverter

Il servizio DocConverter può convertire documenti PDF in documenti PDA/A. È possibile eseguire le seguenti attività con il seguente servizio:

NOTA

Per ulteriori informazioni sul servizio DocConverter, vedere Guida di riferimento dei 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 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 contiene contenuto audio e video. Prima di convertire un documento PDF in un documento PDF/A, accertarsi che il documento PDF non sia un documento PDF/A.

La specifica PDF/A-1 è costituita da due livelli di conformità, ossia 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 stabilisce che tutti i font sono incorporati nel documento PDF/A generato. Al momento, è supportato solo PDF/A-1b per la convalida (e la conversione).

Sebbene PDF/A sia lo standard per l'archiviazione di documenti PDF, non è obbligatorio utilizzare i PDF/A per l'archiviazione se un documento PDF standard soddisfa i requisiti aziendali. Lo scopo dello standard PDF/A è quello di creare un file PDF adatto per l'archiviazione a lungo termine e per la conservazione dei documenti.

NOTA

Per ulteriori informazioni sul servizio DocConverter, vedere Guida di riferimento dei servizi per AEM Forms.

Riepilogo dei passaggi

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

  1. Includere i file di progetto.
  2. Creare un client DocConvert
  3. Fare riferimento a un documento PDF per la conversione in documento PDF/A.
  4. Impostate le informazioni di tracciamento.
  5. Convertite il documento.
  6. Salvare il documento PDF/A.

Includi file di progetto

Includete i file necessari nel progetto di sviluppo. Se create un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate i servizi Web, accertatevi di includere i file proxy.

I seguenti file JAR devono essere aggiunti al percorso di 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, vedere Inclusione file libreria Java AEM Forms.

Creare un client DocConvert

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

Riferimento a un documento PDF da convertire in documento PDF/A

Recuperare un documento PDF da convertire in documento PDF/A. Se si tenta di convertire un documento PDF, ad esempio un modulo Acrobat , in un documento PDF/A, si verificherà un'eccezione.

Impostazione delle informazioni di tracciamento

È possibile 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 quante informazioni il servizio DocConverter tiene traccia quando converte un documento PDF in un documento PDF/A.

Conversione del documento

Dopo aver creato il client del servizio DocConverter, fare riferimento al documento PDF per convertire e impostare l'opzione di esecuzione che specifica il numero 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 l'API Java

Conversione di documenti in documenti PDF/A tramite l'API del servizio Web

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Determinazione programmatica della conformità PDF/A

Convertire i documenti in documenti PDF/A utilizzando l'API Java

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

  1. Includi file di progetto

    Includete file JAR client, ad esempio adobe-docconverter-client.jar, nel percorso di classe del progetto Java.

  2. Creare un client DocConvert

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

    • Creare un oggetto java.io.FileInputStream che rappresenta il documento PDF da convertire utilizzando il relativo costruttore e passando un valore di 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. Impostazione delle informazioni di tracciamento

    • Creare un oggetto PDFAConversionOptionSpec utilizzando il relativo costruttore.
    • Impostare il livello di tracciamento delle informazioni richiamando il metodo setLogLevel dell'oggetto PDFAConversionOptionSpec e passando un valore di stringa che specifica il livello di tracciamento. Ad esempio, passare il valore FINE. Per informazioni sui diversi valori, vedete il metodo setLogLevel in Guida di riferimento delle API di AEM Forms.
  5. Conversione del 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
    • L'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 PDFAConversionResult dell'oggetto getPDFA. Questo metodo restituisce un oggetto com.adobe.idp.Document che rappresenta il documento PDF/A.
    • Creare un oggetto java.io.File che rappresenti il file PDF/A. Accertatevi che l’estensione del nome file sia .pdf.
    • Compilare il file con dati PDF/A richiamando il metodo copyToFile dell'oggetto java.io.File e passando l'oggetto com.adobe.idp.Document.

Consulta anche

Utilizzo dei documenti PDF/A

Avvio rapido (modalità SOAP): Conversione di un documento in un documento PDF/A mediante l'API Java

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Convertire i documenti in documenti PDF/A utilizzando l'API del servizio Web

Convertire 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 utilizzi 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 di dati DocConverterServiceService dell'oggetto Credentials con un valore System.Net.NetworkCredential che specifica il nome utente e il valore della password.
  3. Riferimento a un documento PDF da convertire in documento PDF/A

    • Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare il documento PDF convertito in documento PDF/A.
    • Creare un oggetto 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à di apertura del file.
    • Creare un array di byte che memorizza il contenuto dell'oggetto System.IO.FileStream. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà System.IO.FileStream dell'oggetto Length.
    • Compilare l'array di byte con i dati del flusso richiamando il metodo Read dell'oggetto System.IO.FileStream e passando l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l'oggetto BLOB assegnandone la proprietà binaryData con il contenuto dell'array di byte.
  4. Impostazione delle informazioni di tracciamento

    • Creare un oggetto PDFAConversionOptionSpec utilizzando il relativo costruttore.
    • Impostare il livello di tracciamento delle informazioni assegnando un valore che specifica il livello di tracciamento al membro di dati PDFAConversionOptionSpec dell'oggetto logLevel. Ad esempio, assegnare il valore FINE a questo membro dati.
  5. Conversione del 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
    • L'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 di dati PDFAConversionResult dell'oggetto PDFADocument.
    • Creare un array di byte che memorizza il contenuto dell'oggetto BLOB restituito utilizzando l'oggetto PDFAConversionResult. Compilare l'array di byte ottenendo il valore del membro di dati BLOB dell'oggetto binaryData.
    • Creare un oggetto System.IO.FileStream richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file nel documento PDF/A.
    • Creare un oggetto System.IO.BinaryWriter richiamandone il costruttore e passando l'oggetto System.IO.FileStream.
    • Scrivere il contenuto dell'array di byte in un file PDF richiamando il metodo System.IO.BinaryWriter dell'oggetto Write e passando l'array di byte.

Consulta anche

Utilizzo dei documenti PDF/A

Richiamo AEM Forms con codifica Base64

Creazione di un assembly client .NET che utilizza la codifica Base64

Determinazione programmatica della conformità PDF/A

È possibile utilizzare il servizio DocConverter per determinare se un documento PDF è conforme allo standard PDF/A. Per informazioni su un documento PDF/A e su come convertire un documento PDF in documento PDF/A, vedere Conversione di documenti in documenti PDF/A.

NOTA

Per ulteriori informazioni sul servizio DocConverter, vedere Guida di riferimento dei servizi per AEM Forms.

Riepilogo dei passaggi

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

  1. Includere i file di progetto.
  2. Creare un client DocConvert
  3. Fare riferimento a un documento PDF utilizzato per determinare la conformità PDF/A.
  4. Impostare le opzioni di esecuzione.
  5. Recuperare informazioni sul documento PDF.

Includi file di progetto

Includete i file necessari nel progetto di sviluppo. Se create un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate i servizi Web, accertatevi di includere i file proxy.

I seguenti file JAR devono essere aggiunti al percorso di 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, vedere Inclusione file libreria Java AEM Forms.

Creare un client DocConvert

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

Riferimento a un documento PDF utilizzato per determinare la conformità PDF/A

Per determinare se il documento PDF è conforme allo standard PDF/A, è necessario fare riferimento a un documento PDF e passarlo al servizio DocConverter.

Impostazione delle opzioni di esecuzione

È possibile 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 quante informazioni il servizio DocConverter tiene traccia quando converte un documento PDF in un documento PDF/A.

Recupero di informazioni sul documento PDF

Dopo aver creato il client del servizio DocConverter, fare riferimento al documento PDF e impostare le opzioni di esecuzione, è possibile determinare se il documento PDF è conforme allo standard PDF/A.

Consulta anche

Determinare la conformità PDF/A tramite l'API Java

Determinazione della conformità PDF/A tramite l'API del servizio Web

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Determinare la conformità PDF/A utilizzando l'API Java

Determinare la conformità PDF/A utilizzando l'API Java:

  1. Includi file di progetto

    Includete file JAR client, ad esempio adobe-docconverter-client.jar, nel percorso di classe del progetto Java.

  2. Creare un client DocConvert

    • Creare un oggetto ServiceClientFactory che contiene 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 di 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. Impostazione delle opzioni di esecuzione

    • Creare un oggetto PDFAValidationOptionSpec utilizzando il relativo costruttore.
    • Impostare il livello di conformità richiamando il metodo PDFAValidationOptionSpec dell'oggetto setCompliance e passando PDFAValidationOptionSpec.Compliance.PDFA_1B.
    • Impostare il livello di tracciamento delle informazioni richiamando il metodo setLogLevel dell'oggetto PDFAValidationOptionSpec e passando un valore di stringa che specifica il livello di tracciamento. Ad esempio, passare il valore FINE. Per informazioni sui diversi valori, vedete il metodo setLogLevel in Guida di riferimento delle API di AEM Forms.
  5. Recupero di informazioni sul documento PDF

    Determinare la conformità 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.
    • L'oggetto PDFAValidationOptionSpec che specifica le opzioni di esecuzione.

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

Consulta anche

Utilizzo dei documenti PDF/A

Avvio rapido (modalità SOAP): Determinazione della conformità PDF/A tramite l'API Java

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Determinare la conformità PDF/A utilizzando l'API del servizio Web

Determinare la conformità PDF/A utilizzando l'API del servizio Web:

  1. Includi file di progetto

    • Creare un assembly client Microsoft .NET che utilizzi 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 di dati DocConverterServiceService dell'oggetto Credentials con un valore System.Net.NetworkCredential che specifica il nome utente e il valore della password.
  3. Riferimento a un documento PDF utilizzato per determinare la conformità PDF/A

    • Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare il documento PDF convertito in documento PDF/A.
    • Creare un oggetto 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à di apertura del file.
    • Creare un array di byte che memorizza il contenuto dell'oggetto System.IO.FileStream. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà System.IO.FileStream dell'oggetto Length.
    • Compilare l'array di byte con i dati del flusso richiamando il metodo Read dell'oggetto System.IO.FileStream e passando l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l'oggetto BLOB assegnandone la proprietà binaryData con il contenuto dell'array di byte.
  4. Impostazione delle opzioni di esecuzione

    • Creare un oggetto PDFAValidationOptionSpec utilizzando il relativo costruttore.
    • Impostare il livello di conformità assegnando al membro di dati compliance dell'oggetto PDFAConversionOptionSpec_Compliance.PDFA_1B il valore PDFAValidationOptionSpec.
    • Impostare il livello di tracciamento delle informazioni assegnando il membro di dati resultLevel dell'oggetto con il valore PDFAValidationOptionSpec_ResultLevel.DETAILED.PDFAValidationOptionSpec
  5. Recupero di informazioni sul documento PDF

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

    • L'oggetto BLOB che contiene il documento PDF.
    • L'oggetto PDFAValidationOptionSpec che contiene le opzioni di esecuzione.

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

Consulta anche

Utilizzo dei documenti PDF/A

Richiamo AEM Forms con codifica Base64

Creazione di un assembly client .NET che utilizza la codifica Base64

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free