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 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 servidores AEM a um público-alvo não intencional mais amplo.
• O URL de 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 de duas etapas. Para enviar os dados do formulário, o envio requer pelo menos duas jornadas para o servidor. Assim, o aumenta a carga no servidor.
• Os formulários HTML5 enviam dados na solicitação POST em vez de na solicitação PDF. Para um 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.

• Uma topologia em que formulários AEM Server ou HTML5 enviam dados via POST para o servidor.
• Uma topologia em que o servidor proxy envia dados de POST para o servidor.

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

Os formulários 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:

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 em scripts do lado do servidor e Serviços da Web.

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 formulários HTML5 enviam para o servidor.

Como o proxy de envio funciona?

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 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 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 de POST) ao servidor. Se o servidor não estiver disponível, uma mensagem de erro Não foi possível se conectar ao servidor, será 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.