Como 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:

• Converta documentos PDF em documentos PDF/A. (Consulte Convertendo documentos em documentosPDF/A.)
• Determine se documentos PDF são documentos PDF/A. (Consulte Determinando Programaticamente a conformidadedo PDF/A.)

Convertendo documentos em documentos PDF/A

Você pode usar o serviço DocConverter para converter um documento PDF em um documento PDF/A. Como o PDF/A é um formato de arquivamento 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 geralmente é maior 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 A e a B. A principal diferença entre os dois é no que se refere 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 no documento PDF/A gerado. No momento, apenas o PDF/A-1b é suportado na 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 de longo prazo e preservação de documentos.

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. Faça referência a um documento PDF para converter 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 (necessário se o AEM Forms for implantado no JBoss Application Server)

Para obter informações sobre a localização desses arquivos JAR, consulte Inclusão de arquivosda 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 DocConverterServiceClient objeto. Se você estiver usando a API de serviço da Web DocConverter, crie um DocConverterServiceService objeto.

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, causará 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 especifiquem 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, consulte o documento PDF para converter e defina a opção de tempo de execução que especifica quantas informações são rastreadas, converta o documento PDF em um documento PDF/A.

Salvar o documento PDF/A

É possível 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

Incluir arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Determinando programaticamente a 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 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 ServiceClientFactory objeto que contenha propriedades de conexão.
   • Crie um DocConverterServiceClient objeto usando seu construtor e transmitindo o ServiceClientFactory objeto.

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

   • Crie um java.io.FileInputStream objeto que represente o documento PDF a ser convertido usando seu construtor e transmitindo um valor de string que especifica o local do arquivo PDF.
   • Crie um com.adobe.idp.Document objeto usando seu construtor e transmitindo o java.io.FileInputStream objeto.

4. Definir informações de rastreamento

   • Crie um PDFAConversionOptionSpec objeto usando seu construtor.
   • Defina o nível de rastreamento de informações chamando o método do PDFAConversionOptionSpec objeto setLogLevel e transmitindo um valor de string que especifica o nível de rastreamento. For example, pass the value FINE. Para obter informações sobre os diferentes valores, consulte o setLogLevel método na Referência da API doAEM Forms.

5. Converter o documento

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

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

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

6. Salvar o documento PDF/A

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

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 Java

Incluir 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 DocConverter WSDL.
   • Consulte o assembly do cliente Microsoft .NET.

2. Criar um cliente DocConvert

   • Usando o assembly do cliente Microsoft .NET, crie um DocConverterServiceService objeto chamando seu construtor padrão.
   • Defina o membro DocConverterServiceService de dados do Credentials objeto com um System.Net.NetworkCredential valor 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 BLOB objeto usando seu construtor. O BLOB objeto é usado para armazenar o documento PDF convertido em um documento PDF/A.
   • Crie um System.IO.FileStream objeto chamando seu construtor e transmitindo 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 System.IO.FileStream objeto. É possível determinar o tamanho da matriz de bytes obtendo a propriedade do System.IO.FileStream objeto Length .
   • Preencha a matriz de bytes com dados de fluxo chamando o método do System.IO.FileStream Read objeto e transmitindo a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido.
   • Preencha o BLOB objeto atribuindo sua binaryData propriedade ao conteúdo da matriz de bytes.

4. Definir informações de rastreamento

   • Crie um PDFAConversionOptionSpec objeto usando seu construtor.
   • Defina o nível de rastreamento de informações atribuindo um valor que especifica o nível de rastreamento ao membro de PDFAConversionOptionSpec dados do logLevel 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 do DocConverterServiceService objeto toPDFA e transmitindo os seguintes valores:

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

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

6. Salvar o documento PDF/A

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

Consulte também:

Como trabalhar com documentos PDF/A

Invocar formulários AEM usando a codificação Base64

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

Determinando programaticamente a conformidade do PDF/A

Você pode usar o serviço DocConverter 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 documentosPDF/A.

Resumo das etapas

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

1. Incluir arquivos de projeto.
2. Criar um cliente DocConvert
3. Faça referência a um documento PDF usado para determinar a conformidade do 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 (necessário se o AEM Forms for implantado no JBoss Application Server)

Para obter informações sobre a localização desses arquivos JAR, consulte Inclusão de arquivosda 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 DocConverterServiceClient objeto. Se você estiver usando a API de serviço da Web DocConverter, crie um DocConverterServiceService objeto.

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

Um documento PDF deve ser referenciado e passado ao 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 determina quantas informações são rastreadas durante o processo de conversão. Ou seja, você pode definir nove níveis diferentes que especifiquem 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, 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 Java

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

Incluir 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 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 ServiceClientFactory objeto que contenha propriedades de conexão.
   • Crie um DocConverterServiceClient objeto usando seu construtor e transmitindo o ServiceClientFactory objeto.

3. Referência a um documento PDF usado para determinar a conformidade do PDF/A

   • Crie um java.io.FileInputStream objeto que represente o documento PDF a ser convertido usando seu construtor e transmitindo um valor de string que especifica o local do arquivo PDF.
   • Crie um com.adobe.idp.Document objeto usando seu construtor e transmitindo o java.io.FileInputStream objeto.

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

   • Crie um PDFAValidationOptionSpec objeto usando seu construtor.
   • Defina o nível de conformidade chamando o PDFAValidationOptionSpec método do setCompliance objeto e transmitindo PDFAValidationOptionSpec.Compliance.PDFA_1B.
   • Defina o nível de rastreamento de informações chamando o método do PDFAValidationOptionSpec objeto setLogLevel e transmitindo um valor de string que especifica o nível de rastreamento. For example, pass the value FINE. Para obter informações sobre os diferentes valores, consulte o setLogLevel método na Referência da API doAEM Forms.

5. Recuperar informações sobre o documento PDF

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

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

   O isPDFA método retorna um PDFAValidationResult objeto 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 usando a API Java

Incluir arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

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

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

1. Incluir arquivos de projeto

   • Crie um assembly de cliente Microsoft .NET que consuma o DocConverter WSDL.
   • Consulte o assembly do cliente Microsoft .NET.

2. Criar um cliente DocConvert

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

3. Referência a um documento PDF usado para determinar a conformidade do PDF/A

   • Crie um BLOB objeto usando seu construtor. O BLOB objeto é usado para armazenar o documento PDF convertido em um documento PDF/A.
   • Crie um System.IO.FileStream objeto chamando seu construtor e transmitindo 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 System.IO.FileStream objeto. É possível determinar o tamanho da matriz de bytes obtendo a propriedade do System.IO.FileStream objeto Length .
   • Preencha a matriz de bytes com dados de fluxo chamando o método do System.IO.FileStream Read objeto e transmitindo a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido.
   • Preencha o BLOB objeto atribuindo sua binaryData propriedade ao conteúdo da matriz de bytes.

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

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

5. Recuperar informações sobre o documento PDF

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

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

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

Consulte também:

Como trabalhar com documentos PDF/A

Invocar formulários AEM usando a codificação Base64

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