DocumentaçãoAEM 6.5 LTSGuia do usuário

Trabalhar com utilitários do PDF working-with-pdf-utilities

Last update: Fri Mar 07 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Aplica-se a:
  • Experience Manager 6.5 LTS

Criado para:

  • Desenvolvedor

Exemplos e exemplos neste documento são somente para AEM Forms no ambiente JEE.

Sobre o Serviço de Utilitários da PDF

O serviço de Utilitários da PDF pode converter entre formatos de arquivo PDF e XDP, definir e recuperar propriedades de documento do PDF e manipular metadados do XMP. Por exemplo, antes de converter um documento do PDF em outro formato, é útil inspecionar suas propriedades para determinar qual operação de serviço chamar para a conversão.

Você pode realizar essas tarefas usando o serviço Utilitários da PDF:

NOTE
Para obter mais informações sobre o serviço Utilitários PDF, consulte Referência de serviços para o AEM Forms.

Conversão de documentos do PDF em documentos XDP converting-pdf-documents-into-xdp-documents

Você pode usar o Java dos Utilitários da PDF e as APIs de serviço da Web para converter programaticamente documentos do PDF em documentos XDP.

NOTE
Para obter mais informações sobre o serviço Utilitários PDF, consulte Referência de serviços para o AEM Forms.

Resumo das etapas summary-of-steps

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

  1. Incluir arquivos de projeto.
  2. Crie um cliente PDFUutilityService.
  3. Chame a operação de conversão do PDF para XDP.

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.

Criar um cliente PDFUtilityService

Antes de executar programaticamente uma operação dos Utilitários PDF, você deve criar um cliente PDFUtilityService. Com a API Java, isso é feito criando um objeto PDFUtilityServiceClient. Com a API de serviço Web, isso é feito usando um objeto PDFUtilityServiceService.

Invocar a operação de conversão de PDF em XDP

Depois de criar o cliente de serviço, você pode chamar a operação de conversão do PDF em XDP.

Consulte também

Converter documentos do PDF em documentos XDP usando a API Java

Converter documentos do PDF em documentos XDP usando a API do serviço Web

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Converter documentos do PDF em documentos XDP usando a API Java convert-pdf-documents-into-xdp-documents-using-the-java-api

Converta documentos do PDF em documentos XDP usando a API de utilitários do PDF (Java):

  1. Incluir arquivos de projeto

    Inclua arquivos JAR do cliente, como adobe-pdfutility-client.jar, no caminho de classe do projeto Java.

  2. Criar um cliente PDFUutilityService

    Crie um objeto PDFUtilityServiceClient usando seu construtor e transmitindo um objeto ServiceClientFactory que contenha propriedades de conexão.

  3. Chame a operação de conversão do PDF para XDP

    Para executar a conversão, chame o método convertPDFtoXDP do objeto PDFUtilityServiceClient e passe um objeto com.adobe.idp.Document que represente o arquivo PDF. O método retorna um objeto com.adobe.idp.Document que representa o arquivo XDP recém-criado.

Consulte também

Conversão de documentos do PDF em documentos XDP

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Converter documentos do PDF em documentos XDP usando a API do serviço Web convert-pdf-documents-into-xdp-documents-using-the-web-service-api

Converta documentos do PDF em documentos XDP usando a API de utilitários do PDF (serviço da Web):

  1. Incluir arquivos de projeto

    • Crie um assembly de cliente Microsoft .NET que consuma o arquivo WSDL do serviço de Utilitários PDF.
    • Referencie o assembly do cliente Microsoft .NET.

  2. Criar um cliente PDFUutilityService

    Crie um objeto PDFUtilityServiceService usando seu construtor de classe de proxy.

  3. Chame a operação de conversão do PDF para XDP

    Invoque o método convertPDFtoXDP do objeto PDFUtilityServiceService e passe um objeto BLOB que represente o arquivo PDF. O método retorna um objeto BLOB que representa o arquivo XDP recém-criado.

Consulte também

Conversão de documentos do PDF em documentos XDP

Chamada de AEM Forms usando codificação Base64

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

Conversão de documentos XDP em documentos do PDF converting-xdp-documents-into-pdf-documents

Você pode usar o Java dos Utilitários da PDF e as APIs de serviço da Web para converter programaticamente documentos XDP em documentos do PDF.

NOTE
Para obter mais informações sobre o serviço Utilitários PDF, consulte Referência de serviços para o AEM Forms.

Resumo das etapas summary_of_steps-1

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

  1. Incluir arquivos de projeto.
  2. Crie um cliente PDFUutilityService.
  3. Chame o XDP para a operação de conversão do 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.

Criar um cliente PDFUtilityService

Antes de executar programaticamente uma operação dos Utilitários PDF, você deve criar um cliente PDFUtilityService. Com a API Java, isso é feito criando um objeto PDFUtilityServiceClient. Com a API de serviço Web, isso é feito usando um objeto PDFUtilityServiceService.

Invocar a operação de conversão de XDP para PDF

Depois de criar o cliente de serviço, você pode chamar a operação de conversão XDP para PDF.

Consulte também

Converter documentos XDP em documentos do PDF usando a API Java

Conversão de documentos XDP em documentos do PDF usando a API do serviço da Web

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Converter documentos XDP em documentos do PDF usando a API Java convert-xdp-documents-into-pdf-documents-using-the-java-api

Converta documentos XDP em documentos do PDF usando a API de utilitários do PDF (Java):

  1. Incluir arquivos de projeto

    Inclua arquivos JAR do cliente, como adobe-pdfutility-client.jar, no caminho de classe do projeto Java.

  2. Criar um cliente PDFUutilityService

    Crie um objeto PDFUtilityServiceClient usando seu construtor e transmitindo um objeto ServiceClientFactory que contenha propriedades de conexão.

  3. Chamar a operação de conversão de XDP para PDF

    Para executar a conversão, chame o método convertXDPtoPDF do objeto PDFUtilityServiceClient e passe um objeto com.adobe.idp.Document que represente o arquivo XDP. O método retorna um objeto com.adobe.idp.Document que representa o arquivo PDF recém-criado.

Consulte também

Conversão de documentos XDP em documentos do PDF

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Conversão de documentos XDP em documentos do PDF usando a API do serviço da Web converting-xdp-documents-into-pdf-documents-using-the-web-service-api

Converta documentos XDP em documentos do PDF usando a API de utilitários da PDF (API de serviço da Web):

  1. Incluir arquivos de projeto

    • Crie um assembly de cliente Microsoft .NET que consuma o arquivo WSDL do serviço de Utilitários PDF.
    • Referencie o assembly do cliente Microsoft .NET.

  2. Criar um cliente PDFUutilityService

    Crie um objeto PDFUtilityServiceService usando seu construtor de classe de proxy.

  3. Chamar a operação de conversão de XDP para PDF

    Para executar a conversão, chame o método convertXDPtoPDF do objeto PDFUtilityServiceService e passe um objeto BLOB que represente o arquivo XDP. O método retorna um objeto BLOB que representa o arquivo PDF recém-criado.

Consulte também

Conversão de documentos XDP em documentos do PDF

Chamada de AEM Forms usando codificação Base64

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

Recuperando propriedades de documento do PDF retrieving-pdf-document-properties

Você pode usar o Java dos Utilitários da PDF e as APIs de serviço da Web para recuperar programaticamente as propriedades do documento do PDF, como se o documento é um formulário preenchível ou a versão mínima do Acrobat necessária para ler o documento.

NOTE
Para obter mais informações sobre o serviço Utilitários PDF, consulte Referência de serviços para o AEM Forms

Resumo das etapas summary_of_steps-2

Para recuperar propriedades de documentos do PDF, execute as seguintes etapas:

  1. Incluir arquivos de projeto.
  2. Crie um cliente PDFUutilityService.
  3. Chame a operação de recuperação de propriedades.

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.

Criar um cliente PDFUtilityService

Antes de executar programaticamente uma operação dos Utilitários PDF, você deve criar um cliente PDFUtilityService. Com a API Java, isso é feito criando um objeto PDFUtilityServiceClient. Com a API do serviço Web, isso é feito usando um objeto PDFUtilityServiceService.

Invocar a operação de recuperação de propriedades

Depois de criar o cliente de serviço, você pode chamar a operação de recuperação de propriedades.

Consulte também

Recuperar propriedades de documento do PDF usando a API Java

Recuperar propriedades de documento do PDF usando a API de serviço da Web

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Recuperar propriedades de documento do PDF usando a API Java retrieve-pdf-document-properties-using-the-java-api

Recupere as propriedades do documento do PDF usando a API de utilitários do PDF (Java):

  1. Incluir arquivos de projeto

    Inclua arquivos JAR do cliente, como adobe-pdfutility-client.jar, no caminho de classe do projeto Java.

  2. Criar um cliente PDFUutilityService

    Crie um objeto PDFUtilityServiceClient usando seu construtor e transmitindo um objeto ServiceClientFactory que contenha propriedades de conexão.

  3. Chamar a operação de recuperação de propriedades

    Para executar a conversão, chame o método getPDFProperties do objeto PDFUtilityServiceClient e passe o seguinte:

    • Um objeto com.adobe.idp.Document que representa o documento PDF.
    • Um objeto PDFPropertiesOptionSpec que contém as propriedades a serem avaliadas.

    O método retorna um objeto PDFPropertiesResult que contém os resultados da consulta.

Consulte também

Recuperando propriedades de documento do PDF

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Recuperar propriedades de documento do PDF usando a API de serviço da Web retrieve-pdf-document-properties-using-the-web-service-api

Recupere as propriedades de documento do PDF usando a API de serviço Web dos Utilitários PDF:

  1. Incluir arquivos de projeto

    • Crie um assembly de cliente Microsoft .NET que consuma o arquivo WSDL do serviço de Utilitários PDF.
    • Referencie o assembly do cliente Microsoft .NET.

  2. Criar um cliente PDFUutilityService

    Crie um objeto PDFUtilityServiceService usando seu construtor de classe de proxy.

  3. Chamar a operação de recuperação de propriedades

    Para executar a conversão, chame o método getPDFProperties do objeto PDFUtilityServiceService e passe o seguinte:

    • Um objeto BLOB que representa o documento PDF.
    • Um objeto PDFPropertiesOptionSpec que contém as propriedades a serem avaliadas.

    O método retorna um objeto PDFPropertiesResult que contém os resultados da consulta.

Consulte também

Recuperando propriedades de documento do PDF

Chamada de AEM Forms usando codificação Base64

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

Definindo os modos de salvamento de documentos do PDF setting-pdf-document-save-modes

Você pode usar o Java do serviço Utilitários da PDF e as APIs de serviço da Web para definir programaticamente um modo de salvamento para um documento do PDF. Ao usar o serviço Utilitários da PDF para definir um modo de salvamento, o serviço Utilitários da PDF define apenas o modo de salvamento e não salva o documento do PDF. O documento do PDF é salvo quando passado para outra operação de serviço. Por exemplo, você pode usar o serviço PDF Utilities para definir um modo de salvamento específico e transmiti-lo para o serviço de Criptografia, onde o documento do PDF é realmente salvo e criptografado.

NOTE
Para obter mais informações sobre o serviço Utilitários PDF, consulte Referência de serviços para o AEM Forms.

Resumo das etapas summary_of_steps-3

Para definir a opção de salvar para documentos do PDF, execute as seguintes etapas:

  1. Incluir arquivos de projeto.
  2. Crie um cliente PDFUutilityService.
  3. Defina o modo de salvamento.
  4. Chame a operação de salvamento.
  5. Transmita o documento do PDF para outra operação.

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.

Criar um cliente PDFUtilityService

Antes de executar programaticamente uma operação dos Utilitários PDF, você deve criar um cliente PDFUtilityService. Com a API Java, isso é feito criando um objeto PDFUtilityServiceClient. Com a API do serviço Web, isso é feito usando um objeto PDFUtilityServiceService.

Definir o modo de Salvamento

Você pode escolher uma das seguintes opções de gravação:

  • INCREMENTAL: Para economizar de forma incremental para reduzir o tempo necessário para economizar
  • FAST_WEB_VIEW: salvar para exibição rápida na Web
  • FULL: Para salvar usando um salvamento completo (sem otimizações)

Invocar a operação de salvar estilo

Depois de criar o cliente de serviço, você pode chamar a operação de recuperação de propriedades.

Passar o documento do PDF para outra operação do AEM Forms

Depois que o serviço Utilitários do PDF definir o modo de Salvamento especificado, passe o documento do PDF para outra operação do AEM Forms. Depois de retornado dessa operação, o documento PDF é salvo no modo especificado. Por exemplo, se você usar o serviço Utilitários PDF para definir o modo FAST_WEB_VIEW e, em seguida, passar o documento PDF para a operação encryptUsingPassword do serviço de Criptografia, o documento PDF retornado será criptografado com uma senha e salvo no modo FAST_WEB_VIEW.

NOTE
O Início Rápido associado a esta seção define o modo FAST_WEB_VIEW e passa o documento PDF para a operação encryptUsingPassword do serviço de Criptografia.

Consulte também

Definir opções de salvamento de documentos do PDF usando a API Java

Definir as opções de salvamento de documentos do PDF usando a API de serviço da Web

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Criptografar documentos do PDF com uma senha

Definir opções de salvamento de documentos do PDF usando a API Java set-pdf-document-save-options-using-the-java-api

Defina as opções de salvamento de documento do PDF usando a API de utilitários do PDF (Java):

  1. Incluir arquivos de projeto

    Inclua arquivos JAR do cliente, como adobe-pdfutility-client.jar, no caminho de classe do projeto Java.

  2. Criar um cliente PDFUutilityService

    Crie um objeto PDFUtilityServiceClient usando seu construtor e transmitindo um objeto ServiceClientFactory que contenha propriedades de conexão.

  3. Definir o modo Salvar

    • Crie um objeto PDFUtilitySaveMode usando seu construtor.
    • Defina o modo de salvamento invocando o método setSaveStyle do objeto PDFUtilitySaveMode e transmitindo um valor de cadeia de caracteres que especifica o modo de salvamento. Por exemplo, para salvar para exibição rápida na Web, passe FAST_WEB_VIEW.

  4. Chamar a operação de salvar estilo

    Chame o método setSaveMode do objeto PDFUtilityServiceClient e passe os seguintes valores:

    • Um objeto com.adobe.idp.Document que representa o documento PDF.
    • Um objeto PDFUtilitySaveMode que contém o estilo de salvamento a ser usado.
    • Um valor booleano usado para determinar se as configurações anteriores devem ser substituídas.

    O método retorna um objeto com.adobe.idp.Document formatado com o estilo de salvamento especificado.

  5. Passar o documento do PDF para outra operação do AEM Forms

    • Passe o objeto com.adobe.idp.Document retornado para outra operação AEM Forms.

Consulte também

Definindo os modos de salvamento de documentos do PDF

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Definir as opções de salvamento de documentos do PDF usando a API de serviço da Web set-pdf-document-save-options-using-the-web-service-api

Defina as opções de salvamento de documentos do PDF usando o AP de utilitários do PDF (serviço da Web):

  1. Incluir arquivos de projeto

    • Crie um assembly de cliente Microsoft .NET que consuma o arquivo WSDL do serviço de Utilitários PDF.
    • Referencie o assembly do cliente Microsoft .NET.

  2. Criar um cliente PDFUutilityService

    Crie um objeto PDFUtilityServiceService usando seu construtor de classe de proxy.

  3. Definir o modo Salvar

    • Crie um objeto PDFUtilitySaveMode usando seu construtor.
    • Defina o modo de salvamento atribuindo um valor de cadeia de caracteres ao método saveStyle do objeto PDFUtilitySaveMode que especifica o modo de salvamento. Por exemplo, para salvar para exibição rápida na Web, especifique FAST_WEB_VIEW.

  4. Chamar a operação de salvar estilo

    Chame o método setSaveMode do objeto PDFUtilityServiceService e passe os seguintes valores:

    • Um objeto BLOB que representa o documento PDF.
    • Um objeto PDFUtilitySaveMode que contém o estilo de salvamento a ser usado.
    • Um valor booleano usado para determinar se as configurações anteriores devem ser substituídas.

    O método retorna um objeto BLOB formatado com o estilo de salvamento especificado. Você pode então salvar esse objeto como um documento do PDF.

  5. Passar o documento do PDF para outra operação do Forms

    • Passe o objeto BLOB retornado para outra operação AEM Forms.

Consulte também

Definindo os modos de salvamento de documentos do PDF

Chamada de AEM Forms usando codificação Base64

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

Limpeza de documentos do PDF sanitizing-pdf-documents

Você pode usar as APIs Java dos Utilitários da PDF para converter programaticamente documentos do PDF em documentos XDP.

NOTE
Para obter mais informações sobre o serviço Utilitários PDF, consulte Referência de serviços para o AEM Forms.

Resumo das etapas summary_of_steps-4

Para limpar o documento do PDF, execute as seguintes etapas:

  1. Incluir arquivos de projeto.
  2. Crie um cliente PDFUutilityService.
  3. Chame a operação de limpeza.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Para criar um aplicativo cliente usando Java, inclua os arquivos JAR necessários.

Criar um cliente PDFUtilityService

Antes de executar programaticamente uma operação de limpeza, você deve criar um cliente PDFUtilityService. Com a API Java, isso é feito criando um objeto PDFUtilityServiceClient.

Invocar a operação de conversão de PDF em XDP

Depois de criar o cliente de serviço, você pode chamar a operação de limpeza.

Consulte também

Converter documentos do PDF em documentos XDP usando a API Java

Converter documentos do PDF em documentos XDP usando a API do serviço Web

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Limpar documentos do PDF usando a API Java sanitize-pdf-documents-using-the-java-api

Limpe documentos usando a API de utilitários do PDF (Java):

  1. Incluir arquivos de projeto

    Inclua arquivos JAR do cliente, como adobe-pdfutility-client.jar, no caminho de classe do projeto Java.

  2. Criar um cliente PDFUutilityService

    Crie um objeto PDFUtilityServiceClient usando seu construtor e transmitindo um objeto ServiceClientFactory que contenha propriedades de conexão.

  3. Chame a operação de conversão do PDF para XDP

    Para executar a conversão, chame o método convertPDFtoXDP do objeto PDFUtilityServiceClient e passe um objeto com.adobe.idp.Document que represente o arquivo PDF. O método retorna um objeto com.adobe.idp.Document que representa o arquivo XDP recém-criado.

Consulte também

Limpeza de documentos do PDF

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

recommendation-more-help
51c6a92d-a39d-46d7-8e3e-2db9a31c06a2