Resumo das etapas

Para calcular dados de formulário, execute as seguintes tarefas:

  1. Incluir arquivos de projeto.
  2. Crie um objeto da API do cliente do Forms.
  3. Recupere um formulário que contenha um script de cálculo.
  4. Gravar o fluxo de dados do formulário de volta no navegador da Web do cliente

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

Antes de executar programaticamente uma operação da API do cliente de serviço do Forms, você deve criar um cliente de serviço do Forms. Se você estiver usando a API Java, crie um objeto FormsServiceClient. Se você estiver usando a API de serviço Web Forms, crie um objeto FormsServiceService.

Recuperar um formulário que contenha um script de cálculo

Use a API do cliente de serviço do Forms para criar uma lógica de aplicativo que manipula um formulário que contém um script configurado para execução no servidor. O processo é semelhante ao manuseio de um formulário enviado. (Consulte Manipulação de Forms Enviada.)

Verifique se o estado de processamento associado ao formulário enviado é 1 (Calculate), o que significa que o serviço Forms está executando uma operação de cálculo nos dados do formulário e os resultados devem ser gravados de volta para o usuário. Nessa situação, um script configurado para ser executado no servidor é executado automaticamente.

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

Depois de verificar se o estado de processamento associado a um formulário enviado é 1, você deve gravar os resultados no navegador da Web do cliente. Quando o formulário for exibido, o valor calculado será exibido nos campos apropriados.

Consulte também

Incluindo arquivos da biblioteca AEM Forms Java
Calcular dados do formulário usando a API Java
Calcular dados de formulário usando a API de serviço Web
Definindo propriedades de conexão
Início Rápido da API de Serviço do Forms
Renderizando PDF forms interativos
Criando Aplicativos Web que Renderizam o Forms

Calcular dados do formulário usando a API Java

Calcule dados de formulário 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 projeto Java.

  2. Criar um objeto da 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. Recuperar um formulário que contenha um script de cálculo

    • Para recuperar dados de formulário que contenham um script de cálculo, crie um objeto com.adobe.idp.Document usando seu construtor e invocando o método getInputStream do objeto javax.servlet.http.HttpServletResponse de dentro do construtor.

    • Invoque o método processFormSubmission do objeto FormsServiceClient e passe os seguintes valores:

      • O objeto com.adobe.idp.Document que contém os dados de formulário.
      • Um valor de string que especifica variáveis de ambiente, incluindo todos os cabeçalhos HTTP relevantes. Especifique o tipo de conteúdo a ser manipulado especificando um ou mais valores para a variável de ambiente CONTENT_TYPE. Por exemplo, para manipular dados XML e PDF, especifique o seguinte valor de cadeia de caracteres para este parâmetro: CONTENT_TYPE=application/xml&CONTENT_TYPE=application/pdf
      • Um valor de cadeia de caracteres que especifica o valor do cabeçalho HTTP_USER_AGENT; por exemplo, Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322).
      • Um objeto RenderOptionsSpec que armazena opções de tempo de execução.

      O método processFormSubmission retorna um objeto FormsResult contendo os resultados do envio do formulário.

    • Verifique se o estado de processamento associado a um formulário enviado é 1 invocando o método getAction do objeto FormsResult. Se esse método retornar o valor 1, o cálculo foi executado e os dados podem ser gravados no navegador da Web do cliente.

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

    • Crie um objeto javax.servlet.ServletOutputStream usado para enviar um fluxo de dados de formulário ao navegador da Web cliente.
    • Crie um objeto com.adobe.idp.Document invocando o método getOutputContent do objeto FormsResult.
    • Crie um objeto java.io.InputStream invocando o método getInputStream do objeto com.adobe.idp.Document.
    • Crie uma matriz de bytes e preencha-a com o fluxo de dados de formulário, chamando o método read do objeto InputStream e transmitindo a matriz de bytes como argumento.
    • Invoque o método write do objeto javax.servlet.ServletOutputStream para enviar o fluxo de dados de formulário para o navegador Web cliente. Passar a matriz de bytes para o método write.