Trabalhando com utilitários PDF

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

Sobre o serviço de utilitários PDF

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

• Converta documentos PDF em documentos XDP.
• Converter documentos XDP em documentos PDF. (Consulte Conversão de documentos XDP em documentos PDF.)
• Recupere as propriedades do documento de PDF. (Consulte Recuperando Propriedades do Documento PDF.)
• Salve um documento PDF e otimize-o para obter uma visualização rápida na Web. (Consulte Configuração dos modos de salvamento do documento PDF.)

Conversão de documentos PDF em documentos XDP

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

Resumo das etapas

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 o PDF para a operação de conversão 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 PDFUutilityService

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

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

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

Consulte também

Converter documentos PDF em documentos XDP usando a API Java

Converter documentos 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 PDF em documentos XDP usando a API Java

Converta documentos PDF em documentos XDP 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 de classe do projeto Java.

2. Criar um cliente PDFUutilityService

   Criar um PDFUtilityServiceClient objeto usando seu construtor e transmitindo um ServiceClientFactory objeto que contém propriedades de conexão.

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

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

Consulte também

Conversão de documentos PDF em documentos XDP

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

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

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

1. Incluir arquivos de projeto

   • Crie um assembly 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

   Criar um PDFUtilityServiceService usando seu construtor de classe de proxy.

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

   Chame o PDFUtilityServiceService do objeto convertPDFtoXDP e transmitem em uma BLOB objeto que representa o arquivo PDF. O método retorna um valor de BLOB objeto que representa o arquivo XDP recém-criado.

Consulte também

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

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

Resumo das etapas

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 de 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 PDFUutilityService

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

Chame 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 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

Definindo propriedades de conexão

Converter documentos XDP em documentos PDF usando a API Java

Converta documentos XDP em documentos 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 de classe do projeto Java.

2. Criar um cliente PDFUutilityService

   Criar um PDFUtilityServiceClient objeto usando seu construtor e transmitindo um ServiceClientFactory objeto que contém propriedades de conexão.

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

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

Consulte também

Conversão de documentos XDP em documentos PDF

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Conversão de 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 de PDF (API de serviço da Web):

1. Incluir arquivos de projeto

   • Crie um assembly 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

   Criar um PDFUtilityServiceService usando seu construtor de classe de proxy.

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

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

Consulte também

Conversão de 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 PDF Utilitários Java 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.

Resumo das etapas

Para recuperar as propriedades do documento 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 PDFUutilityService

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

Chamar 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 do documento PDF usando a API Java

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

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Recuperar propriedades do documento PDF usando a API Java

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

2. Criar um cliente PDFUutilityService

   Criar um PDFUtilityServiceClient objeto usando seu construtor e transmitindo um ServiceClientFactory objeto que contém propriedades de conexão.

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

   Para executar a conversão, chame o PDFUtilityServiceClient do objeto getPDFProperties e transmitem o seguinte:

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

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

Consulte também

Recuperando Propriedades do Documento PDF

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

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

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

1. Incluir arquivos de projeto

   • Crie um assembly 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

   Criar um 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 PDFUtilityServiceService do objeto getPDFProperties e transmitem o seguinte:

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

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

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

Configuração dos modos de salvamento do documento PDF

Você pode usar o serviço de Utilitários de PDF Java e APIs de serviço da Web para definir programaticamente um modo de salvamento para um documento de PDF. Ao usar o serviço Utilitários de PDF para definir um modo de salvamento, o serviço Utilitários de PDF define apenas o modo de salvamento e não salva realmente o documento PDF. O documento 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 PDF é realmente salvo e criptografado.

Resumo das etapas

Para definir a opção de salvar para documentos 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. Passe o documento 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 PDFUutilityService

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

Definir o modo Salvar

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)

Chamar 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.

Transmita o documento PDF para outra operação AEM Forms

Quando o serviço Utilitários PDF definir o modo Salvar especificado, passe o documento PDF para outra operação 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 FAST_WEB_VIEW e, em seguida, transmita o documento PDF para o do serviço de criptografia encryptUsingPassword operação, o documento PDF retornado é criptografado com uma senha e salvo na variável FAST_WEB_VIEW modo.

Consulte também

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

Definir opções de salvamento de documento 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 PDF com senha

Definir opções de salvamento de 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 de classe do projeto Java.

2. Criar um cliente PDFUutilityService

   Criar um PDFUtilityServiceClient objeto usando seu construtor e transmitindo um ServiceClientFactory objeto que contém propriedades de conexão.

3. Definir o modo Salvar

   • Criar um PDFUtilitySaveMode usando seu construtor.
   • Defina o modo de salvamento chamando o PDFUtilitySaveMode do objeto setSaveStyle e transmitindo um valor de string 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 PDFUtilityServiceClient do objeto setSaveMode e passe os seguintes valores:

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

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

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

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

Consulte também

Configuração dos modos de salvamento do documento PDF

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Definir opções de salvamento de documento PDF usando a API de serviço da Web

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

1. Incluir arquivos de projeto

   • Crie um assembly 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

   Criar um PDFUtilityServiceService usando seu construtor de classe de proxy.

3. Definir o modo Salvar

   • Criar um PDFUtilitySaveMode usando seu construtor.
   • Defina o modo de salvamento atribuindo um valor de string ao PDFUtilitySaveMode do objeto saveStyle 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 PDFUtilityServiceService do objeto setSaveMode e passe os seguintes valores:

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

   O método retorna um valor de BLOB objeto formatado usando o estilo de salvamento especificado. Você pode salvar esse objeto como um documento PDF.

5. Transmita o documento PDF para outra operação Forms

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

Consulte também

Configuração dos modos de salvamento do documento 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

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

Resumo das etapas

Para limpar o documento 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 PDFUutilityService

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

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

Depois de criar o cliente de serviço, você pode chamar 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 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 do Java

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

   Criar um PDFUtilityServiceClient objeto usando seu construtor e transmitindo um ServiceClientFactory objeto que contém propriedades de conexão.

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

   Para executar a conversão, chame o PDFUtilityServiceClient do objeto convertPDFtoXDP e transmitem em uma com.adobe.idp.Document objeto que representa o arquivo PDF. O método retorna um valor de com.adobe.idp.Document objeto 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