Proxy de serviço de formulários do HTML5

ATENÇÃO

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.

Benefícios do Proxy de Serviço

O proxy de serviço elimina o seguinte:

O fluxo de trabalho de formulários do HTML5 requer a abertura do serviço de envio "/content/xfaforms/submit/default" para os usuários de formulários do 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 da solicitação PDF. Para um fluxo de trabalho envolvendo 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 AEM Server ou HTML5 forms 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 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:

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.

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.

Enviar dados

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.

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