Configuração da ação Enviar configuring-the-submit-action

O Adobe recomenda o uso de Componentes principaisde captura de dados moderna e extensível para criar um novo Forms Adaptávelou adicionar o Forms Adaptável às páginas do AEM Sites. Esses componentes representam um avanço significativo na criação do Forms adaptável, garantindo experiências de usuário impressionantes. Este artigo descreve a abordagem mais antiga para criar o Forms adaptável usando componentes de base.

Introdução às ações de envio introduction-to-submit-actions

Uma ação de envio é acionada quando um usuário clica no botão Enviar em um formulário adaptável. É possível configurar a ação enviar no formulário adaptável. Os formulários adaptáveis fornecem algumas ações de envio prontas para uso. Você pode copiar e estender as ações de envio padrão para criar sua própria ação de envio. No entanto, com base em seus requisitos, você pode gravar e registrar sua própria ação de envio para processar dados no formulário enviado. A ação de envio pode usar envio síncrono ou assíncrono.

Você pode configurar uma ação de envio na seção Envio das propriedades do Contêiner de formulário adaptável, na barra lateral.

Configurar ação de envio

As ações de envio padrão disponíveis com formulários adaptáveis são:

Você pode escrever uma ação de envio personalizada para formulários adaptáveis para atender ao seu caso de uso. Para obter mais informações, consulte Escrevendo ação enviar personalizada para formulários adaptáveis.

Enviar para endpoint REST submit-to-rest-endpoint

A opção de envio Enviar para o ponto de extremidade REST passa os dados preenchidos no formulário para uma página de confirmação configurada como parte da solicitação HTTP GET. Você pode adicionar o nome dos campos a serem solicitados. O formato da solicitação é:

{fieldName}={request parameter name}

Como mostrado na imagem abaixo, param1 e param2 são passados como parâmetros com valores copiados dos campos caixa de texto e caixa numérica para a próxima ação.

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

Configurar Ação De Envio De Ponto De Extremidade Rest

A Post enviou dados para um recurso ou ponto de extremidade rest externo  post-submitted-data-to-a-resource-or-external-rest-end-point-nbsp

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

Para publicar dados em um servidor interno, forneça o caminho do recurso. Os dados são publicados 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 publicar dados em um servidor externo, forneça um URL. O formato do URL é https://host:port/path_to_rest_end_point. Configure o caminho para lidar com a solicitação POST de forma anônima.

No exemplo acima, as informações inseridas pelo usuário em textbox são capturadas usando o parâmetro param1. A sintaxe para publicar dados capturados usando param1 é:

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

Da mesma forma, os parâmetros que você usa para lançar dados XML e anexos são dataXml e attachments.

Por exemplo, você usa esses dois parâmetros no script para analisar dados para um ponto final rest. Você usa 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 os dados de anexo.

Enviar e-mail send-email

A ação de envio Enviar Email envia um email para um ou mais destinatários após o envio bem-sucedido do formulário. O email gerado pode conter dados de formulário em um formato predefinido.

Enviar PDF por e-mail send-pdf-via-email

A ação de envio Enviar PDF via Email envia um email com um PDF contendo dados de formulário para um ou mais destinatários após o envio bem-sucedido do formulário.

Chamar um Forms Workflow invoke-a-forms-workflow

A opção de envio Enviar para Forms Workflow envia um xml de dados e anexos de arquivo (se houver) para um LiveCycle de Adobe ou AEM Forms existente no processo JEE.

Para obter informações sobre como configurar a ação de envio Enviar para Forms Workflow, consulte Envio e processamento de dados de formulário usando fluxos de trabalho de formulários.

Enviar usando modelo de dados do formulário submit-using-form-data-model

As gravações de ação de envio Enviar usando o Modelo de Dados de Formulário enviaram dados de formulário adaptáveis para o objeto de modelo de dados especificado em um modelo de dados de formulário para sua fonte de dados. Ao configurar a ação de envio, você pode escolher um objeto de modelo de dados cujos dados enviados deseja gravar na origem de dados.

Além disso, você pode 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 Integração de dados do AEM Forms.

Ação de envio do portal do Forms forms-portal-submit-action

A opção Enviar Ação do Forms Portal disponibiliza dados de formulário por meio de um AEM Forms Portal.

Para obter mais informações sobre o Portal do Forms e a ação de envio, consulte Componente de rascunhos e envios.

Chamar um fluxo de trabalho de AEM invoke-an-aem-workflow

A Ação de Envio Chamar um Fluxo de Trabalho de AEM associa um Formulário Adaptável a um Fluxo de Trabalho de AEM. Quando um formulário é enviado, o fluxo de trabalho associado é iniciado automaticamente na instância do Autor. É possível salvar o arquivo de dados, os anexos e o Documento de registro na pasta relativa ou na carga útil do fluxo de trabalho ou em uma variável. Se o workflow estiver marcado para armazenamento de dados externo, a opção variable estará disponível e não a opção payload. É possível 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.

Antes de usar a ação de envio Invocar um Fluxo de Trabalho de AEM, defina as configurações de DS de Experience Manager. Para obter informações sobre como criar um Fluxo de Trabalho do AEM, consulte Fluxos de trabalho centrados em formulários no OSGi.

A ação enviar coloca o seguinte no local da carga útil do fluxo de trabalho. No entanto, observe que somente a opção Variável será exibida se o modelo de fluxo de trabalho estiver marcado para armazenamento de dados externo, e não a opção de carga útil.

Enviar para o Power Automate microsoft-power-automate

Você pode configurar um Formulário adaptável para executar um fluxo da nuvem do Microsoft® Power Automate no envio. O formulário adaptável configurado envia dados capturados, anexos e documentos de registro para processamento no fluxo da nuvem do Power Automate. Ele ajuda você a criar uma experiência personalizada de captura de dados, aproveitando o poder do Microsoft® Power Automate para criar lógicas comerciais sobre dados capturados e automatizar os fluxos de trabalho do cliente. Estes são alguns exemplos do que você pode fazer após integrar um formulário adaptável ao Microsoft® Power Automate:

O editor Forms adaptável fornece a ação de envio Chamar um fluxo do Microsoft® Power Automate para enviar dados de formulários adaptáveis, anexos e Documento de registro para o fluxo da nuvem do Power Automate. Para usar a ação Enviar para enviar dados capturados para o Microsoft® Power Automate, Conecte sua instância do AEM Forms com o Microsoft® Power Automate

Após uma configuração bem-sucedida, use a ação de envio Chamar um fluxo do Microsoft® Power Automate para enviar dados a um Fluxo do Power Automate.

Enviar para a Lista Microsoft® SharePoint submit-to-sharedrive

A ação de envio Enviar para o SharePoint conecta um Formulário adaptável com um Armazenamento Microsoft® SharePoint. É possível enviar o arquivo de dados de formulário, os anexos ou o Documento de Registro para o Armazenamento do Microsoft® Sharepoint conectado.

Conectar um formulário adaptável à lista Microsoft® SharePoint connect-af-sharepoint-list

Para conectar um formulário adaptável à lista Microsoft® SharePoint:

Criar uma configuração de lista do SharePoint create-sharepoint-list-configuration

Para conectar o AEM Forms à sua lista do Microsoft® Sharepoint:

Usar o Enviar usando o Modelo de dados de formulário em um Formulário adaptável use-submit-using-fdm

Você pode usar a configuração da Lista do SharePoint criada em um Formulário adaptável para salvar dados ou o Documento de registro gerado em uma Lista do SharePoint. Execute as seguintes etapas para usar uma configuração de armazenamento de Lista do SharePoint em um Formulário adaptável como:

Ao enviar o formulário, os dados são salvos no Armazenamento de Lista do Microsoft® Sharepoint especificado.

Revalidação do lado do servidor no formulário adaptável server-side-revalidation-in-adaptive-form

Normalmente, em qualquer sistema de captura de dados online, os desenvolvedores colocam algumas validações do JavaScript no lado do cliente para aplicar algumas regras de negócios. Mas em navegadores modernos, os usuários finais têm uma maneira de ignorar essas validações e fazer envios manualmente usando várias técnicas, como o Console DevTools do navegador da Web. Tais técnicas também são válidas para formulários adaptativos. 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 violariam as regras de negócios aplicadas por um autor de formulários.

O recurso de revalidação do lado do servidor também permite executar as validações que um autor de formulários adaptáveis forneceu ao projetar um formulário adaptável no servidor. Isso evita qualquer possível comprometimento dos envios de dados e violações das regras de negócios representadas em termos de validações de formulário.

O que validar no servidor? what-to-validate-on-server-br

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

Ativar a validação do lado do servidor enabling-server-side-validation-br

Use a Revalidar no servidor em Contêiner de Formulário Adaptável na barra lateral para habilitar ou desabilitar a validação no servidor para o formulário atual.

Ativar a validação do 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 os dados enviados são apresentados ao usuário como um erro.

Suporte a funções personalizadas em expressões de validação supporting-custom-functions-in-validation-expressions-br

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

Suporte a funções personalizadas em 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 dependem de bibliotecas de terceiros de jquery e underscore.js.

Tratamento de erros na ação de envio error-handling-on-submit-action

Como parte das diretrizes de segurança e proteção do Experience Manager, configure páginas de erro personalizadas como 404.jsp e 500.jsp. Esses manipuladores são chamados quando ao enviar um formulário 404 ou 500 erros são exibidos. Os manipuladores também são chamados quando esses códigos de erro são acionados no nó do Publish.

Para obter mais informações, consulte Personalizando páginas mostradas pelo Manipulador de Erros.