Forms habilitado para direitos de renderização

O serviço Forms pode renderizar formulários com direitos de uso aplicados a eles. Os direitos de uso pertencem a uma 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 de preencher campos de formulário e salvar o formulário. Forms que têm direitos de uso aplicados a eles são chamados de formulários ativados por direitos. Um usuário que abre um formulário com direitos ativados 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 do AEM forms. Além disso, você deve ter uma credencial válida que permita aplicar direitos de uso a documentos PDF. Ou seja, você deve configurar adequadamente o serviço de extensões do Acrobat Reader DC antes de renderizar um formulário com direitos ativados. (Consulte Sobre o Serviço de extensões do Acrobat Reader DC.)

OBSERVAÇÃO

Para renderizar um formulário que contenha direitos de uso, você deve usar um arquivo XDP como entrada, não um arquivo PDF. Se um arquivo PDF for usado como entrada, o formulário ainda será renderizado; no entanto, não será um formulário com direitos ativados.

OBSERVAÇÃO

Não é possível pré-preencher um formulário com dados XML ao especificar os seguintes direitos de uso: enableComments, enableCommentsOnline, enableEmbeddedFiles ou enableDigitalSignatures. (Consulte Pré-preencher o Forms com layouts flutuantes.)

OBSERVAÇÃO

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

Resumo das etapas

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

  1. Inclua arquivos de projeto.
  2. Crie um objeto da API do cliente do Forms.
  3. Definir opções de tempo de execução de direitos de uso.
  4. Renderize um formulário com direitos ativados.
  5. Escreva o formulário com direitos ativados 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 de API do cliente do Forms

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

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

Você deve definir opções de tempo de execução de direitos de uso para renderizar um formulário com direitos ativados. Você também deve especificar o alias da credencial usada para aplicar direitos de uso a um formulário. Após 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 como renderização de um formulário sem direitos de uso. A única diferença é que você deve garantir que as opções de tempo de execução dos direitos de uso sejam incluídas na lógica do aplicativo.

OBSERVAÇÃO

Ao renderizar um formulário habilitado para direitos usando a API do serviço da Web do Forms, não é possível anexar arquivos ao formulário.

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

Quando o serviço Forms renderiza um formulário habilitado para direitos, ele retorna um fluxo de dados de formulário que deve ser gravado no navegador da Web 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 ativados por direitos usando a API do serviço da Web

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Início rápido da API do Forms Service

Renderização de PDF forms interativos

Criação de aplicativos Web que renderizam o Forms

Renderizar formulários ativados por direitos usando a API Java

Renderize um formulário habilitado para direitos usando a API do Forms (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 de API do cliente do Forms

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

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

    • Crie um objeto ReaderExtensionSpec usando seu construtor.
    • Especifique o alias da credencial chamando o método ReaderExtensionSpec do objeto setReCredentialAlias e especifique um valor de string que represente o valor do alias.
    • Defina cada direito de uso chamando o método correspondente que pertence ao objeto ReaderExtensionSpec. No entanto, você só poderá definir um direito de uso se a credencial referenciada permitir que você faça isso. Ou seja, você não poderá 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 método ReaderExtensionSpec do objeto e passe true.setReFillIn
    OBSERVAÇÃO

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

  4. Renderizar um formulário habilitado para direitos

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

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

    O método renderPDFFormWithUsageRights retorna um objeto FormsResult 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 cliente

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

Consulte também:

Início rápido (modo SOAP): Renderização de um formulário habilitado para direitos usando a API Java

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Renderizar formulários ativados por direitos usando a API do serviço da Web

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

  1. Incluir arquivos de projeto

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

  2. Criar um objeto de API do cliente do Forms

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

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

    • Crie um objeto ReaderExtensionSpec usando seu construtor.
    • Especifique o alias da credencial chamando o método ReaderExtensionSpec do objeto setReCredentialAlias e especifique um valor de string que represente o valor do alias.
    • Defina cada direito de uso chamando o método correspondente que pertence ao objeto ReaderExtensionSpec. No entanto, você só poderá definir um direito de uso se a credencial referenciada permitir que você faça isso. Ou seja, você não poderá 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 método ReaderExtensionSpec do objeto e passe true.setReFillIn

  4. Renderizar um formulário habilitado para direitos

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

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

    O método renderPDFFormWithUsageRights retorna um objeto FormsResult 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 cliente

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

Consulte também:

Forms com direitos de renderização ativados

Chamada de AEM Forms usando codificação Base64

Nesta página