Trabalhar com documentos PDF/A working-with-pdf-a-documents
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:
- Converta documentos PDF em documentos PDF/A. (Consulte Conversão de documentos em documentos PDF/A.)
- Determine se os documentos PDF são documentos PDF/A. (Consulte Determinação Programática Da Conformidade Com PDF/A.)
Conversão de documentos em documentos PDF/A converting-documents-to-pdf-a-documents
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.
Resumo das etapas summary-of-steps
Para converter um documento PDF em um documento PDF/A, execute as seguintes etapas:
- Incluir arquivos de projeto.
- Criar um cliente DocConvert
- Referencie um documento PDF para converter em um documento PDF/A.
- Definir informações de rastreamento.
- Converta o documento.
- 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 Inclusão de 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 Java, crie uma DocConverterServiceClient
objeto. Se você estiver usando a API do serviço Web DocConverter, crie uma DocConverterServiceService
objeto.
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.
Salve 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 convert-documents-to-pdf-a-documents-using-the-java-api
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 projeto Java.
-
Criar um cliente DocConvert
- Criar um
ServiceClientFactory
objeto que contém propriedades de conexão. - Criar um
DocConverterServiceClient
usando seu construtor e transmitindo oServiceClientFactory
objeto.
- Criar um
-
Referencie um documento PDF para converter em um documento PDF/A
- Criar um
java.io.FileInputStream
objeto que representa o documento PDF a ser convertido usando seu construtor e transmitindo um valor de string que especifica o local do arquivo PDF. - Criar um
com.adobe.idp.Document
usando seu construtor e transmitindo ojava.io.FileInputStream
objeto.
- Criar um
-
Definir informações de rastreamento
- Criar um
PDFAConversionOptionSpec
usando seu construtor. - Defina o nível de rastreamento de informações invocando o
PDFAConversionOptionSpec
do objetosetLogLevel
e transmitindo um valor de string que especifica o nível de rastreamento. Por exemplo, passe o valorFINE
. Para obter informações sobre os diferentes valores, consultesetLogLevel
no Referência da API do AEM Forms.
- Criar um
-
Converter o documento
Converta o documento PDF em um documento PDF/A chamando o
DocConverterServiceClient
do objetotoPDFA
e transmitindo os seguintes valores:- A variável
com.adobe.idp.Document
objeto que contém o documento PDF a ser convertido - A variável
PDFAConversionOptionSpec
objeto que especifica informações de rastreamento
A variável
toPDFA
o método retorna umPDFAConversionResult
objeto que contém o documento PDF/A. - A variável
-
Salve o documento PDF/A
- Recupere o documento PDF/A chamando o
PDFAConversionResult
do objetogetPDFA
método. Este método retorna um valor decom.adobe.idp.Document
objeto que representa o documento PDF/A. - Criar um
java.io.File
objeto que representa o arquivo PDF/A. Verifique se a extensão do nome do arquivo é .pdf. - Preencha o arquivo com dados PDF/A chamando o
com.adobe.idp.Document
do objetocopyToFile
e transmitindo ojava.io.File
objeto.
- Recupere o documento PDF/A chamando o
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 convert-documents-to-pdf-a-documents-using-the-web-service-api
Converta um documento PDF em um documento PDF/A usando a API DocConverter (serviço da Web):
-
Incluir arquivos de projeto
- Crie um assembly cliente Microsoft .NET que consuma o WSDL DocConverter.
- Referencie o assembly do cliente Microsoft .NET.
-
Criar um cliente DocConvert
- Usando o assembly cliente Microsoft .NET, crie um
DocConverterServiceService
chamando seu construtor padrão. - Defina o
DocConverterServiceService
do objetoCredentials
membro de dados com umSystem.Net.NetworkCredential
valor que especifica o nome de usuário e o valor da senha.
- Usando o assembly cliente Microsoft .NET, crie um
-
Referencie um documento PDF para converter em um documento PDF/A
- Criar um
BLOB
usando seu construtor. A variávelBLOB
O objeto é usado para armazenar o documento PDF que é convertido em um documento PDF/A. - Criar um
System.IO.FileStream
chamando seu construtor e transmitindo um valor de string que representa o local do arquivo do documento PDF e o modo no qual o arquivo será aberto. - Crie uma matriz de bytes que armazene o conteúdo da variável
System.IO.FileStream
objeto. Você pode determinar o tamanho da matriz de bytes obtendo oSystem.IO.FileStream
do objetoLength
propriedade. - Preencha a matriz de bytes com dados de fluxo invocando o
System.IO.FileStream
do objetoRead
e transmitindo a matriz de bytes, a posição inicial e o comprimento do fluxo para leitura. - Preencha o
BLOB
atribuindo seubinaryData
com o conteúdo da matriz de bytes.
- Criar um
-
Definir informações de rastreamento
- Criar um
PDFAConversionOptionSpec
usando seu construtor. - Defina o nível de rastreamento de informações atribuindo um valor que especifique o nível de rastreamento ao
PDFAConversionOptionSpec
do objetologLevel
membro de dados. Por exemplo, atribuir o valorFINE
para esse membro de dados.
- Criar um
-
Converter o documento
Converta o documento PDF em um documento PDF/A chamando o
DocConverterServiceService
do objetotoPDFA
e transmitindo os seguintes valores:- A variável
BLOB
objeto que contém o documento PDF a ser convertido - A variável
PDFAConversionOptionSpec
objeto que especifica informações de rastreamento
A variável
toPDFA
o método retorna umPDFAConversionResult
objeto que contém o documento PDF/A. - A variável
-
Salve o documento PDF/A
- Criar um
BLOB
objeto que armazena o documento PDF/A obtendo o valor doPDFAConversionResult
do objetoPDFADocument
membro de dados. - Crie uma matriz de bytes que armazene o conteúdo da variável
BLOB
objeto que foi retornado usando oPDFAConversionResult
objeto. Preencha a matriz de bytes obtendo o valor deBLOB
do objetobinaryData
membro de dados. - Criar um
System.IO.FileStream
chamando seu construtor e transmitindo um valor de string que representa o local do arquivo do documento PDF/A. - Criar um
System.IO.BinaryWriter
objeto chamando seu construtor e transmitindo oSystem.IO.FileStream
objeto. - Grave o conteúdo da matriz de bytes em um arquivo PDF, chamando o
System.IO.BinaryWriter
do objetoWrite
e transmitindo a matriz de bytes.
- Criar um
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 programmatically-determining-pdf-a-compliancy
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 para um documento PDF/A, consulte Conversão de documentos em documentos PDF/A.
Resumo das etapas summary_of_steps-1
Para determinar a conformidade PDF/A, execute as seguintes etapas:
- Incluir arquivos de projeto.
- Criar um cliente DocConvert
- Consulte um documento de PDF usado para determinar a conformidade com PDF/A.
- Definir opções de tempo de execução.
- 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 Inclusão de 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 Java, crie uma DocConverterServiceClient
objeto. Se você estiver usando a API do serviço Web DocConverter, crie uma DocConverterServiceService
objeto.
Referência a um documento de PDF usado para determinar a conformidade com 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-pdf-a-compliancy-using-the-java-api
Determine a conformidade 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 projeto Java.
-
Criar um cliente DocConvert
- Criar um
ServiceClientFactory
objeto que contém propriedades de conexão. - Criar um
DocConverterServiceClient
usando seu construtor e transmitindo oServiceClientFactory
objeto.
- Criar um
-
Referência a um documento de PDF usado para determinar a conformidade com PDF/A
- Criar um
java.io.FileInputStream
objeto que representa o documento PDF a ser convertido usando seu construtor e transmitindo um valor de string que especifica o local do arquivo PDF. - Criar um
com.adobe.idp.Document
usando seu construtor e transmitindo ojava.io.FileInputStream
objeto.
- Criar um
-
Definir opções de tempo de execução
- Criar um
PDFAValidationOptionSpec
usando seu construtor. - Defina o nível de conformidade chamando o
PDFAValidationOptionSpec
do objetosetCompliance
método e transmissãoPDFAValidationOptionSpec.Compliance.PDFA_1B
. - Defina o nível de rastreamento de informações invocando o
PDFAValidationOptionSpec
do objetosetLogLevel
e transmitindo um valor de string que especifica o nível de rastreamento. Por exemplo, passe o valorFINE
. Para obter informações sobre os diferentes valores, consultesetLogLevel
no Referência da API do AEM Forms.
- Criar um
-
Recuperar informações sobre o documento PDF
Determine a conformidade PDF/A chamando o
DocConverterServiceClient
do objetoisPDFA
e transmitindo os seguintes valores:- A variável
com.adobe.idp.Document
objeto que contém o documento PDF. - A variável
PDFAValidationOptionSpec
objeto que especifica as opções de tempo de execução.
A variável
isPDFA
o método retorna umPDFAValidationResult
objeto que contém os resultados desta operação. - A variável
Consulte também
Trabalhar com documentos PDF/A
Início rápido (modo SOAP): determinação da conformidade com PDF/A usando a API Java
Inclusão de arquivos da biblioteca Java do AEM Forms
Definindo propriedades de conexão
Determine a conformidade PDF/A usando a API do serviço Web determine-pdf-a-compliancy-using-the-web-service-api
Determine a conformidade PDF/A usando a API de serviço da Web:
-
Incluir arquivos de projeto
- Crie um assembly cliente Microsoft .NET que consuma o WSDL DocConverter.
- Referencie o assembly do cliente Microsoft .NET.
-
Criar um cliente DocConvert
- Usando o assembly cliente Microsoft .NET, crie um
DocConverterServiceService
chamando seu construtor padrão. - Defina o
DocConverterServiceService
do objetoCredentials
membro de dados com umSystem.Net.NetworkCredential
valor que especifica o nome de usuário e o valor da senha.
- Usando o assembly cliente Microsoft .NET, crie um
-
Referência a um documento de PDF usado para determinar a conformidade com PDF/A
- Criar um
BLOB
usando seu construtor. A variávelBLOB
O objeto é usado para armazenar o documento PDF que é convertido em um documento PDF/A. - Criar um
System.IO.FileStream
chamando seu construtor e transmitindo um valor de string que representa o local do arquivo do documento PDF e o modo no qual o arquivo será aberto. - Crie uma matriz de bytes que armazene o conteúdo da variável
System.IO.FileStream
objeto. Você pode determinar o tamanho da matriz de bytes obtendo oSystem.IO.FileStream
do objetoLength
propriedade. - Preencha a matriz de bytes com dados de fluxo invocando o
System.IO.FileStream
do objetoRead
e transmitindo a matriz de bytes, a posição inicial e o comprimento do fluxo para leitura. - Preencha o
BLOB
atribuindo seubinaryData
com o conteúdo da matriz de bytes.
- Criar um
-
Definir opções de tempo de execução
- Criar um
PDFAValidationOptionSpec
usando seu construtor. - Defina o nível de conformidade atribuindo o
PDFAValidationOptionSpec
do objetocompliance
membro de dados com o valorPDFAConversionOptionSpec_Compliance.PDFA_1B
. - Defina o nível de rastreamento de informações atribuindo o
PDFAValidationOptionSpec
do objetoresultLevel
membro de dados com o valorPDFAValidationOptionSpec_ResultLevel.DETAILED
.
- Criar um
-
Recuperar informações sobre o documento PDF
Determine a conformidade PDF/A chamando o
DocConverterServiceService
do objetoisPDFA
e transmitindo os seguintes valores:- A variável
BLOB
objeto que contém o documento PDF. - A variável
PDFAValidationOptionSpec
objeto que contém opções de tempo de execução.
A variável
isPDFA
o método retorna umPDFAValidationResult
objeto que contém os resultados desta operação. - A variável
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