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:
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 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.
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 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
Converta um documento PDF em um documento PDF/A usando a API do 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 represente o documento PDF a ser convertido usando seu construtor e transmitindo um valor de string que especifique 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 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.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:
com.adobe.idp.Document
que contém o documento PDF a ser convertidoPDFAConversionOptionSpec
que especifica as 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. Certifique-se de que a extensão de nome de arquivo seja .pdf.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
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 nome de usuário e o valor 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 passando 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 passando a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido.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 passando os seguintes valores:
BLOB
que contém o documento PDF a ser convertidoPDFAConversionOptionSpec
que especifica as 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 PDFAConversionResult
membro de dados PDFADocument
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
.System.IO.FileStream
chamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF/A.System.IO.BinaryWriter
chamando seu construtor e passando 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
Chamada de AEM Forms usando codificação Base64
Criando um assembly de cliente .NET que usa codificação Base64
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.
Para obter mais informações sobre o serviço DocConverter, consulte Referência de Serviços para AEM Forms.
Para determinar a conformidade com 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 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 do 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 com PDF/A
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.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 passando PDFAValidationOptionSpec.Compliance.PDFA_1B
.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.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:
com.adobe.idp.Document
que contém o documento PDF.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:
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 nome de usuário e o valor da senha.Referência a um documento PDF usado para determinar a conformidade com 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 passando 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 passando a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido.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
.resultLevel
do objeto PDFAValidationOptionSpec
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 passando 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 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