Trabalhar com utilitários de PDF

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

Sobre o serviço de utilitários do PDF

O serviço Utilitários PDF pode converter entre formatos de arquivo PDF e XDP, definir e recuperar propriedades de documentos PDF e manipular metadados XMP. Por exemplo, antes de converter um documento 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 PDF:

OBSERVAÇÃO

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

Convertendo documentos PDF em documentos XDP

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

OBSERVAÇÃO

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

Resumo das etapas

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

  1. Inclua arquivos de projeto.
  2. Crie um cliente PDFUUtilityService.
  3. Chame a operação de conversão PDF em XDP.

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.

Criar um cliente PDFUtilmentService

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

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

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

Consulte também:

Converter documentos PDF em documentos XDP usando a API Java

Converter documentos PDF em documentos XDP 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

Converter documentos PDF em documentos XDP usando a API Java

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

  1. Incluir arquivos de projeto

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

  2. Criar um cliente PDFUtilmentService

    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 PDF em XDP

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

Consulte também:

Convertendo documentos PDF em documentos XDP

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

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

Converta documentos PDF em documentos XDP usando a API de utilitários 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 Utilitários PDF.
    • Faça referência ao assembly do cliente Microsoft .NET.
  2. Criar um cliente PDFUtilmentService

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

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

    Chame o método PDFUtilityServiceService do objeto convertPDFtoXDP 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:

Convertendo documentos PDF em documentos XDP

Chamada de AEM Forms usando codificação Base64

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

Convertendo documentos XDP em documentos PDF

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

OBSERVAÇÃO

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

Resumo das etapas

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

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

Criar um cliente PDFUtilmentService

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

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

Após criar o cliente de serviço, você pode chamar a operação de conversão XDP em PDF.

Consulte também:

Converter documentos XDP em documentos PDF usando a API Java

Conversão de documentos XDP em documentos PDF 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

Converta documentos XDP em documentos PDF usando a API Java

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

  1. Incluir arquivos de projeto

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

  2. Criar um cliente PDFUtilmentService

    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 XDP em PDF

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

Consulte também:

Convertendo documentos XDP em documentos PDF

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

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

Converta documentos XDP em documentos PDF usando a API de utilitários 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 Utilitários PDF.
    • Faça referência ao assembly do cliente Microsoft .NET.
  2. Criar um cliente PDFUtilmentService

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

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

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

Consulte também:

Convertendo documentos XDP em documentos PDF

Chamada de AEM Forms usando codificação Base64

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

Recuperando propriedades do documento PDF

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

OBSERVAÇÃO

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

Resumo das etapas

Para recuperar as propriedades do documento PDF, execute as seguintes etapas:

  1. Inclua 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 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.

Criar um cliente PDFUtilmentService

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

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

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

Consulte também:

Recuperar propriedades do documento PDF usando a API Java

Recuperar propriedades de documentos PDF 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

Recupere as propriedades do documento PDF usando a API Java

Recupere as propriedades do documento 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 da classe do seu projeto Java.

  2. Criar um cliente PDFUtilmentService

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

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

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

    • 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 query.

Consulte também:

Recuperando propriedades do documento PDF

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

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

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

  1. Incluir arquivos de projeto

    • Crie um assembly de cliente Microsoft .NET que consuma o arquivo WSDL do serviço Utilitários PDF.
    • Faça referência ao assembly do cliente Microsoft .NET.
  2. Criar um cliente PDFUtilmentService

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

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

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

    • 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 query.

Consulte também:

Recuperando propriedades do documento PDF

Chamada de AEM Forms usando codificação Base64

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

Configurando modos de gravação de documento PDF

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

OBSERVAÇÃO

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

Resumo das etapas

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

  1. Inclua 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 PDF para outra operação.

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.

Criar um cliente PDFUtilmentService

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

Definir o modo Salvar

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

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

Chamar a operação salvar estilo

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

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

Depois que o serviço Utilitários PDF definir o modo Salvar especificado, passe o documento 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.

OBSERVAÇÃO

O Início rápido associado a esta seção define o modo FAST_WEB_VIEW e, em seguida, transmite o documento PDF para a operação encryptUsingPassword do serviço de criptografia.

Consulte também:

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

Definir opções de gravação de documento PDF 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

Criptografar documentos PDF com uma senha

Defina as opções de salvamento do documento PDF usando a API Java

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

  1. Incluir arquivos de projeto

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

  2. Criar um cliente PDFUtilmentService

    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 chamando o método PDFUtilitySaveMode do objeto setSaveStyle e passando um valor de string que especifica o modo de salvamento. Por exemplo, para salvar para exibição rápida da Web, passe FAST_WEB_VIEW.
  4. Chamar a operação salvar estilo

    Chame o método PDFUtilityServiceClient do objeto setSaveMode 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 deve substituir alguma configuração anterior.

    O método retorna um objeto com.adobe.idp.Document formatado usando o estilo de gravação especificado.

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

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

Consulte também:

Configurando modos de gravação de documentos PDF

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

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

Defina as opções de salvamento do documento PDF usando o PDF Utilities AP (serviço da Web):

  1. Incluir arquivos de projeto

    • Crie um assembly de cliente Microsoft .NET que consuma o arquivo WSDL do serviço Utilitários PDF.
    • Faça referência ao assembly do cliente Microsoft .NET.
  2. Criar um cliente PDFUtilmentService

    Crie um objeto PDFUtilityServiceService usando o 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 string ao método PDFUtilitySaveMode do objeto saveStyle que especifica o modo de salvamento. Por exemplo, para salvar para exibição rápida da Web, especifique FAST_WEB_VIEW.
  4. Chamar a operação salvar estilo

    Chame o método PDFUtilityServiceService do objeto setSaveMode 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 deve substituir alguma configuração anterior.

    O método retorna um objeto BLOB formatado usando o estilo de gravação especificado. Em seguida, é possível salvar esse objeto como um documento PDF.

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

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

Consulte também:

Configurando modos de gravação de documentos PDF

Chamada de AEM Forms usando codificação Base64

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

Como limpar documentos PDF

Você pode usar as APIs Java de utilitários PDF para converter documentos PDF de forma programática em documentos XDP.

OBSERVAÇÃO

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

Resumo das etapas

Para limpar o documento PDF, execute as seguintes etapas:

  1. Inclua arquivos de projeto.
  2. Crie um cliente PDFUUtilityService.
  3. Chame a operação de purificação.

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 PDFUtilmentService

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

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

Após criar o cliente de serviço, você pode invocar a operação de limpeza.

Consulte também:

Converter documentos PDF em documentos XDP usando a API Java

Converter documentos PDF em documentos XDP 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

Limpar documentos PDF usando a API Java

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

  1. Incluir arquivos de projeto

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

  2. Criar um cliente PDFUtilmentService

    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 PDF em XDP

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

Consulte também:

Como limpar documentos PDF

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now