Trabalhar com documentos PDF/A

Última atualização: 30 de novembro de 2024
  • Aplica-se a:
  • Experience Manager 6.5
  • Tópicos:

Criado para:

  • Desenvolvedor

Sobre o Serviço DocConverter

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

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

Conversão de documentos em documentos PDF/A

Você pode usar o serviço DocConverter para converter um documento PDF em um documento PDF/A. Como PDF/A é um formato de arquivamento para 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 geralmente é 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 de 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 no documento PDF/A gerado. No momento, somente o PDF/A-1b é suportado na validação (e na conversão).

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

Os padrões de conformidade com PDF/A suportados incluem PDF/A-1a, 1b, 2a, 2b, 3a e 3b.

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

Resumo das etapas

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

  1. Incluir arquivos de projeto.
  2. Criar um cliente DocConvert
  3. Referencie um documento PDF para converter em um documento PDF/A.
  4. Definir 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 uma aplicação 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 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 (necessá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 você estiver usando a API Java, crie um objeto DocConverterServiceClient. Se você estiver usando a API do serviço Web DocConverter, crie um objeto DocConverterServiceService.

Referencie 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, causará uma exceção.

Definir informações de rastreamento

Você pode definir uma opção de tempo de execução que determine 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 quando converte um documento PDF em um documento PDF/A.

Converter o documento

Depois de criar o cliente de serviço DocConverter, faça referência ao documento PDF a ser convertido e defina a opção de tempo de execução que especifica quantas informações são rastreadas, você pode 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 Web

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Determinação Programática Da Conformidade Com PDF/A

Converter documentos em documentos PDF/A usando a API Java

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

  1. Incluir arquivos de projeto

    Inclua arquivos JAR do cliente, como adobe-docconverter-client.jar, no caminho de classe do 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. Referencie 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 cadeia de caracteres 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 invocando o método setLogLevel do objeto PDFAConversionOptionSpec e transmitindo um valor de cadeia de caracteres que especifica o nível de rastreamento. Por exemplo, passe o valor FINE. Para obter informações sobre os diferentes valores, consulte o método setLogLevel na Referência da API AEM Forms.

  5. Converter o documento

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

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

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

  6. Salve o documento PDF/A

    • Recupere o documento PDF/A invocando o método getPDFA do objeto PDFAConversionResult. Este 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. Verifique se a extensão do nome do arquivo é .pdf.
    • Preencha o arquivo com dados PDF/A invocando o método copyToFile do objeto com.adobe.idp.Document e transmitindo o objeto java.io.File.

Consulte também

Trabalhar com documentos PDF/A

Início rápido (modo SOAP): conversão de um documento em um documento PDF/A usando a API Java

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Converter documentos em documentos PDF/A usando a API de serviço 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 cliente Microsoft .NET que consuma o WSDL DocConverter.
    • Referencie o assembly do cliente Microsoft .NET.

  2. Criar um cliente DocConvert

    • Usando o assembly do cliente Microsoft .NET, crie um objeto DocConverterServiceService invocando seu construtor padrão.
    • Defina o membro de dados Credentials do objeto DocConverterServiceService com um valor System.Net.NetworkCredential que especifique o nome de usuário e o valor da senha.

  3. Referencie 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 que é convertido em um documento PDF/A.
    • Crie um objeto System.IO.FileStream chamando seu construtor e transmitindo um valor de cadeia de caracteres que representa o local do arquivo do documento PDF e o modo em que o arquivo será aberto.
    • 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 Length do objeto System.IO.FileStream.
    • Preencha a matriz de bytes com os dados de fluxo invocando o método Read do objeto System.IO.FileStream e transmitindo a matriz de bytes, a posição inicial e o comprimento do fluxo para leitura.
    • Preencha o objeto BLOB atribuindo sua propriedade binaryData com o 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 ao membro de dados logLevel do objeto PDFAConversionOptionSpec. Por exemplo, atribua o valor FINE a esse membro de dados.

  5. Converter o documento

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

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

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

  6. Salve o documento PDF/A

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

Consulte também

Trabalhar com documentos PDF/A

Chamada de AEM Forms usando codificação Base64

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

Determinação Programática Da Conformidade Com PDF/A

Você pode usar o serviço DocConverter para determinar se um documento de 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 Conversão de documentos em documentos PDF/A.

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

Resumo das etapas

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

  1. Incluir arquivos de projeto.
  2. Criar um cliente DocConvert
  3. Consulte um documento de PDF usado para determinar a conformidade com PDF/A.
  4. Definir 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 uma aplicação 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 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 (necessá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 você estiver usando a API Java, crie um objeto DocConverterServiceClient. Se você estiver usando a API do serviço Web DocConverter, crie um objeto DocConverterServiceService.

Referenciar um documento PDF usado para determinar a conformidade PDF/A

Um documento PDF deve ser referenciado e passado para o serviço DocConverter para determinar se o documento PDF é 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 determine 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 quando converte um documento PDF em um documento PDF/A.

Recuperar informações sobre o documento PDF

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

Consulte também

Determine a conformidade PDF/A usando a API Java

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

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Determine a conformidade PDF/A usando a API Java

Determine a conformidade PDF/A usando a API Java:

  1. Incluir arquivos de projeto

    Inclua arquivos JAR do cliente, como adobe-docconverter-client.jar, no caminho de classe do 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 de 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 cadeia de caracteres 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 setCompliance do objeto PDFAValidationOptionSpec e transmitindo PDFAValidationOptionSpec.Compliance.PDFA_1B.
    • Defina o nível de rastreamento de informações invocando o método setLogLevel do objeto PDFAValidationOptionSpec e transmitindo um valor de cadeia de caracteres que especifica o nível de rastreamento. Por exemplo, passe o valor FINE. Para obter informações sobre os diferentes valores, consulte o método setLogLevel na Referência da API AEM Forms.

  5. Recuperar informações sobre o documento PDF

    Determine a conformidade PDF/A chamando o método isPDFA do objeto DocConverterServiceClient e transmitindo 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 desta operação.

Consulte também

Trabalhar com documentos PDF/A

Início rápido (modo SOAP): determinação da conformidade PDF/A usando a API Java

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão