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

Versão
Link do artigo
AEM 6.5
Clique aqui
AEM as a Cloud Service
Este artigo

Aplicável a: ✔️ componentes básicos do formulário adaptável. Componentes principais do formulário adaptável. O Adobe recomenda usar os Componentes principais para adicionar o Adaptive Forms a uma página do AEM Sites ou para criar Forms adaptável independente.

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

Também é possível estender as ações enviar padrão para criar sua própria Ação de envio.

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

Configurar ação de envio

Enviar para endpoint REST submit-to-rest-endpoint

Use o Enviar para Ponto de Extremidade REST ação para publicar os dados enviados em um 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.

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 publicar dados capturados usando param1 é:

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

Da mesma forma, os parâmetros usados 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 dados de anexo.

A variável Enviar para endpoint REST Ação enviar 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 transmitidos como parâmetros com valores copiados do caixa de texto e caixa numérica para a próxima ação.

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

Também é possível Habilitar solicitação POST e forneça um 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.

NOTE
Para passar 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 send-email

Você pode usar o Enviar e-mail Ação Enviar para enviar um email a 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 entrega, o nome do estado e o CEP são recuperados dos dados de formulário enviados.

"

Olá ${customer_Name},

O endereço a seguir é definido como o endereço de entrega padrão:
${customer_Name},
${customer_Shipping_Address},
${customer_State},
${customer_ZIPCode}

Atenciosamente,
WKND

"
NOTE
  • Todos os campos de formulário devem ter nomes de elementos diferentes, mesmo que os campos sejam colocados em painéis diferentes de um formulário adaptável.
  • O AEM as a Cloud Service exige que os e-mails de saída sejam criptografados. Por padrão, o email de saída é desativado. Para ativá-lo, envie um tíquete de suporte para Solicitando acesso.

Também é possível incluir anexos e um Documento de registro (DoR) no email. Para habilitar Anexar documento de registro Configurar 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 modelo de dados do formulário submit-using-form-data-model

A variável Enviar usando modelo de dados do formulário A ação enviar grava dados de formulário adaptável enviados 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 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 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 de AEM invoke-an-aem-workflow

A variável Chamar um fluxo de trabalho de AEM A ação enviar associa um formulário adaptável a um Fluxo de trabalho do 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:

  • Arquivo de dados: contém dados enviados para o Formulário adaptável. Você pode usar o Caminho do arquivo de dados opção para especificar o nome do arquivo e o caminho do arquivo relativo à 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 somente dados enviados sem criar uma hierarquia de pastas. Se o workflow estiver marcado para armazenamento de dados externo, use a opção variable 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 opção para especificar o nome da pasta para armazenar os anexos carregados no Formulário adaptável. A pasta é criada em relação à carga útil. Se o workflow estiver marcado para armazenamento de dados externo, use a opção variable e selecione a variável na lista de variáveis disponíveis para o modelo de workflow.

  • Documento do registro: contém o Documento de registro gerado para o Formulário adaptável. Você pode usar o Caminho do documento de registro opção para especificar o nome do documento de registro e o caminho do arquivo relativo à carga útil. Por exemplo, a variável /addresschange/DoR.pdf caminho cria uma pasta chamada addresschange relativo à carga útil e coloca o DoR.pdf em relação à carga útil. Também é possível especificar somente DoR.pdf para salvar somente o Documento de registro sem criar uma hierarquia de pastas. Se o workflow estiver marcado para armazenamento de dados externo, use a opção variable 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 de AEM Ação de envio 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 onde o fluxo de trabalho do Forms ou AEM é acionado. Pode ser o mesmo que o URL da instância do autor do AEM ou outro servidor.

  • Nome de usuário do servidor de processamento: nome de usuário do usuário do workflow

  • Senha do servidor de processamento: Senha do usuário do workflow

Enviar para o SharePoint submit-to-sharedrive

A variável Enviar para o SharePoint A ação enviar 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 o Enviar para a Biblioteca de documentos da SharePoint Enviar ação em um formulário adaptável:

  1. Criar uma configuração da biblioteca de documentos da SharePoint: ele conecta o AEM Forms ao seu Microsoft® Sharepoint Storage.
  2. Usar a ação enviar Enviar para o SharePoint em um Formulário adaptável: ele conecta seu formulário adaptável ao Microsoft® SharePoint configurado.

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:

  1. Vá para o Autor do AEM Forms instância > Ferramentas > Cloud Service > Microsoft® SharePoint.

  2. Depois de selecionar a variável Microsoft® SharePoint, você será redirecionado para Navegador SharePoint.

  3. Selecione um Contêiner de configuração. A configuração é armazenada no Contêiner de configuração selecionado.

  4. Clique em Criar > Biblioteca de documentos da SharePoint na lista suspensa. O assistente de configuração do SharePoint é exibido.

    Configuração do Sharepoint

  5. Especifique a Título, ID do cliente, Segredo do cliente e URL do OAuth. Para obter informações sobre como recuperar a ID do cliente, o Segredo do cliente e a ID do locatário para o URL do OAuth, consulte Documentação Microsoft®.

    • Você pode recuperar a variável Client ID e Client Secret do seu aplicativo no portal do Microsoft® Azure.
    • No portal do Microsoft® Azure, adicione o URI de redirecionamento como https://[author-instance]/libs/cq/sharepoint/content/configurations/wizard.html. Substituir [author-instance] com o URL da sua instância do Author.
    • Adicionar as permissões da API offline_access e Sites.Manage.All para fornecer permissões de leitura/gravação.
    • Usar URL do OAuth: https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize. Substituir <tenant-id> com o tenant-id do seu aplicativo no portal do Microsoft® Azure.
    note note
    NOTE
    A variável segredo do cliente é obrigatório ou opcional depende da configuração do aplicativo do Azure Ative Diretory. Se o aplicativo estiver configurado para usar um segredo do cliente, é obrigatório fornecer o segredo do cliente.
  6. Clique em Conectar. Em uma conexão bem-sucedida, a variável Connection Successful é exibida.

  7. Agora, selecione Site do SharePoint > Biblioteca de documentos > Pasta do SharePoint, para salvar os dados.

    note note
    NOTE
    • Por padrão, forms-ootb-storage-adaptive-forms-submission está presente no site do SharePoint selecionado.
    • Criar uma pasta como forms-ootb-storage-adaptive-forms-submission, se ainda não estiver presente no Documents do site do SharePoint selecionado clicando em Criar pasta.

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:

  1. Criar um Formulário adaptável.

    note note
    NOTE
    • Selecionar o mesmo Contêiner de configuração para um Formulário adaptável, em que você criou o armazenamento da Biblioteca de documentos da SharePoint.
    • Se não Contêiner de configuração for selecionada, a variável global Configuração de armazenamento pastas são exibidas na janela de propriedades Submeter Ação.
  2. Selecionar Ação de envio as Enviar para o SharePoint.
    GIF do Sharepoint

  3. Selecione o Configuração de armazenamento, onde deseja salvar os dados.

  4. Clique em Salvar para salvar as configurações de Envio.

Ao enviar o formulário, os dados são salvos no Armazenamento da Biblioteca de Documentos do Microsoft® Sharepoint especificado.
A estrutura de pastas para salvar os 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 o Enviar para a lista do SharePoint Enviar ação em um formulário adaptável:

  1. Criar uma configuração de lista do SharePoint: ele conecta o AEM Forms ao seu Armazenamento de lista do Microsoft® Sharepoint.
  2. Usar o Enviar usando o Modelo de dados de formulário em um Formulário adaptável: ele conecta seu formulário adaptável ao Microsoft® SharePoint configurado.

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

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

  1. Ir para Ferramentas > Cloud Service > Microsoft® SharePoint.

  2. Selecione um Contêiner de configuração. A configuração é armazenada no Contêiner de configuração selecionado.

  3. Clique em Criar > Lista do SharePoint na lista suspensa. O assistente de configuração do SharePoint é exibido.

  4. Especifique a Título, ID do cliente, Segredo do cliente e URL do OAuth. Para obter informações sobre como recuperar a ID do cliente, o Segredo do cliente e a ID do locatário para o URL do OAuth, consulte Documentação Microsoft®.

    • Você pode recuperar a variável Client ID e Client Secret do seu aplicativo no portal do Microsoft® Azure.

    • No portal do Microsoft® Azure, adicione o URI de redirecionamento como https://[author-instance]/libs/cq/sharepointlist/content/configurations/wizard.html. Substituir [author-instance] com o URL da sua instância do Author.

    • Adicionar as permissões da API offline_access e Sites.Manage.All no Gráfico Microsoft® para fornecer permissões de leitura/gravação. Adicionar AllSites.Manage permissão na Sharepoint para interagir remotamente com os dados do SharePoint.

    • Usar URL do OAuth: https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize. Substituir <tenant-id> com o tenant-id do seu aplicativo no portal do Microsoft® Azure.

      note note
      NOTE
      A variável segredo do cliente é obrigatório ou opcional depende da configuração do aplicativo do Azure Ative Diretory. Se o aplicativo estiver configurado para usar um segredo do cliente, é obrigatório fornecer o segredo do cliente.
  5. Clique em Conectar. Em uma conexão bem-sucedida, a variável Connection Successful é exibida.

  6. Selecionar Site do SharePoint e Lista do SharePoint na lista suspensa.

  7. Selecionar Criar para criar a configuração de nuvem do Microsoft® SharePointList.

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.

NOTE
Na Lista do Microsoft® SharePoint, os seguintes tipos de coluna não são suportados:
  • coluna de imagem
  • coluna de metadados
  • coluna de pessoa
  • coluna de dados externos

Enviar para o OneDrive submit-to-onedrive

A variável Enviar para o OneDrive A ação enviar conecta um formulário adaptável a 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 o Enviar para o OneDrive Enviar ação em um formulário adaptável:

  1. Criar uma Configuração do OneDrive: ele conecta o AEM Forms ao seu Microsoft® OneDrive Storage.
  2. Usar a ação de envio Enviar para o OneDrive em um Formulário adaptável: ele conecta seu formulário adaptável ao Microsoft® OneDrive configurado.

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

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

  1. Vá para o Autor do AEM Forms instância > Ferramentas > Cloud Service > Microsoft® OneDrive.

  2. Depois de selecionar a variável Microsoft® OneDrive, você será redirecionado para Navegador do OneDrive.

  3. Selecione um Contêiner de configuração. A configuração é armazenada no Contêiner de configuração selecionado.

  4. Clique em Criar. O assistente de configuração do OneDrive é exibido.

    Tela de Configuração do OneDrive

  5. Especifique a Título, ID do cliente, Segredo do cliente e URL do OAuth. Para obter informações sobre como recuperar a ID do cliente, o Segredo do cliente e a ID do locatário para o URL do OAuth, consulte Documentação Microsoft®.

    • Você pode recuperar a variável Client ID e Client Secret do seu aplicativo no portal do Microsoft® Azure.
    • No portal do Microsoft® Azure, adicione o URI de redirecionamento como https://[author-instance]/libs/cq/onedrive/content/configurations/wizard.html. Substituir [author-instance] com o URL da sua instância do Author.
    • Adicionar as permissões da API offline_access e Files.ReadWrite.All para fornecer permissões de leitura/gravação.
    • Usar URL do OAuth: https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize. Substituir <tenant-id> com o tenant-id do seu aplicativo no portal do Microsoft® Azure.
    note note
    NOTE
    A variável segredo do cliente é obrigatório ou opcional depende da configuração do aplicativo do Azure Ative Diretory. Se o aplicativo estiver configurado para usar um segredo do cliente, é obrigatório fornecer o segredo do cliente.
  6. Clique em Conectar. Em uma conexão bem-sucedida, a variável Connection Successful é exibida.

  7. Agora, selecione Container do OneDrive > [Pasta do OneDrive] para salvar os dados.

    note note
    NOTE
    • Por padrão, forms-ootb-storage-adaptive-forms-submission está presente no OneDrive Container.
    • Criar uma pasta como forms-ootb-storage-adaptive-forms-submission, se ainda não estiver presente clicando em Criar pasta.

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:

  1. Criar um Formulário adaptável.

    note note
    NOTE
    • Selecionar o mesmo Contêiner de configuração para um Formulário adaptável, em que você criou seu armazenamento do OneDrive.
    • Se não Contêiner de configuração for selecionada, a variável global Configuração de armazenamento pastas são exibidas na janela de propriedades Submeter Ação.
  2. Selecionar Ação de envio as Enviar para o OneDrive.
    GIF do OneDrive

  3. Selecione o Configuração de armazenamento, onde deseja salvar os dados.

  4. Clique em Salvar para salvar as configurações de Envio.

Ao enviar o formulário, os dados são salvos no Armazenamento do Microsoft® OneDrive especificado.
A estrutura de pastas para salvar os 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 variável Enviar para o Armazenamento Azure Blob A ação enviar 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:

  1. Criar um contêiner de armazenamento do Azure Blob: conecta o AEM Forms aos contêineres de Armazenamento do Azure.
  2. Usar a configuração de armazenamento do Azure em um formulário adaptável: ele conecta seu Formulário adaptável aos contêineres configurados do Armazenamento 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:

  1. Vá para o Autor do AEM Forms instância > Ferramentas > Cloud Service > Armazenamento do Azure.

  2. Depois de selecionar a variável Armazenamento do Azure, você será redirecionado para Navegador de armazenamento do Azure.

  3. Selecione um Contêiner de configuração. A configuração é armazenada no Contêiner de configuração selecionado.

  4. Clique em Criar. O assistente Criar configuração de armazenamento do Azure é exibido.

    Configuração de armazenamento do Azure

  5. Especifique a Título, Conta de armazenamento do Azure e Chave de acesso do Azure.

    • Você pode recuperar Azure Storage Account nome e Azure Access key a partir das Contas de armazenamento no portal Microsoft® Azure.
  6. Clique em Salvar.

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:

  1. Criar um Formulário adaptável.

    note note
    NOTE
    • Selecionar o mesmo Contêiner de configuração para um Formulário adaptável, em que você criou seu armazenamento do OneDrive.
    • Se não Contêiner de configuração for selecionada, a variável global Configuração de armazenamento pastas são exibidas na janela de propriedades Submeter Ação.
  2. Selecionar Ação de envio as Enviar para o Armazenamento Azure Blob.
    GIF de armazenamento do Azure Blob

  3. Selecione o Configuração de armazenamento, onde deseja salvar os dados.

  4. Clique em Salvar para salvar as configurações de Envio.

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

Para definir valores de uma configuração, Gerar configurações de OSGi usando o SDK do AEM, e implantar a configuração para a 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:

  • Usar dados adaptáveis do Forms em processos de negócios do Power Automate
  • Use o Power Automate para enviar dados capturados para mais de 500 fontes de dados ou qualquer API disponível publicamente
  • Realizar cálculos complexos em dados capturados
  • Salve os dados do Forms adaptável em sistemas de armazenamento em uma programação predefinida

O editor Forms adaptável fornece a Chamar um fluxo do Microsoft® Power Automate a ação de envio para enviar dados de formulários adaptáveis, anexos e Documento de registro são enviados 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 Forms as a Cloud Service com o Microsoft® Power Automate

Após uma configuração bem-sucedida, use o Chamar um fluxo do Microsoft® Power Automate ação de envio 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 Forms adaptável fornece a Chamar um cenário do Workfront Fusion enviar ação para enviar dados ou anexos do Adaptive Forms para um cenário do Workfront Fusion. Para usar a ação enviar para enviar dados capturados para um cenário do Workfront Fusion, consulte Enviar um formulário adaptável ao 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. É possível 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 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. Agora você pode fornecer essa experiência com o Forms adaptável ao configuração do 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:

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

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

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.

Ativar a validação do lado do servidor

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.

NOTE
A validação do lado do servidor valida o modelo de formulário. É recomendável criar uma biblioteca do 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 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 reside em funções personalizadas e o autor chama essas funções personalizadas a partir da expressão de validação de campo. Para tornar essa biblioteca de funções personalizadas conhecida e disponível ao executar validações do lado do servidor, o autor do formulário pode configurar o nome da biblioteca do cliente AEM no 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

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ó 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 dados XML ou JSON, faça uma reclamação para um esquema cujos dados não contêm <afData>, <afBoundData>, e </afUnboundData> , os dados de campos não vinculados do Formulário adaptável serão perdidos. O esquema pode ser um esquema XML, esquema JSON ou um modelo de dados de formulário. Os campos não limitados são campos do Formulário adaptável sem bindref propriedade.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab