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 pelo 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. Expõe servidores AEM a uma audiência não intencional mais ampla.
  • O URL do 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 em duas etapas. Para enviar os dados do formulário, o envio requer pelo menos duas viagens ao servidor. Assim, aumenta a carga no servidor.
  • Formulários HTML5 enviam dados na solicitação de POST em vez da solicitação de PDF. Para 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.

  • Topologia na qual os formulários AEM Server ou HTML5 enviam dados via POST para o servidor.
  • Uma topologia na qual o servidor proxy envia dados de POST para o servidor.

Topologias proxy do serviço de formulários HTML5

Topologias proxy do serviço de formulários HTML5

Formulários HTML5 conectam-se aos servidores de AEM para executar scripts de 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 nos scripts do servidor e nos Serviços da Web.

Parâmetro

Descrição

activity

A atividade contém os eventos que acionam a solicitação. Como clicar, sair ou alterar

contextSom

contextSom contém a expressão SOM do objeto no qual 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 de depuração 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 os 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 no qual o XML de dados é publicado.

debugDir

O diretório debug 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 submiturl 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/submitaction e envia a resposta para o tempo de execução 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 AEM postarem os dados, o serviço proxy atuará como uma passagem. Ele envia a solicitação para o ponto final /bin/xfaforms/submitaction e envia a resposta para o tempo de execução XFA.

  • Se o proxy postar 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 posta 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 de cabeçalho vazio ao 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, será exibida uma mensagem de erro, Não foi possível conectar-se ao servidor,. A detecção avançada impede que os usuários sejam incomodados de repreencher o formulário. O servlet proxy lida com a solicitação de cabeçalho e não gera exceção.

Nesta página