proxy do serviço de formulários HTML5

Última atualização em 2023-12-21
  • Tópicos
  • HTML5 Forms
    Exibir mais informações sobre este tópico

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.

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 os servidores AEM a um público-alvo não-intencional mais amplo.
  • A URL do serviço está incorporada no modelo de tempo de execução do formulário. Não é possível alterar o caminho da URL de 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, aumenta a carga no servidor.
  • Os formulários HTML5 enviam dados na solicitação POST em vez da solicitação PDF. Para fluxos de trabalho envolvendo formulários PDF e HTML5, são necessários dois métodos diferentes de processamento dos envios.

Topologias

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

  • Uma topologia em que o Servidor AEM ou o HTML 5 envia dados via POST para o servidor.
  • Uma topologia em que o servidor proxy envia dados de POST para o servidor.

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

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:

Executar scripts de servidor e serviços da Web

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.

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 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.

Como funciona o proxy de envio?

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.

Nesta página