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.
O proxy de serviço elimina o seguinte:
Os formulários HTML5 podem usar as seguintes topologias para se conectar aos servidores de AEM.
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:
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. |
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. |
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.