Trabalhar com utilitários de PDF

Sobre o serviço de utilitários de PDF

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

É possível realizar essas tarefas usando o serviço Utilitários PDF:

• Converta documentos PDF em documentos XDP.
• Converta documentos XDP em documentos PDF. (Consulte Convertendo Documentos XDP em Documentos PDF.)
• Recuperar propriedades do documento PDF. (Consulte Recuperando propriedades do Documento PDF.)
• Salve um documento PDF e otimize-o para uma visualização rápida na Web. (Consulte Configurando modos de gravação de Documento PDF.)

Converter Documentos PDF em Documentos XDP

Você pode usar o Java Utilities de PDF e as 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 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.

Crie um cliente PDFUutilityService

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

Chamar a operação de conversão de 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:

Converta documentos PDF em documentos XDP usando a API Java

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

Incluindo arquivos da biblioteca Java AEM Forms

Configuração das propriedades de conexão

Converta 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. Crie 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 PDF em XDP

   Para executar a conversão, chame o método PDFUtilityServiceClient do objeto convertPDFtoXDP 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:

Como converter Documentos PDF em Documentos XDP

Incluindo arquivos da biblioteca Java AEM Forms

Configuração das propriedades de conexão

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

Converta documentos PDF em documentos XDP usando a PDF Utilities API (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.
   • Faça referência ao assembly do cliente Microsoft .NET.

2. Crie um cliente PDFUutilityService

   Crie um objeto PDFUtilityServiceService usando seu construtor de classe proxy.

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

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

Como converter Documentos PDF em Documentos XDP

Invocar o AEM Forms usando a codificação Base64

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

Converter Documentos XDP em Documentos PDF

Você pode usar o Java Utilities de PDF e as APIs de serviço da Web para converter documentos XDP de forma programática 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 a operação de conversão XDP em 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.

Crie um cliente PDFUutilityService

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

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

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

Consulte também:

Converta documentos XDP em documentos PDF usando a API Java

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

Incluindo arquivos da biblioteca Java 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 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. Crie 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 XDP em PDF

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

Consulte também:

Como converter Documentos XDP em Documentos PDF

Incluindo arquivos da biblioteca Java 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 de PDF (Web Service API):

1. Incluir arquivos de projeto

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

2. Crie um cliente PDFUutilityService

   Crie um objeto PDFUtilityServiceService usando seu construtor de classe proxy.

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

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

Consulte também:

Como converter Documentos XDP em Documentos PDF

Invocar o AEM Forms usando a codificação Base64

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

Recuperando propriedades do Documento PDF

Você pode usar o Java Utilities de 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.

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

Crie um cliente PDFUutilityService

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

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 da Web

Incluindo arquivos da biblioteca Java AEM Forms

Configuração das propriedades de conexão

Recuperar propriedades do documento PDF usando a API Java

Recupere as propriedades 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. Crie 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 PDFUtilityServiceClient do objeto getPDFProperties 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 do query.

Consulte também:

Recuperando propriedades do Documento PDF

Incluindo arquivos da biblioteca Java AEM Forms

Configuração das propriedades de conexão

Recuperar propriedades de documentos PDF usando a API de 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 de Utilitários PDF.
   • Faça referência ao assembly do cliente Microsoft .NET.

2. Crie um cliente PDFUutilityService

   Crie um objeto PDFUtilityServiceService usando seu construtor de classe proxy.

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

   Para executar a conversão, chame o método PDFUtilityServiceService do objeto getPDFProperties 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 do query.

Consulte também:

Recuperando propriedades do Documento PDF

Invocar o AEM Forms usando a codificação Base64

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

Configurando modos de gravação de Documento PDF

Você pode usar Java e APIs de serviço da Web do serviço Utilitários PDF para definir programaticamente um modo de gravação para um documento PDF. Ao usar o serviço Utilitários PDF para definir um modo de gravação, o serviço Utilitários PDF define somente o modo de gravação 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.

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 gravação.
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.

Crie um cliente PDFUutilityService

Antes de executar programaticamente uma operação de Utilitários de PDF, você deve criar um cliente PDFUutilityService. Com a API Java, isso é feito criando um objeto PDFUtilityServiceClient. Com a API de 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 salvar incrementalmente para reduzir o tempo necessário para salvar
• FAST_WEB_VIEW: salvar para visualização rápida na Web
• FULL: Para salvar usando um salvamento completo (sem otimizações)

Chamar a operação de estilo de gravação

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

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

Consulte também:

Definir opções de gravação de documento PDF usando a API Java

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

Incluindo arquivos da biblioteca Java 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 gravação 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. Crie 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 gravação chamando o método PDFUtilitySaveMode do objeto setSaveStyle e transmitindo um valor de string que especifica o modo de gravação. Por exemplo, para salvar para exibição rápida da Web, passe FAST_WEB_VIEW.

4. Chamar a operação de estilo de gravação

   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 gravação a ser usado.
   • Um valor booliano usado para determinar se as configurações anteriores devem ser substituídas.

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

5. Enviar 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:

Configuração dos modos de gravação do Documento PDF

Incluindo arquivos da biblioteca Java AEM Forms

Configuração das propriedades de conexão

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

Defina as opções de gravação 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 de Utilitários PDF.
   • Faça referência ao assembly do cliente Microsoft .NET.

2. Crie um cliente PDFUutilityService

   Crie um objeto PDFUtilityServiceService usando seu construtor de classe 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 de estilo de gravação

   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 gravação a ser usado.
   • Um valor booliano usado para determinar se as configurações anteriores devem ser substituídas.

   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. Enviar o documento PDF para outra operação do Forms

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

Consulte também:

Configuração dos modos de gravação do Documento PDF

Invocar o AEM Forms usando a codificação Base64

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

Como limpar Documentos de PDF

Você pode usar as APIs Java de utilitários de PDF para converter documentos PDF de forma programática 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.

Crie um cliente PDFUutilityService

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

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

Converta documentos PDF em documentos XDP usando a API Java

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

Incluindo arquivos da biblioteca Java 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. Crie 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 PDF em XDP

   Para executar a conversão, chame o método PDFUtilityServiceClient do objeto convertPDFtoXDP 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:

Como limpar documentos PDF

Incluindo arquivos da biblioteca Java AEM Forms

Configuração das propriedades de conexão