Proxy do serviço de formulários HTML5

O Proxy de Serviço de Formulários HTML5 é uma configuração para registrar um proxy para o serviço de envio. Para configurar o Proxy de Serviço, especifique o URL do serviço de envio por meio do parâmetro de solicitação submitServiceProxy.

Benefícios do Proxy de Serviço

O proxy de serviço elimina o seguinte:

  • O fluxo de trabalho de formulários HTML5 requer a abertura do serviço de envio "/content/xfaforms/submit/default" para os usuários de formulários HTML5. Ele expõe servidores AEM a um público-alvo não intencional mais amplo.
  • O URL de serviço é incorporado no modelo de tempo de execução do formulário. Não é possível alterar o caminho do URL do serviço.
  • O envio é um processo de duas etapas. Para enviar os dados do formulário, o envio requer pelo menos duas jornadas para o servidor. Assim, o aumenta a carga no servidor.
  • Os formulários HTML5 enviam dados na solicitação POST em vez de na solicitação PDF. Para um fluxo de trabalho que envolve formulários PDF e HTML5, são necessários dois métodos diferentes de processamento de envios.

Topologias

Os formulários HTML5 podem usar as seguintes topologias para se conectar aos servidores de AEM.

  • Uma topologia em que formulários AEM Server ou HTML5 enviam dados via POST para o servidor.
  • Uma topologia em que o servidor proxy envia dados de POST para o servidor.

Topologias de proxy do serviço de formulários HTML5

Topologias de proxy do serviço de formulários HTML5

Os formulários HTML5 se conectam aos servidores do AEM para executar scripts do lado do servidor, serviços da Web e envios. O tempo de execução XFA dos formulários HTML5 usa chamadas Ajax no ponto final "/bin/xfaforms/submitaction" com vários parâmetros para se conectar aos servidores de AEM. Os formulários HTML5 conectam AEM servidores para executar as seguintes operações:

Executar scripts do lado do servidor e serviços da Web

Os scripts marcados para execução no servidor são conhecidos como scripts do lado do servidor. A tabela a seguir lista todos os parâmetros usados em scripts do lado do servidor e Serviços da Web.

Parâmetro

Descrição

activity

A atividade contém os eventos que acionam a solicitação. Como clique, saída ou alteração

contextSom

contextSom contém a expressão SOM do objeto em que os eventos são executados.

Modelo

O modelo contém o modelo usado para renderizar o formulário.

contentRoot

contentRoot contém o diretório raiz do modelo usado para renderizar o formulário.

Dados

Os dados contêm bytes de dados usados para renderizar o formulário.

formDom

formDom contém DOM do formulário HTML5 no formato JSON.

packet

O pacote é especificado como formulário.

debugDir

debugDir contém o diretório debug usado para renderizar o formulário.

Enviar dados

Ao clicar no botão Enviar , os formulários HTML5 enviam dados para o servidor. A tabela a seguir lista todos os parâmetros que formulários HTML5 enviam para o servidor.

Parâmetro

Descrição

Modelo

Modelo usado para renderizar o formulário.

contentRoot

diretório raiz do modelo usado para renderizar o formulário.

Dados

bytes de dados usados para renderizar o formulário.

formDom

DOM do formulário HTML5 no formato JSON.

submiturl

O URL onde o XML de dados é postado.

debugDir

O diretório de depuração usado para renderizar o formulário.

Como o proxy de envio funciona?

O proxy de serviço de envio atua como uma passagem se o envio não estiver presente no parâmetro de solicitação. Funciona como uma passagem. Ele envia a solicitação para o ponto final /bin/xfaforms/submit e envia a resposta ao tempo de execução do XFA.

O proxy de serviço de envio seleciona uma topologia se o submiturl estiver presente no parâmetro de solicitação.

  • Se os servidores de AEM publicarem os dados, o serviço de proxy atuará como uma passagem. Ele envia a solicitação para o ponto final /bin/xfaforms/submit e envia a resposta ao tempo de execução do XFA.

  • Se o proxy publicar os dados, o serviço proxy passará todos os parâmetros, exceto submitUrl para o ponto final /bin/xfaforms/submitaction e receberá bytes xml no fluxo de resposta. Em seguida, o serviço proxy publica os bytes xml de dados no submitUrl para processamento.

  • Antes de enviar dados (solicitação de POST) para um servidor, os formulários HTML5 verificam a conectividade e a disponibilidade do servidor. Para verificar a conectividade e a disponibilidade, os formulários HTML enviam uma solicitação head vazia para o servidor. Se o servidor estiver disponível, o formulário HTML5 enviará dados (solicitação de POST) ao servidor. Se o servidor não estiver disponível, uma mensagem de erro Não foi possível se conectar ao servidor, será exibida. A detecção antecipada impede que os usuários tenham dificuldades em preencher o formulário. O servlet proxy processa a solicitação de cabeçalho e não lança exceção.

Nesta página