Configurar envio assíncrono do AEM Adaptive Forms asynchronous-submission-of-adaptive-forms

Tradicionalmente, os formulários web são configurados para enviar de forma síncrona. No envio síncrono, quando os usuários enviam um formulário, eles são redirecionados para uma página de confirmação, uma página de agradecimento ou, em caso de falha de envio, uma página de erro. No entanto, experiências da Web modernas, como aplicativos de página única, estão ganhando popularidade, onde a página da Web permanece estática enquanto a interação cliente-servidor acontece em segundo plano. É possível configurar o envio assíncrono para fornecer essa experiência com o Adaptive Forms.

No envio assíncrono, quando um usuário envia um formulário, o desenvolvedor do formulário conecta uma experiência separada, como redirecionar para outro formulário ou uma seção separada do site. O autor também pode conectar serviços separados, como enviar dados para um armazenamento de dados diferente ou adicionar um mecanismo de análise personalizado. No caso de envio assíncrono, um Formulário adaptável se comporta como um aplicativo de página única, pois o formulário não é recarregado ou sua URL não é alterada quando os dados do formulário enviado são validados no servidor.

Leia para obter detalhes sobre o envio assíncrono no Adaptive Forms.

Configurar envio assíncrono configure

Para configurar o envio assíncrono para um Formulário adaptável:

Como o envio assíncrono funciona how-asynchronous-submission-works

Experience Manager Forms fornece manipuladores de sucesso e erro prontos para uso para envio de formulários. Os manipuladores são funções do lado do cliente executadas com base na resposta do servidor. Quando um formulário é enviado, os dados são transmitidos ao servidor para validação, o que retorna uma resposta ao cliente com informações sobre o evento bem-sucedido ou com erro para o envio. As informações são passadas como parâmetros para o manipulador relevante para executar a função.

Além disso, os autores e desenvolvedores de formulários podem escrever regras no nível do formulário para substituir os manipuladores padrão. Para obter mais informações, consulte Substituir manipuladores padrão usando regras.

Primeiro, vamos analisar a resposta do servidor em busca de eventos de sucesso e erro.

Resposta do servidor para evento de sucesso de envio server-response-for-submission-success-event

A estrutura da resposta do servidor para o evento de sucesso de envio é a seguinte:

{oneOf: [
{  properties : {
     contentType : {"type" : "string",  "enum" : ["xmlschema", "jsonschema"]},
    data : {type : "string", description : "Form data in XML or  JSON  format"},
   thankYouOption : {type : "string"}
   }},
  properties : {
     contentType : {"type" : "string",  "enum" : ["xmlschema", "jsonschema"]},
    data : {type : "string", description : "Form data in XML or  JSON  format"},
   thankYouContent: {type: "string"}
   }
]

}

A resposta do servidor em caso de envio de formulário bem-sucedido inclui:

O manipulador de sucesso lê a resposta do servidor e redireciona adequadamente para o URL da página configurada ou exibe uma mensagem.

Resposta do servidor para evento de erro de envio server-response-for-submission-error-event

A estrutura da resposta do servidor para o evento de erro de envio é a seguinte:

{
   errorCausedBy : "<CAPTCHA_VALIDATION or SERVER_SIDE_VALIDATION>",

   errors : [
               { "somExpression" : "<SOM Expression>",
                 "errorMessage"  : "<Error Message>"
               },
               ...
             ]
 }

A resposta do servidor em caso de erro no envio do formulário inclui:

O manipulador de erros lê a resposta do servidor e exibe a mensagem de erro no formulário.

Substituir manipuladores padrão usando regras custom

Desenvolvedores de formulários e autores podem escrever regras, no nível do formulário, para substituir manipuladores padrão. A resposta do servidor para eventos de sucesso e erro é exposta no nível do formulário, que os desenvolvedores podem acessar usando $event.data nas regras.

Execute as seguintes etapas para escrever regras para lidar com eventos bem-sucedidos e errados.