Sobre o Serviço DocConverter
O serviço DocConverter pode converter documentos PDF em documentos PDA/A. É possível realizar essas tarefas usando este serviço:
Para obter mais informações sobre o serviço DocConverter, consulte Referência de serviços para AEM Forms.
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 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 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. O objetivo do padrão PDF/A é estabelecer um arquivo PDF destinado a atender às necessidades de arquivamento de longo prazo e preservação de documentos.
Para obter mais informações sobre o serviço DocConverter, consulte Referência de serviços para AEM Forms.
Para converter um documento PDF em um documento PDF/A, execute as seguintes etapas:
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:
Para obter informações sobre a localização desses arquivos JAR, consulte Incluindo os arquivos da biblioteca Java da 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 de 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, 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 definir 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
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Determinando programaticamente a conformidade do PDF/A
Converta um documento PDF em um documento PDF/A usando a API Java:
Incluir arquivos de projeto
Inclua arquivos JAR do cliente, como adobe-docconverter-client.jar, no caminho de classe do seu projeto Java.
Criar um cliente DocConvert
ServiceClientFactory
que contenha propriedades de conexão.DocConverterServiceClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Referência a um documento PDF para converter em um documento PDF/A
java.io.FileInputStream
que representa o documento PDF a ser convertido usando seu construtor e transmitindo um valor de string que especifica o local do arquivo PDF.com.adobe.idp.Document
usando seu construtor e transmitindo o objeto java.io.FileInputStream
.Definir informações de rastreamento
PDFAConversionOptionSpec
usando seu construtor.PDFAConversionOptionSpec
do objeto setLogLevel
e transmitindo um valor de string 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
no AEM Forms API Reference.Converter o documento
Converta o documento PDF em um documento PDF/A chamando o método DocConverterServiceClient
do objeto toPDFA
e transmitindo os seguintes valores:
com.adobe.idp.Document
que contém o documento PDF a ser convertidoPDFAConversionOptionSpec
que especifica informações de rastreamentoO método toPDFA
retorna um objeto PDFAConversionResult
que contém o documento PDF/A.
Salvar o documento PDF/A
PDFAConversionResult
do objeto getPDFA
. Esse método retorna um objeto com.adobe.idp.Document
que representa o documento PDF/A.java.io.File
que represente o arquivo PDF/A. Verifique se a extensão do nome do arquivo é .pdf.com.adobe.idp.Document
do objeto copyToFile
e transmitindo o objeto java.io.File
.Consulte também:
Como trabalhar com Documentos PDF/A
Start rápido (modo SOAP): Converter um documento em um documento PDF/A usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Converta um documento PDF em um documento PDF/A usando a API DocConverter (serviço da Web):
Incluir arquivos de projeto
Criar um cliente DocConvert
DocConverterServiceService
chamando seu construtor padrão.DocConverterServiceService
do objeto Credentials
com um valor System.Net.NetworkCredential
que especifique o valor do nome de usuário e da senha.Referência a um documento PDF para converter em um documento PDF/A
BLOB
usando seu construtor. O objeto BLOB
é usado para armazenar o documento PDF convertido em um documento PDF/A.System.IO.FileStream
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.System.IO.FileStream
. Você pode determinar o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream
do objeto Length
.System.IO.FileStream
do objeto Read
e transmitindo a matriz de bytes, a posição inicial e o comprimento do fluxo para leitura.BLOB
atribuindo sua propriedade binaryData
ao conteúdo da matriz de bytes.Definir informações de rastreamento
PDFAConversionOptionSpec
usando seu construtor.PDFAConversionOptionSpec
membro de dados logLevel
do objeto. Por exemplo, atribua o valor FINE
a esse membro de dados.Converter o documento
Converta o documento PDF em um documento PDF/A chamando o método DocConverterServiceService
do objeto toPDFA
e transmitindo os seguintes valores:
BLOB
que contém o documento PDF a ser convertidoPDFAConversionOptionSpec
que especifica informações de rastreamentoO método toPDFA
retorna um objeto PDFAConversionResult
que contém o documento PDF/A.
Salvar o documento PDF/A
BLOB
que armazene o documento PDF/A obtendo o valor do membro de dados PDFAConversionResult
do objeto PDFADocument
.BLOB
que foi retornado usando o objeto PDFAConversionResult
. Preencha a matriz de bytes obtendo o valor do membro de dados BLOB
do objeto binaryData
.System.IO.FileStream
chamando seu construtor e transmitindo um valor de string que representa o local do arquivo do documento PDF/A.System.IO.BinaryWriter
chamando seu construtor e transmitindo o objeto System.IO.FileStream
.System.IO.BinaryWriter
do objeto Write
e transmitindo a matriz de bytes.Consulte também:
Como trabalhar com Documentos PDF/A
Invocar o AEM Forms usando a codificação Base64
Criação de um assembly de cliente .NET que usa a codificação Base64
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 Conversão de Documentos em Documentos PDF/A.
Para obter mais informações sobre o serviço DocConverter, consulte Referência de serviços para AEM Forms.
Para determinar a conformidade do PDF/A, execute as seguintes etapas:
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:
Para obter informações sobre a localização desses arquivos JAR, consulte Incluindo os arquivos da biblioteca Java da 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 de serviço da Web DocConverter, crie um objeto DocConverterServiceService
.
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
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Determine a conformidade do PDF/A usando a API Java:
Incluir arquivos de projeto
Inclua arquivos JAR do cliente, como adobe-docconverter-client.jar, no caminho de classe do seu projeto Java.
Criar um cliente DocConvert
ServiceClientFactory
que contenha propriedades de conexão.DocConverterServiceClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Referência a um documento PDF usado para determinar a conformidade do PDF/A
java.io.FileInputStream
que representa o documento PDF a ser convertido usando seu construtor e transmitindo um valor de string que especifica o local do arquivo PDF.com.adobe.idp.Document
usando seu construtor e transmitindo o objeto java.io.FileInputStream
.Definir opções de tempo de execução
PDFAValidationOptionSpec
usando seu construtor.PDFAValidationOptionSpec
do objeto setCompliance
e transmitindo PDFAValidationOptionSpec.Compliance.PDFA_1B
.PDFAValidationOptionSpec
do objeto setLogLevel
e transmitindo um valor de string 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
no AEM Forms API Reference.Recuperar informações sobre o documento PDF
Determine a conformidade do PDF/A chamando o método DocConverterServiceClient
do objeto isPDFA
e transmitindo os seguintes valores:
com.adobe.idp.Document
que contém o documento PDF.PDFAValidationOptionSpec
que especifica 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:
Como trabalhar com Documentos PDF/A
Start rápido (modo SOAP): Como determinar a conformidade do PDF/A usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Determine a conformidade do PDF/A usando a API de serviço da Web:
Incluir arquivos de projeto
Criar um cliente DocConvert
DocConverterServiceService
chamando seu construtor padrão.DocConverterServiceService
do objeto Credentials
com um valor System.Net.NetworkCredential
que especifique o valor do nome de usuário e da senha.Referência a um documento PDF usado para determinar a conformidade do PDF/A
BLOB
usando seu construtor. O objeto BLOB
é usado para armazenar o documento PDF convertido em um documento PDF/A.System.IO.FileStream
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.System.IO.FileStream
. Você pode determinar o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream
do objeto Length
.System.IO.FileStream
do objeto Read
e transmitindo a matriz de bytes, a posição inicial e o comprimento do fluxo para leitura.BLOB
atribuindo sua propriedade binaryData
ao conteúdo da matriz de bytes.Definir opções de tempo de execução
PDFAValidationOptionSpec
usando seu construtor.PDFAValidationOptionSpec
membro de dados compliance
do objeto com o valor PDFAConversionOptionSpec_Compliance.PDFA_1B
.PDFAValidationOptionSpec
membro de dados resultLevel
do objeto com o valor PDFAValidationOptionSpec_ResultLevel.DETAILED
.Recuperar informações sobre o documento PDF
Determine a conformidade do PDF/A chamando o método DocConverterServiceService
do objeto isPDFA
e transmitindo os seguintes valores:
BLOB
que contém o documento PDF.PDFAValidationOptionSpec
que contém 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:
Como trabalhar com Documentos PDF/A
Invocar o AEM Forms usando a codificação Base64
Criação de um assembly de cliente .NET que usa a codificação Base64