AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.
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.
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 de proxy do serviço de formulários do HTML5
Os formulários do 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:
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 |
atividade |
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. |
Ao clicar no botão Enviar, os formulários do 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. |
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 de proxy passará todos os parâmetros, exceto submitUrl para o /bin/xfaforms/submit 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 do 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) para o servidor. Se o servidor não estiver disponível, uma mensagem de erro, Não foi possível conectar-se ao servidor, é 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.