Trabalhar com documentos PDF/A

Sobre o Serviço DocConverter

O serviço DocConverter pode converter documentos PDF em documentos PDA/A. Você pode realizar essas tarefas usando este serviço:

OBSERVAÇÃO

Para obter mais informações sobre o serviço DocConverter, consulte Referência de Serviços para AEM Forms.

Convertendo documentos em documentos PDF/A

Você pode usar o serviço Conversor de Documentos para converter um documento PDF em um documento PDF/A. Como o PDF/A é um formato de arquivo para a preservação de longo prazo do conteúdo do documento, todas as fontes são incorporadas e o arquivo é descompactado. Como resultado, um documento PDF/A normalmente é maior do que um documento PDF padrão. Além disso, um documento PDF/A não contém conteúdo de áudio e vídeo. Antes de converter um documento PDF em um documento PDF/A, verifique se o documento PDF não é um documento PDF/A.

A especificação PDF/A-1 consiste em dois níveis de conformidade, a saber, A e B. A principal diferença entre os dois é em relação ao suporte à estrutura lógica (acessibilidade), que não é necessário para o nível de conformidade B. Independentemente do nível de conformidade, o PDF/A-1 determina que todas as fontes sejam incorporadas dentro do documento PDF/A gerado. No momento, somente o PDF/A-1b é compatível com a validação (e conversão).

Embora o PDF/A seja o padrão para arquivamento de documentos PDF, não é obrigatório que o PDF/A seja usado para arquivamento se um documento PDF padrão atender aos requisitos de sua empresa. A finalidade do padrão PDF/A é estabelecer um arquivo PDF destinado a necessidades de arquivamento e preservação de documentos a longo prazo.

OBSERVAÇÃO

Para obter mais informações sobre o serviço DocConverter, consulte Referência de Serviços para AEM Forms.

Resumo das etapas

Para converter um documento PDF em um documento PDF/A, execute as seguintes etapas:

  1. Inclua arquivos de projeto.
  2. Criar um cliente DocConvert
  3. Faça referência a um documento PDF para conversão em um documento PDF/A.
  4. Defina as informações de rastreamento.
  5. Converta o documento.
  6. Salve o documento PDF/A.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.

Os seguintes arquivos JAR devem ser adicionados ao caminho de classe do seu projeto:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-docconverter-client.jar
  • adobe-utilities.jar (necessário se o AEM Forms for implantado no JBoss Application Server)
  • jbossall-client.jar (obrigatório se o AEM Forms for implantado no JBoss Application Server)

Para obter informações sobre a localização desses arquivos JAR, consulte Incluindo arquivos da biblioteca Java do AEM Forms.

Criar um cliente DocConvert

Antes de executar programaticamente uma operação DocConverter, você deve criar um cliente DocConverter . Se estiver usando a API do Java, crie um objeto DocConverterServiceClient . Se estiver usando a API do serviço da Web DocConverter, crie um objeto DocConverterServiceService.

Referência a um documento PDF para converter em um documento PDF/A

Recupere um documento PDF para converter em um documento PDF/A. Se você tentar converter um documento PDF, como um formulário Acrobat, em um documento PDF/A, ocorrerá uma exceção.

Definir informações de rastreamento

Você pode definir uma opção de tempo de execução que determina quantas informações são rastreadas durante o processo de conversão. Ou seja, você pode definir nove níveis diferentes que especificam quantas informações o serviço DocConverter rastreia ao converter um documento PDF em um documento PDF/A.

Converter o documento

Depois de criar o cliente do serviço DocConverter, faça referência ao documento PDF para converter e defina a opção de tempo de execução que especifica quantas informações são rastreadas, é possível converter o documento PDF em um documento PDF/A.

Salvar o documento PDF/A

Você pode salvar o documento PDF/A como um arquivo PDF.

Consulte também:

Converter documentos em documentos PDF/A usando a API Java

Converter documentos em documentos PDF/A usando a API de serviço da Web

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Determinação programática da conformidade do PDF/A

Converter documentos em documentos PDF/A usando a API Java

Converta um documento PDF em um documento PDF/A usando a API do Java:

  1. Incluir arquivos de projeto

    Inclua arquivos JAR do cliente, como adobe-docconverter-client.jar, no caminho de classe do seu projeto Java.

  2. Criar um cliente DocConvert

    • Crie um objeto ServiceClientFactory que contenha propriedades de conexão.
    • Crie um objeto DocConverterServiceClient usando seu construtor e transmitindo o objeto ServiceClientFactory.
  3. Referência a um documento PDF para converter em um documento PDF/A

    • Crie um objeto java.io.FileInputStream que represente o documento PDF a ser convertido usando seu construtor e transmitindo um valor de string que especifique o local do arquivo PDF.
    • Crie um objeto com.adobe.idp.Document usando seu construtor e transmitindo o objeto java.io.FileInputStream.
  4. Definir informações de rastreamento

    • Crie um objeto PDFAConversionOptionSpec usando seu construtor.
    • Defina o nível de rastreamento de informações chamando o método PDFAConversionOptionSpec do objeto e passando um valor de string que especifica o nível de rastreamento. setLogLevel Por exemplo, passe o valor FINE. Para obter informações sobre os diferentes valores, consulte o método setLogLevel no AEM Forms API Reference.
  5. Converter o documento

    Converta o documento PDF em um documento PDF/A chamando o método DocConverterServiceClient do objeto toPDFA e passando os seguintes valores:

    • O objeto com.adobe.idp.Document que contém o documento PDF a ser convertido
    • O objeto PDFAConversionOptionSpec que especifica as informações de rastreamento

    O método toPDFA retorna um objeto PDFAConversionResult que contém o documento PDF/A.

  6. Salvar o documento PDF/A

    • Recupere o documento PDF/A chamando o método PDFAConversionResult do objeto getPDFA. Esse método retorna um objeto com.adobe.idp.Document que representa o documento PDF/A.
    • Crie um objeto java.io.File que represente o arquivo PDF/A. Certifique-se de que a extensão de nome de arquivo seja .pdf.
    • Preencha o arquivo com dados PDF/A chamando o método com.adobe.idp.Document do objeto e transmitindo o objeto java.io.File.copyToFile

Consulte também:

Como trabalhar com documentos PDF/A

Início rápido (modo SOAP): Converter um documento em um documento PDF/A usando a API do Java

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Converter documentos em documentos PDF/A usando a API de serviço da Web

Converta um documento PDF em um documento PDF/A usando a API DocConverter (serviço da Web):

  1. Incluir arquivos de projeto

    • Crie um assembly de cliente Microsoft .NET que consuma o WSDL DocConverter.
    • Faça referência ao assembly do cliente Microsoft .NET.
  2. Criar um cliente DocConvert

    • Usando o assembly do cliente Microsoft .NET, crie um objeto DocConverterServiceService chamando seu construtor padrão.
    • Defina o membro de dados DocConverterServiceService do objeto Credentials com um valor System.Net.NetworkCredential que especifique o nome de usuário e o valor da senha.
  3. Referência a um documento PDF para converter em um documento PDF/A

    • Crie um objeto BLOB usando seu construtor. O objeto BLOB é usado para armazenar o documento PDF convertido em um documento PDF/A.
    • Crie um objeto System.IO.FileStream chamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF e o modo para abrir o arquivo.
    • Crie uma matriz de bytes que armazene o conteúdo do objeto System.IO.FileStream. Você pode determinar o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream do objeto Length.
    • Preencha a matriz de bytes com dados de fluxo chamando o método System.IO.FileStream do objeto Read e passando a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido.
    • Preencha o objeto BLOB atribuindo sua propriedade binaryData ao conteúdo da matriz de bytes.
  4. Definir informações de rastreamento

    • Crie um objeto PDFAConversionOptionSpec usando seu construtor.
    • Defina o nível de rastreamento de informações atribuindo um valor que especifique o nível de rastreamento para o PDFAConversionOptionSpec membro de dados logLevel do objeto. Por exemplo, atribua o valor FINE a esse membro de dados.
  5. Converter o documento

    Converta o documento PDF em um documento PDF/A chamando o método DocConverterServiceService do objeto toPDFA e passando os seguintes valores:

    • O objeto BLOB que contém o documento PDF a ser convertido
    • O objeto PDFAConversionOptionSpec que especifica as informações de rastreamento

    O método toPDFA retorna um objeto PDFAConversionResult que contém o documento PDF/A.

  6. Salvar o documento PDF/A

    • Crie um objeto BLOB que armazene o documento PDF/A obtendo o valor do PDFAConversionResult membro de dados PDFADocument do objeto.
    • Crie uma matriz de bytes que armazene o conteúdo do objeto BLOB que foi retornado usando o objeto PDFAConversionResult. Preencha a matriz de bytes obtendo o valor do membro de dados BLOB do objeto binaryData.
    • Crie um objeto System.IO.FileStream chamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF/A.
    • Crie um objeto System.IO.BinaryWriter chamando seu construtor e passando o objeto System.IO.FileStream.
    • Grave o conteúdo da matriz de bytes em um arquivo PDF chamando o método System.IO.BinaryWriter do objeto Write e transmitindo a matriz de bytes.

Consulte também:

Como trabalhar com documentos PDF/A

Chamada de AEM Forms usando codificação Base64

Criando um assembly de cliente .NET que usa codificação Base64

Determinando programaticamente a conformidade do PDF/A

Você pode usar o serviço Conversor de Documentos para determinar se um documento PDF é compatível com PDF/A. Para obter informações sobre um documento PDF/A e como converter um documento PDF em um documento PDF/A, consulte Convertendo documentos em documentos PDF/A.

OBSERVAÇÃO

Para obter mais informações sobre o serviço DocConverter, consulte Referência de Serviços para AEM Forms.

Resumo das etapas

Para determinar a conformidade com PDF/A, execute as seguintes etapas:

  1. Inclua arquivos de projeto.
  2. Criar um cliente DocConvert
  3. Faça referência a um documento PDF usado para determinar a conformidade com PDF/A.
  4. Defina as opções de tempo de execução.
  5. Recupere informações sobre o documento PDF.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.

Os seguintes arquivos JAR devem ser adicionados ao caminho de classe do seu projeto:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-docconverter-client.jar
  • adobe-utilities.jar (necessário se o AEM Forms for implantado no JBoss Application Server)
  • jbossall-client.jar (obrigatório se o AEM Forms for implantado no JBoss Application Server)

Para obter informações sobre a localização desses arquivos JAR, consulte Incluindo arquivos da biblioteca Java do AEM Forms.

Criar um cliente DocConvert

Antes de executar programaticamente uma operação DocConverter, você deve criar um cliente DocConverter . Se estiver usando a API do Java, crie um objeto DocConverterServiceClient . Se estiver usando a API do serviço da Web DocConverter, crie um objeto DocConverterServiceService.

Referência a um documento PDF usado para determinar a conformidade com PDF/A

Um documento PDF deve ser referenciado e passado ao serviço Conversor de Documentos para determinar se ele é compatível com PDF/A.

Definir opções de tempo de execução

Você pode definir uma opção de tempo de execução que determina quantas informações são rastreadas durante o processo de conversão. Ou seja, você pode definir nove níveis diferentes que especificam quantas informações o serviço DocConverter rastreia ao converter um documento PDF em um documento PDF/A.

Recuperar informações sobre o documento PDF

Depois de criar o cliente de serviço DocConverter, consultar o documento PDF e definir as opções de tempo de execução, você pode determinar se o documento PDF é um documento compatível com PDF/A.

Consulte também:

Determine a conformidade do PDF/A usando a API do Java

Determine a conformidade do PDF/A usando a API do serviço da Web

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Determine a conformidade do PDF/A usando a API Java

Determine a conformidade do PDF/A usando a API do Java:

  1. Incluir arquivos de projeto

    Inclua arquivos JAR do cliente, como adobe-docconverter-client.jar, no caminho de classe do seu projeto Java.

  2. Criar um cliente DocConvert

    • Crie um objeto ServiceClientFactory que contenha propriedades de conexão.
    • Crie um objeto DocConverterServiceClient usando seu construtor e transmitindo o objeto ServiceClientFactory.
  3. Referência a um documento PDF usado para determinar a conformidade com PDF/A

    • Crie um objeto java.io.FileInputStream que represente o documento PDF a ser convertido usando seu construtor e transmitindo um valor de string que especifique o local do arquivo PDF.
    • Crie um objeto com.adobe.idp.Document usando seu construtor e transmitindo o objeto java.io.FileInputStream.
  4. Definir opções de tempo de execução

    • Crie um objeto PDFAValidationOptionSpec usando seu construtor.
    • Defina o nível de conformidade chamando o método PDFAValidationOptionSpec do objeto setCompliance e passando PDFAValidationOptionSpec.Compliance.PDFA_1B.
    • Defina o nível de rastreamento de informações chamando o método PDFAValidationOptionSpec do objeto e passando um valor de string que especifica o nível de rastreamento. setLogLevel Por exemplo, passe o valor FINE. Para obter informações sobre os diferentes valores, consulte o método setLogLevel no AEM Forms API Reference.
  5. Recuperar informações sobre o documento PDF

    Determine a conformidade do PDF/A chamando o método DocConverterServiceClient do objeto isPDFA e passando os seguintes valores:

    • O objeto com.adobe.idp.Document que contém o documento PDF.
    • O objeto PDFAValidationOptionSpec que especifica as opções de tempo de execução.

    O método isPDFA retorna um objeto PDFAValidationResult que contém os resultados dessa operação.

Consulte também:

Como trabalhar com documentos PDF/A

Início rápido (modo SOAP): Como determinar a conformidade do PDF/A com a API do Java

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Determine a conformidade do PDF/A usando a API do serviço da Web

Determine a conformidade do PDF/A usando a API do serviço da Web:

  1. Incluir arquivos de projeto

    • Crie um assembly de cliente Microsoft .NET que consuma o WSDL DocConverter.
    • Faça referência ao assembly do cliente Microsoft .NET.
  2. Criar um cliente DocConvert

    • Usando o assembly do cliente Microsoft .NET, crie um objeto DocConverterServiceService chamando seu construtor padrão.
    • Defina o membro de dados DocConverterServiceService do objeto Credentials com um valor System.Net.NetworkCredential que especifique o nome de usuário e o valor da senha.
  3. Referência a um documento PDF usado para determinar a conformidade com PDF/A

    • Crie um objeto BLOB usando seu construtor. O objeto BLOB é usado para armazenar o documento PDF convertido em um documento PDF/A.
    • Crie um objeto System.IO.FileStream chamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF e o modo para abrir o arquivo.
    • Crie uma matriz de bytes que armazene o conteúdo do objeto System.IO.FileStream. Você pode determinar o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream do objeto Length.
    • Preencha a matriz de bytes com dados de fluxo chamando o método System.IO.FileStream do objeto Read e passando a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido.
    • Preencha o objeto BLOB atribuindo sua propriedade binaryData ao conteúdo da matriz de bytes.
  4. Definir opções de tempo de execução

    • Crie um objeto PDFAValidationOptionSpec usando seu construtor.
    • Defina o nível de conformidade atribuindo o PDFAValidationOptionSpec membro de dados compliance do objeto com o valor PDFAConversionOptionSpec_Compliance.PDFA_1B.
    • Defina o nível de rastreamento de informações atribuindo o membro de dados resultLevel do objeto PDFAValidationOptionSpec com o valor PDFAValidationOptionSpec_ResultLevel.DETAILED.
  5. Recuperar informações sobre o documento PDF

    Determine a conformidade do PDF/A chamando o método DocConverterServiceService do objeto isPDFA e passando os seguintes valores:

    • O objeto BLOB que contém o documento PDF.
    • O objeto PDFAValidationOptionSpec que contém opções de tempo de execução.

    O método isPDFA retorna um objeto PDFAValidationResult que contém os resultados dessa operação.

Consulte também:

Como trabalhar com documentos PDF/A

Chamada de AEM Forms usando codificação Base64

Criando um assembly de cliente .NET que usa codificação Base64

Nesta página