Utilizzo dei documenti PDF/A

Informazioni sul servizio DocConverter

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

NOTA

Per ulteriori informazioni sul servizio DocConverter, vedi 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 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, 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.

NOTA

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

Riepilogo dei passaggi

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

  1. Includi file di progetto.
  2. Creare un client DocConvert
  3. Fare riferimento a un documento PDF per la conversione in documento PDF/A.
  4. Imposta le informazioni di tracciamento.
  5. Converti 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, 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

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

  1. Includi file di progetto

    Includi file JAR client, come adobe-docconverter-client.jar, nel percorso di classe del progetto Java.

  2. Creare un client DocConvert

    • Crea un ServiceClientFactory oggetto contenente le proprietà di connessione.
    • Crea un DocConverterServiceClient utilizzando il relativo costruttore e passando ServiceClientFactory oggetto.
  3. 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 passando java.io.FileInputStream oggetto.
  4. Impostare le informazioni di tracciamento

    • Crea un PDFAConversionOptionSpec utilizzando il relativo costruttore.
    • Imposta il livello di tracciamento delle informazioni richiamando il PDFAConversionOptionSpec dell’oggetto setLogLevel e passare un valore stringa che specifica il livello di tracciamento. Ad esempio, passa il valore FINE. Per informazioni sui diversi valori, consulta la sezione setLogLevel nel Riferimento API di AEM Forms.
  5. Conversione del documento

    Convertire il documento PDF in un documento PDF/A richiamando il DocConverterServiceClient dell’oggetto toPDFA 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 un PDFAConversionResult oggetto contenente il documento PDF/A.

  6. Salvare il documento PDF/A

    • Recupera il documento PDF/A richiamando il PDFAConversionResult dell’oggetto getPDFA metodo . Questo metodo restituisce un com.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’oggetto copyToFile e passare java.io.File oggetto.

Consulta anche

Utilizzo dei documenti PDF/A

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

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 la WSDL DocConverter.
    • Fare riferimento all'assembly client Microsoft .NET.
  2. Creare un client DocConvert

    • Utilizzando l'assembly client Microsoft .NET, creare un DocConverterServiceService richiamando il relativo costruttore predefinito.
    • Imposta la DocConverterServiceService dell’oggetto Credentials membro con un System.Net.NetworkCredential che specifica il nome utente e il valore della password.
  3. Riferimento a un documento PDF per la conversione in documento PDF/A

    • Crea un BLOB utilizzando il relativo costruttore. La BLOB 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 il System.IO.FileStream dell’oggetto Length proprietà.
    • Compilare l'array di byte con i dati del flusso richiamando il System.IO.FileStream dell’oggetto Read e passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Popolare BLOB oggetto assegnando il relativo binaryData con il contenuto dell'array di byte.
  4. 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’oggetto logLevel membro dati. Ad esempio, assegna il valore FINE a questo membro dati.
  5. Conversione del documento

    Convertire il documento PDF in un documento PDF/A richiamando il DocConverterServiceService dell’oggetto toPDFA 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 un PDFAConversionResult oggetto contenente il documento PDF/A.

  6. Salvare il documento PDF/A

    • Crea un BLOB oggetto che memorizza il documento PDF/A ottenendo il valore del PDFAConversionResult dell’oggetto PDFADocument membro dati.
    • Creare un array di byte che memorizza il contenuto del BLOB oggetto restituito utilizzando PDFAConversionResult oggetto. Compilare l’array di byte ottenendo il valore del BLOB dell’oggetto binaryData 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 passando System.IO.FileStream oggetto.
    • Scrivi il contenuto dell’array di byte in un file PDF richiamando il System.IO.BinaryWriter dell’oggetto Write e passare l'array di byte.

Consulta anche

Utilizzo dei documenti PDF/A

Richiamo di 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 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.

NOTA

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

Riepilogo dei passaggi

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

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

Determina la conformità di PDF/A utilizzando l’API Java:

  1. Includi file di progetto

    Includi file JAR client, come adobe-docconverter-client.jar, nel percorso di classe del progetto Java.

  2. Creare un client DocConvert

    • Crea un ServiceClientFactory oggetto contenente le proprietà di connessione.
    • Crea un DocConverterServiceClient utilizzando il relativo costruttore e passando ServiceClientFactory oggetto.
  3. 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 passando java.io.FileInputStream oggetto.
  4. Impostare le opzioni di esecuzione

    • Crea un PDFAValidationOptionSpec utilizzando il relativo costruttore.
    • Imposta il livello di conformità richiamando il PDFAValidationOptionSpec dell’oggetto setCompliance metodo e passaggio PDFAValidationOptionSpec.Compliance.PDFA_1B.
    • Imposta il livello di tracciamento delle informazioni richiamando il PDFAValidationOptionSpec dell’oggetto setLogLevel e passare un valore stringa che specifica il livello di tracciamento. Ad esempio, passa il valore FINE. Per informazioni sui diversi valori, consulta la sezione setLogLevel nel Riferimento API di AEM Forms.
  5. Recupera informazioni sul documento PDF

    Determinare la conformità di PDF/A richiamando il DocConverterServiceClient dell’oggetto isPDFA 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 un PDFAValidationResult oggetto contenente 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 dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

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

Determina la conformità di PDF/A utilizzando l’API del servizio Web:

  1. Includi file di progetto

    • Creare un assembly client Microsoft .NET che utilizzi la WSDL DocConverter.
    • Fare riferimento all'assembly client Microsoft .NET.
  2. Creare un client DocConvert

    • Utilizzando l'assembly client Microsoft .NET, creare un DocConverterServiceService richiamando il relativo costruttore predefinito.
    • Imposta la DocConverterServiceService dell’oggetto Credentials membro con un System.Net.NetworkCredential che specifica il nome utente e il valore della password.
  3. Riferimento a un documento PDF utilizzato per determinare la conformità di PDF/A

    • Crea un BLOB utilizzando il relativo costruttore. La BLOB 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 il System.IO.FileStream dell’oggetto Length proprietà.
    • Compilare l'array di byte con i dati del flusso richiamando il System.IO.FileStream dell’oggetto Read e passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Popolare BLOB oggetto assegnando il relativo binaryData con il contenuto dell'array di byte.
  4. Impostare le opzioni di esecuzione

    • Crea un PDFAValidationOptionSpec utilizzando il relativo costruttore.
    • Imposta il livello di conformità assegnando il PDFAValidationOptionSpec dell’oggetto compliance membro dati con il valore PDFAConversionOptionSpec_Compliance.PDFA_1B.
    • Imposta il livello di tracciamento delle informazioni assegnando il PDFAValidationOptionSpec dell’oggetto resultLevel membro dati con il valore PDFAValidationOptionSpec_ResultLevel.DETAILED.
  5. Recupera informazioni sul documento PDF

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

    • La BLOB oggetto contenente il documento PDF.
    • La PDFAValidationOptionSpec oggetto contenente opzioni di esecuzione.

    La isPDFA restituisce un PDFAValidationResult oggetto contenente i risultati dell'operazione.

Consulta anche

Utilizzo dei documenti PDF/A

Richiamo di AEM Forms con codifica Base64

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

In questa pagina