Ação de envio de formulário adaptável

Uma ação Enviar é acionada quando um usuário clica no botão Enviar em um formulário adaptável. O Adaptive Forms fornece algumas ações de envio prontas para uso. As Ações de envio disponíveis prontas para uso são:

Você também pode estender as ações de envio padrão para criar sua própria Ação de envio.

É possível configurar uma Ação de envio na variável Submissão seção das propriedades do Contêiner de formulário adaptável, na barra lateral.

Configurar ação de envio

Enviar para ponto de extremidade REST

Use o Enviar para Ponto de Extremidade REST para postar os dados enviados em um URL restante. O URL pode ser de um servidor interno (o servidor no qual o formulário é renderizado) ou externo.

Para postar dados em um servidor interno, forneça o caminho do recurso. Os dados são postados no caminho do recurso. Por exemplo, /content/restEndPoint. Para essas solicitações de publicação, as informações de autenticação da solicitação de envio são usadas.

Para postar dados em um servidor externo, forneça um URL. O formato do URL é https://host:port/path_to_rest_end_point. Certifique-se de configurar o caminho para lidar com a solicitação POST anonimamente.

Mapeamento para valores de campo passados como parâmetros da Página de agradecimento

No exemplo acima, o usuário inseriu informações em textbox é capturado usando o parâmetro param1. Sintaxe para postar dados capturados usando param1 é:

String data=request.getParameter("param1");

Da mesma forma, os parâmetros usados para publicar dados e anexos XML são dataXml e attachments.

Por exemplo, esses dois parâmetros são usados no script para analisar os dados em um ponto de extremidade de repouso. Use a seguinte sintaxe para armazenar e analisar os dados:

String data=request.getParameter("dataXml");
String att=request.getParameter("attachments");

Neste exemplo, data armazena os dados XML, e att armazena dados de anexo.

O Enviar para ponto de extremidade REST Enviar Ação envia os dados preenchidos no formulário para uma página de confirmação configurada como parte da solicitação HTTP GET. É possível adicionar o nome dos campos a serem solicitados. O formato da solicitação é:

{fieldName}={request parameter name}

Conforme mostrado na imagem abaixo, param1 e param2 são transmitidos como parâmetros com valores copiados do caixa de texto e numericbox campos para a próxima ação.

Configurar a ação de envio do ponto de extremidade restante

Você também pode Habilitar solicitação de POST e forneça um URL para postar a solicitação. Para enviar dados para o servidor AEM que hospeda o formulário, use um caminho relativo correspondente ao caminho raiz do servidor AEM. Por exemplo, /content/forms/af/SampleForm.html. Para enviar dados para qualquer outro servidor, use o caminho absoluto.

OBSERVAÇÃO

Para transmitir os campos como parâmetros em um URL REST, todos os campos devem ter nomes de elemento diferentes, mesmo se os campos forem colocados em painéis diferentes.

Enviar e-mail

Você pode usar o Enviar Email Enviar ação para enviar um email para um ou mais recipients após o envio bem-sucedido do formulário. O email gerado pode conter dados de formulário em um formato predefinido. Por exemplo, no modelo a seguir, o nome do cliente, o endereço de envio, o nome do estado e o CEP são recuperados dos dados de formulário enviados.

"

Olá ${customer_Name},

O seguinte é definido como seu endereço de envio padrão:
${customer_Name},
${customer_Shipping_Address},
${customer_State},
${customer_ZIPCode}

Atenção,
WKND

"
OBSERVAÇÃO
  • Todos os campos do formulário devem ter nomes de elementos diferentes, mesmo que os campos sejam colocados em painéis diferentes de um formulário adaptável.
  • AEM as a Cloud Service requer que o email de saída seja criptografado. Por padrão, o email de saída é desativado. Para ativá-la, envie um tíquete de suporte para Solicitar acesso.

Você também pode incluir anexos e um Documento de registro (DoR) no email. Para ativar Anexar documento de registro , configure o formulário adaptável para gerar um documento de registro (DoR). Você pode ativar a opção para gerar um Documento de registro das propriedades do formulário adaptável.

Enviar usando modelo de dados do formulário

O Enviar usando o Modelo de dados de formulário Enviar ação grava dados enviados do Formulário adaptável para o objeto de modelo de dados especificado em um Modelo de dados de formulário para a fonte de dados. Ao configurar a Ação de envio, você pode escolher um objeto de modelo de dados cujos dados enviados deseja gravar de volta em sua fonte de dados.

Além disso, é possível enviar um anexo de formulário usando um Modelo de dados de formulário e um Documento de registro (DoR) para a fonte de dados. Para obter informações sobre o modelo de dados de formulário, consulte AEM Forms Integração de dados.

Chamar um fluxo de trabalho AEM

O Chamar um fluxo de trabalho AEM Enviar ação associa um Formulário adaptável a um Fluxo de trabalho AEM. Quando um formulário é enviado, o fluxo de trabalho associado é iniciado automaticamente na instância do autor. Você pode salvar o arquivo de dados, os anexos e o Documento de registro no local da carga do fluxo de trabalho ou em uma variável. Se o workflow estiver marcado para armazenamento externo de dados e configurado para um armazenamento externo de dados, somente a opção de variável estará disponível. Você pode selecionar na lista de variáveis disponíveis para o modelo de fluxo de trabalho. Se o workflow estiver marcado para armazenamento de dados externo em um estágio posterior e não no momento da criação do workflow, verifique se as configurações de variável necessárias estão em vigor.

A Ação de envio coloca o seguinte no local de carga do fluxo de trabalho ou a variável se o fluxo de trabalho estiver marcado para armazenamento de dados externo:

  • Arquivo de dados: Ele contém os dados enviados para o formulário adaptável. Você pode usar o Caminho do arquivo de dados para especificar o nome do arquivo e o caminho do arquivo em relação à carga útil. Por exemplo, a variável /addresschange/data.xml caminho cria uma pasta chamada addresschange e o coloca em relação à carga útil. Também é possível especificar somente data.xml para enviar apenas dados enviados sem criar uma hierarquia de pastas. Se o workflow estiver marcado para armazenamento externo de dados, use a opção de variável e selecione a variável na lista de variáveis disponíveis para o modelo de workflow.

  • Anexos: Você pode usar o Caminho do anexo para especificar o nome da pasta para armazenar os anexos carregados no Formulário adaptável. A pasta é criada em relação à carga. Se o workflow estiver marcado para armazenamento externo de dados, use a opção de variável e selecione a variável na lista de variáveis disponíveis para o modelo de workflow.

  • Documento de registro: Ele contém o Documento de registro gerado para o formulário adaptável. Você pode usar o Documento de caminho de registro para especificar o nome do arquivo Documento de registro e o caminho do arquivo em relação à carga útil. Por exemplo, a variável /addresschange/DoR.pdf caminho cria uma pasta chamada addresschange relativo à carga e posiciona a variável DoR.pdf relativo à carga. Também é possível especificar somente DoR.pdf para salvar somente o Documento de registro sem criar uma hierarquia de pasta. Se o workflow estiver marcado para armazenamento externo de dados, use a opção de variável e selecione a variável na lista de variáveis disponíveis para o modelo de workflow.

Antes de usar o Chamar um fluxo de trabalho AEM Enviar ação configure o seguinte para o Serviço de configurações do AEM DS configuração:

  • URL do servidor de processamento: O Servidor de processamento é o servidor no qual o Forms ou AEM Workflow é acionado. Isso pode ser igual ao URL da instância do autor do AEM ou de outro servidor.

  • Nome de usuário do servidor de processamento: Nome de usuário do usuário do fluxo de trabalho

  • Senha do servidor de processamento: Senha do usuário do fluxo de trabalho

Para definir valores de uma configuração, Gerar configurações de OSGi usando o SDK AEMe implantar a configuração para a instância do Cloud Service.

Usar envio síncrono ou assíncrono

Uma Ação de envio pode usar envio síncrono ou assíncrono.

Envio síncrono: Tradicionalmente, os formulários web são configurados para envio síncrono. Em um envio síncrono, quando os usuários enviam um formulário, ele é redirecionado para uma página de confirmação, uma página de agradecimento ou, se houver falha no envio, uma página de erro. Você pode selecionar a variável Usar envio assíncrono opção para redirecionar os usuários para uma página da Web ou mostrar uma mensagem no envio.

Configurar ação de envio

Envio assíncrono: Experiências modernas da Web, 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. Agora você pode fornecer essa experiência com o Adaptive Forms configuração do envio assíncrono.

Revalidação do lado do servidor em forma adaptável

Normalmente, em qualquer sistema de captura de dados online, os desenvolvedores colocam algumas validações de JavaScript no lado do cliente para impor algumas regras de negócios. Mas nos navegadores modernos, os usuários finais têm como ignorar essas validações e fazer envios manualmente usando várias técnicas, como o Console DevTools do navegador Web. Essas técnicas também são válidas para o Adaptive Forms. Um desenvolvedor de formulários pode criar várias lógicas de validação, mas tecnicamente os usuários finais podem ignorar essas lógicas de validação e enviar dados inválidos para o servidor. Dados inválidos quebrariam as regras de negócios que um autor de formulários executou.

O recurso de revalidação do lado do servidor também permite executar as validações fornecidas por um autor do Adaptive Forms ao projetar um formulário adaptável no servidor. Impede qualquer possível comprometimento de envios de dados e violações de regras comerciais representadas em termos de validações de formulários.

O que validar no Servidor?

Todas as validações de campo prontas para uso (OOTB) de um Formulário adaptável que são executadas novamente no servidor são:

  • Obrigatório
  • Cláusula de Imagem de Validação
  • Expressão de validação

Habilitar validação do lado do servidor

Use o Revalidar no servidor em Contêiner de formulário adaptável na barra lateral para ativar ou desativar a validação do lado do servidor para o formulário atual.

Ativação da validação no lado do servidor

Ativação da validação no lado do servidor

Se o usuário final ignorar essas validações e enviar os formulários, o servidor executará novamente a validação. Se a validação falhar no final do servidor, a transação de envio será interrompida. O usuário final é apresentado ao formulário original novamente. Os dados capturados e enviados são apresentados ao usuário como um erro.

OBSERVAÇÃO

A validação do lado do servidor valida o modelo de formulário. É recomendável criar uma biblioteca cliente separada para validações e não misturá-la com outras coisas, como estilo de HTML e manipulação de DOM na mesma biblioteca do cliente.

Suporte a funções personalizadas nas expressões de validação

Às vezes, se houver regras de validação complexas, o script de validação exato reside em funções personalizadas e o autor chama essas funções personalizadas da expressão de validação de campo. Para tornar essa biblioteca de funções personalizada conhecida e disponível ao executar validações do lado do servidor, o autor do formulário pode configurar o nome AEM biblioteca do cliente no Básico das propriedades do Contêiner de formulário adaptável, conforme mostrado abaixo.

Suporte a funções personalizadas nas expressões de validação

Suporte a funções personalizadas nas expressões de validação

O autor pode configurar a biblioteca JavaScript personalizada por Formulário adaptável. Na biblioteca, mantenha somente as funções reutilizáveis, que têm dependência em bibliotecas de terceiros jquery e underscore.js.

Tratamento de erros na ação Enviar

Como parte AEM diretrizes de segurança e proteção, configure páginas de erro personalizadas, como 400.jsp, 404.jsp e 500.jsp. Esses manipuladores são chamados quando um erro de formulário 400, 404 ou 500 é enviado. Os manipuladores também são chamados quando esses códigos de erro são acionados no nó Publicar . Você também pode criar páginas JSP para outros códigos de erro HTTP.

Ao preencher previamente um modelo de dados de formulário ou um formulário adaptável baseado em esquema com reclamação de dados XML ou JSON para um esquema que é dados não contém <afData>, <afBoundData>e </afUnboundData> , os dados dos campos não limitados do Formulário adaptável serão perdidos. O esquema pode ser um esquema XML, um esquema JSON ou um Modelo de dados de formulário. Campos não limitados são campos do Formulário adaptável sem a variável bindref propriedade.

Nesta página