Ação de envio do formulário adaptável configuring-the-submit-action

Aplica-se a: ✔️ componentes de base do formulário adaptável. Componentes principais do formulário adaptável. A Adobe recomenda usar os Componentes principais para adicionar o Adaptive Forms a uma Página do AEM Sites ou para criar o Adaptive Forms independente.

Uma Ação de Envio é acionada quando um usuário clica no botão Enviar em um Formulário adaptável. O Forms as a Cloud Service fornece as seguintes ações de envio prontas para uso.

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

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.

Enviar para endpoint REST submit-to-rest-endpoint

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

A Ação de Envio Enviar para o ponto de extremidade REST envia 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 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.

Enviar e-mail send-email

Você pode usar a Ação Enviar Email para enviar 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. Por exemplo, no modelo a seguir, o nome do cliente, o endereço de entrega, o nome do estado e o CEP são recuperados dos dados de formulário enviados.

"

Olá, ${customer_Name},

Os itens a seguir estão definidos como seu endereço de entrega padrão:
${customer_Name},
${customer_Shipping_Address},
${customer_State},
${customer_ZIPCode}

Atenciosamente,
WKND

"

Também é possível incluir anexos e um Documento de registro (DoR) no email. Para habilitar a opção 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 a partir das propriedades do Formulário adaptável.

Enviar usando o Modelo de dados de formulário (FDM) submit-using-form-data-model

A Ação de Envio Enviar usando o Modelo de Dados de Formulário grava dados de Formulário adaptável enviados para o objeto de modelo de dados especificado em um Modelo de Dados de Formulário (FDM) para sua fonte de dados. Ao configurar a Ação Submeter, você pode escolher um objeto de modelo de dados cujos dados submetidos você 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 (FDM) e um Documento de registro (DoR) para a fonte de dados. Para obter informações sobre o modelo de dados de formulário (FDM), consulte AEM Forms Integração de Dados.

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. Você pode salvar o arquivo de dados, os anexos e o Documento de registro no local da carga útil do fluxo de trabalho ou em uma variável. Se o workflow estiver marcado para armazenamento de dados externo e configurado para um armazenamento de dados externo, então somente a opção de variável estará disponível. É 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.

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

Antes de usar a ação enviar Invocar um fluxo de trabalho de AEM, configure o seguinte para a configuração do serviço de configurações do AEM:

Enviar para o SharePoint submit-to-sharedrive

A ação enviar 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.

Usando a opção Enviar para o SharePoint, você pode:

Conectar um formulário adaptável à biblioteca de documentos do SharePoint connect-af-sharepoint-doc-library

Para usar a Ação Enviar Enviar para a Biblioteca de Documentos do SharePoint em um Formulário adaptável:

Criar uma configuração da Biblioteca de documentos da SharePoint create-sharepoint-configuration

Para conectar o AEM Forms ao seu Microsoft® Sharepoint Document Library Storage:

Agora, você pode usar essa configuração do SharePoint Sites para a ação enviar em um Formulário adaptável.

Usar a configuração da biblioteca de documentos SharePoint em um formulário adaptável use-sharepoint-configuartion-in-af

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

Ao enviar o formulário, os dados são salvos no Armazenamento da Biblioteca de Documentos do Microsoft® Sharepoint especificado.
A estrutura de pasta para salvar dados é /folder_name/form_name/year/month/date/submission_id/data.

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

Para usar a ação enviar Enviar para a Lista do SharePoint em um formulário adaptável:

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 (FDM) 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.

Enviar para o OneDrive submit-to-onedrive

A Ação de Envio Enviar para o OneDrive conecta um Formulário adaptável com um Microsoft® OneDrive. Você pode enviar os dados do formulário, arquivo, anexos ou Documento de registro para o Microsoft® OneDrive Storage conectado. Para usar a Ação de Envio Enviar para o OneDrive em um Formulário Adaptável:

Criar uma Configuração do OneDrive create-onedrice-configuration

Para conectar o AEM Forms ao seu Microsoft® OneDrive Storage:

Agora, você pode usar esta configuração de armazenamento do OneDrive para a ação de envio em um Formulário adaptável.

Usar a configuração do OneDrive em um formulário adaptável use-onedrive-configuartion-in-af

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

Ao enviar o formulário, os dados são salvos no Armazenamento do Microsoft® OneDrive especificado.
A estrutura de pasta para salvar dados é /folder_name/form_name/year/month/date/submission_id/data.

Enviar para o Armazenamento de blob do Azure submit-to-azure-blob-storage

A Ação de envio Enviar para o Armazenamento de Blobs do Azure conecta um Formulário adaptável a um portal do Microsoft® Azure. Você pode enviar os dados do formulário, o arquivo, os anexos ou o Documento de registro para os contêineres conectados do Armazenamento do Azure. Para usar a ação Enviar para o Armazenamento de blobs do Azure:

Criar um contêiner de armazenamento do Azure Blob create-azure-configuration

Para conectar o AEM Forms aos seus contêineres de Armazenamento do Azure:

Agora, você pode usar essa configuração do contêiner de Armazenamento do Azure para a ação de envio em um Formulário adaptável.

Usar a configuração de armazenamento do Azure em um formulário adaptável use-azure-storage-configuartion-in-af

Você pode usar a configuração do contêiner de Armazenamento do Azure criada em um Formulário adaptável, para salvar dados ou o Documento de registro gerado no contêiner de Armazenamento do Azure. Execute as seguintes etapas para usar a configuração do contêiner de Armazenamento do Azure em um Formulário adaptável como:

Ao enviar o formulário, os dados são salvos na configuração especificada do contêiner de Armazenamento do Azure.
A estrutura de pasta para salvar dados é /configuration_container/form_name/year/month/date/submission_id/data.

Para definir valores de uma configuração, Gere Configurações OSGi usando o SDK do AEM e implante a configuração na instância do Cloud Service.

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 Documentos 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 as a Cloud Service do 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 o Workfront Fusion workfront-fusion

Você pode configurar um Formulário adaptável para enviar dados ao Workfront Fusion no envio. O Workfront Fusion permite a automação de processos para que o usuário possa se concentrar em novas tarefas, em vez de repetir as mesmas tarefas repetidamente. Ele automatiza tarefas simples e complexas, economizando tempo e garantindo uma execução consistente do processo.

O editor do Adaptive Forms fornece a ação de envio Chamar um Cenário do Workfront Fusion para enviar dados ou anexos do Adaptive Forms para um cenário do Workfront Fusion. Para usar a ação de envio para enviar dados capturados para um cenário do Workfront Fusion, consulte Enviar um Formulário adaptável para o Adobe Workfront Fusion.

Usar envio síncrono ou assíncrono use-synchronous-or-asynchronous-submission

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 enviar de forma síncrona. Em um 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, se houver falha de envio, uma página de erro. Você pode selecionar a opção Usar envio assíncrono para redirecionar os usuários para uma página da Web ou mostrar uma mensagem no envio.

Envio assíncrono: 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 ocorre em segundo plano. Agora você pode fornecer essa experiência com o Adaptive Forms ao configurar o envio assíncrono.

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. 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 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 do Adaptive Forms forneceu ao criar 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 (OOTB) 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 formulário original é apresentado ao usuário 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 enviar error-handling-on-submit-action

Como parte das diretrizes de segurança e proteção contra AEM, configure páginas de erro personalizadas como 400.jsp, 404.jsp e 500.jsp. Esses manipuladores são chamados quando ao enviar um formulário 400, 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. Você também pode criar páginas JSP para outros códigos de erro HTTP.

Quando você preenche um modelo de dados de formulário (FDM) ou um formulário adaptável baseado em esquema com reclamação de dados XML ou JSON para um esquema cujos dados não contêm as tags <afData>, <afBoundData> e </afUnboundData>, os dados de campos não vinculados do formulário adaptável são perdidos. O esquema pode ser um esquema XML, esquema JSON ou um Modelo de dados de formulário (FDM). Campos não limitados são campos de Formulário adaptável sem a propriedade bindref.