O Proxy do 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 a URL do serviço de envio por meio do 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 AEM.
Topologias de proxy de serviço de formulários HTML5
Os formulários HTML5 se conectam aos servidores 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 AEM. Os formulários HTML5 conectam servidores AEM para executar as seguintes operações:
Os scripts marcados para serem executados 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 |
atividade |
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 onde os eventos são executados. |
Modelo |
Template contém o template 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. |
pacote |
o pacote é especificado como formulário. |
debugDir |
debugDir contém o diretório de depuração usado para processar 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 processar o formulário. |
contentRoot |
diretório raiz do modelo usado para renderizar o formulário. |
Dados |
bytes bata usados para renderizar o formulário. |
formDom |
DOM do formulário HTML5 no formato JSON. |
submiturl |
O URL onde o XML de dados é publicado. |
debugDir |
O diretório de depuração usado para processar o formulário. |
O proxy de serviço de envio atua como uma passagem se o URL de envio não estiver presente no parâmetro de solicitação. Ela age como uma passagem. Ele envia a solicitação para o ponto de acesso /bin/xfaforms/submitaction e envia a resposta para o tempo de execução do XFA.
O proxy de serviço de envio seleciona uma topologia se o URL de envio estiver presente no parâmetro de solicitação.
Se os servidores AEM publicarem os dados, o serviço de proxy atuará como uma passagem. Ele envia a solicitação para o ponto de acesso /bin/xfaforms/submitaction e envia a resposta para o tempo de execução do XFA.
Se o proxy publicar os dados, o serviço de proxy transmitirá todos os parâmetros, exceto submitUrl, para o /bin/xfaforms/submitaction ponto final e recebe 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 POST) para o servidor. Se o servidor não estiver disponível, uma mensagem de erro, Não foi possível se conectar ao servidor, é exibido. A detecção avançada evita que os usuários tenham dificuldade em preencher o formulário novamente. O servlet proxy manipula a solicitação head e não gera exceção.