Renderização de formulários ativados por direitos

O serviço de Formulários pode renderizar formulários com direitos de uso aplicados a eles. Os direitos de uso pertencem à funcionalidade que está disponível por padrão no Acrobat, mas não no Adobe Reader, como a capacidade de adicionar comentários a um formulário ou preencher campos de formulário e salvar o formulário. Os formulários com direitos de uso aplicados a eles são chamados de formulários com direitos ativados. Um usuário que abre um formulário habilitado para direitos no Adobe Reader pode executar operações ativadas para esse formulário.

Para aplicar direitos de uso a um formulário, o serviço de extensões do Acrobat Reader DC deve fazer parte da instalação de formulários do AEM. Além disso, você deve ter uma credencial válida que permita aplicar direitos de uso a documentos PDF. Ou seja, você deve configurar corretamente o serviço de extensões do Acrobat Reader DC antes de renderizar um formulário habilitado para direitos. (Consulte Sobre o serviçode extensões do Acrobat Reader DC.)

Resumo das etapas

Para renderizar um formulário com direitos ativados, execute as seguintes tarefas:

1. Incluir arquivos de projeto.
2. Crie um objeto da API do Forms Client.
3. Defina opções de tempo de execução de direitos de uso.
4. Renderize um formulário com direitos ativados.
5. Grave o formulário com direitos habilitados no navegador da Web do cliente.

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 objeto da API do cliente Forms

Antes de executar programaticamente uma operação de API do cliente do serviço Forms, é necessário criar um cliente do serviço Forms.

Definir opções de tempo de execução de direitos de uso

É necessário definir opções de tempo de execução de direitos de uso para renderizar um formulário habilitado para direitos. Você também deve especificar o alias da credencial usada para aplicar direitos de uso a um formulário. Depois de especificar o valor do alias, especifique cada direito de uso a ser aplicado ao formulário.

Renderizar um formulário habilitado para direitos

Para renderizar um formulário com direitos ativados, use a mesma lógica de aplicativo que renderizar um formulário sem direitos de uso. A única diferença é que você deve garantir que as opções de tempo de execução de direitos de uso sejam incluídas na lógica do aplicativo.

Gravar o fluxo de dados do formulário no navegador da Web do cliente

Quando o serviço Forms renderiza um formulário com direitos ativados, ele retorna um fluxo de dados de formulário que você deve gravar no navegador da Web do cliente. Depois de gravado no navegador da Web do cliente, o formulário fica visível para o usuário. Um usuário que exibe o formulário com direitos ativados no Adobe Reader pode executar operações ativadas para esse formulário.

Consulte também:

Renderizar formulários ativados por direitos usando a API Java

Renderizar formulários habilitados por direitos usando a API de serviço da Web

Incluir arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Início rápido da API do serviço de formulários

Como renderizar formulários PDF interativos

Criação de aplicativos da Web que renderizam formulários

Renderizar formulários ativados por direitos usando a API Java

Renderize um formulário habilitado para direitos usando a API de formulários (Java):

1. Incluir arquivos de projeto

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

2. Criar um objeto da API do cliente Forms

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

3. Definir opções de tempo de execução de direitos de uso

   • Crie um ReaderExtensionSpec objeto usando seu construtor.
   • Especifique o alias da credencial chamando o método do ReaderExtensionSpec objeto setReCredentialAlias e especifique um valor de string que representa o valor do alias.
   • Defina cada direito de uso chamando o método correspondente que pertence ao ReaderExtensionSpec objeto. No entanto, você só pode definir um direito de uso se a credencial que você menciona permitir que você o faça. Ou seja, você não pode definir um direito de uso se a credencial não permitir que você o defina. Por exemplo. para definir o direito de uso que permite ao usuário preencher campos de formulário e salvar o formulário, chame o ReaderExtensionSpec método do setReFillIn objeto e passe true.
   Observação

   Não é necessário invocar o ReaderExtensionSpec método do setReCredentialPassword objeto. Esse método não é usado pelo serviço Forms.

4. Renderizar um formulário habilitado para direitos

   Chame o método do FormsServiceClient objeto renderPDFFormWithUsageRights e passe os seguintes valores:

   • Um valor de string que especifica o nome do design de formulário, incluindo a extensão do nome do arquivo. Se você fizer referência a um design de formulário que faz parte de um aplicativo do Forms, especifique o caminho completo, como Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
   • Um com.adobe.idp.Document objeto que contém dados a serem unidos ao formulário. Se você não quiser unir dados, passe um com.adobe.idp.Document objeto vazio.
   • Um PDFFormRenderSpec objeto que armazena opções de tempo de execução.
   • Um ReaderExtensionSpec objeto que armazena opções de tempo de execução de direitos de uso.
   • Um URLSpec objeto que contém valores de URI exigidos pelo serviço Forms.

   O renderPDFFormWithUsageRights método retorna um FormsResult objeto que contém um fluxo de dados de formulário que deve ser gravado no navegador da Web do cliente.

5. Gravar o fluxo de dados do formulário no navegador da Web do cliente

   • Crie um com.adobe.idp.Document objeto chamando o FormsResult método do objeto getOutputContent .
   • Obtenha o tipo de conteúdo do com.adobe.idp.Document objeto chamando seu getContentType método.
   • Defina o tipo de conteúdo do javax.servlet.http.HttpServletResponse objeto chamando seu setContentType método e transmitindo o tipo de conteúdo do com.adobe.idp.Document objeto.
   • Crie um javax.servlet.ServletOutputStream objeto usado para gravar o fluxo de dados do formulário no navegador da Web do cliente, chamando o javax.servlet.http.HttpServletResponse getOutputStream método do objeto.
   • Crie um java.io.InputStream objeto chamando o com.adobe.idp.Document método do getInputStream objeto.
   • Crie uma matriz de bytes para preenchê-la com o fluxo de dados do formulário, chamando o método do InputStream objeto read e transmitindo a matriz de bytes como um argumento.
   • Chame o método do javax.servlet.ServletOutputStream write objeto para enviar o fluxo de dados do formulário para o navegador da Web do cliente. Passe a matriz de bytes para o write método.

Consulte também:

Início rápido (modo SOAP): Como renderizar um formulário habilitado para direitos usando a API Java

Incluir arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Renderizar formulários habilitados por direitos usando a API de serviço da Web

Renderize um formulário habilitado para direitos usando a API de formulários (serviço da Web):

1. Incluir arquivos de projeto

   • Crie classes proxy Java que consomem o serviço Forms WSDL.
   • Inclua as classes proxy Java no caminho da classe.

2. Criar um objeto da API do cliente Forms

   Crie um FormsService objeto e defina valores de autenticação.

3. Definir opções de tempo de execução de direitos de uso

   • Crie um ReaderExtensionSpec objeto usando seu construtor.
   • Especifique o alias da credencial chamando o método do ReaderExtensionSpec objeto setReCredentialAlias e especifique um valor de string que representa o valor do alias.
   • Defina cada direito de uso chamando o método correspondente que pertence ao ReaderExtensionSpec objeto. No entanto, você só pode definir um direito de uso se a credencial que você menciona permitir que você o faça. Ou seja, você não pode definir um direito de uso se a credencial não permitir que você o defina. Para definir o direito de uso que permite ao usuário preencher campos de formulário e salvar o formulário, chame o ReaderExtensionSpec método do setReFillIn objeto e passe true.

4. Renderizar um formulário habilitado para direitos

   Chame o método do FormsService objeto renderPDFFormWithUsageRights e passe os seguintes valores:

   • Um valor de string que especifica o nome do design de formulário, incluindo a extensão do nome do arquivo. Se você fizer referência a um design de formulário que faz parte de um aplicativo do Forms, especifique o caminho completo, como Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
   • Um BLOB objeto que contém dados a serem unidos ao formulário. Se não quiser unir dados ao formulário, é necessário enviar um BLOB objeto que seja baseado em uma fonte de dados XML vazia. Não é possível passar um BLOB objeto nulo; caso contrário, uma exceção será lançada.
   • Um PDFFormRenderSpec objeto que armazena opções de tempo de execução.
   • Um ReaderExtensionSpec objeto que armazena opções de tempo de execução de direitos de uso.
   • Um URLSpec objeto que contém valores de URI exigidos pelo serviço Forms.

   O renderPDFFormWithUsageRights método retorna um FormsResult objeto que contém um fluxo de dados de formulário que deve ser gravado no navegador da Web do cliente.

5. Gravar o fluxo de dados do formulário no navegador da Web do cliente

   • Crie um BLOB objeto que contenha dados de formulário chamando o FormsResult método do getOutputContent objeto.
   • Obtenha o tipo de conteúdo do BLOB objeto chamando seu getContentType método.
   • Defina o tipo de conteúdo do javax.servlet.http.HttpServletResponse objeto chamando seu setContentType método e transmitindo o tipo de conteúdo do BLOB objeto.
   • Crie um javax.servlet.ServletOutputStream objeto usado para gravar o fluxo de dados do formulário no navegador da Web do cliente, chamando o javax.servlet.http.HttpServletResponse getOutputStream método do objeto.
   • Crie uma matriz de bytes e preencha-a chamando o método do BLOB objeto getBinaryData . Essa tarefa atribui o conteúdo do FormsResult objeto à matriz de bytes.
   • Chame o método do javax.servlet.http.HttpServletResponse write objeto para enviar o fluxo de dados do formulário para o navegador da Web do cliente. Passe a matriz de bytes para o write método.

Consulte também:

Renderização de formulários ativados por direitos

Invocar formulários AEM usando a codificação Base64