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

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

Uma ação Enviar é acionada quando um usuário clica no botão Enviar em um formulário adaptável. É possível configurar a ação de envio 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 suas necessidades, você pode gravar e registrar sua própria ação de envio para processar dados no formulário enviado.

Quando um formulário é pré-preenchido ou submetido, os dados enviados são encaminhados por AEM para o massacre de dados para formatos intermediários. Os dados não são salvos em uma instância do AEM, exceto quando o formulário adaptável usa Acrobat Sign, verify, forms portal rascunho ou envio ou AEM Workflows

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

Figura: 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 Gravação da ação de Enviar personalizado para formulários adaptáveis.

Enviar para ponto de extremidade REST submit-to-rest-endpoint

O Enviar para ponto de extremidade REST a opção enviar passa 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.

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.

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

Postar dados enviados para um recurso ou ponto final de repouso externo  post-submitted-data-to-a-resource-or-external-rest-end-point-nbsp

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.

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.

Enviar e-mail send-email

O Enviar Email enviar ação envia 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.

Enviar PDF via Email send-pdf-via-email

O Enviar PDF via Email a ação enviar envia um email com um PDF contendo dados de formulário para um ou mais recipients no envio bem-sucedido do formulário.

Observação: Essa ação de envio está disponível para formulários adaptáveis baseados em XFA e formulários de adaptação baseados em XSD que têm o modelo Documento de registro.

Chamar um fluxo de trabalho de formulários invoke-a-forms-workflow

O Enviar para o fluxo de trabalho do Forms a opção enviar envia um xml de dados e anexos de arquivo (se houver) para um LiveCycle Adobe ou AEM Forms existente no processo JEE.

Para obter informações sobre como configurar a ação de envio do fluxo de trabalho Enviar para formulários, 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

O Enviar usando o Modelo de dados de formulário enviar gravações de ações enviadas para dados de formulário adaptável do 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 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 Integração de dados do AEM Forms.

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

O Ação de envio do portal do Forms torna os dados de formulário disponíveis por meio de um portal AEM Forms.

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

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

O Chamar um fluxo de trabalho AEM a ação enviar associa um formulário adaptável a um Fluxo de trabalho AEM. Quando um formulário é enviado, o fluxo de trabalho associado é iniciado automaticamente no nó de processamento. Além disso, ele coloca o arquivo de dados, os anexos e o documento de registro, se aplicável, no local da carga do fluxo de trabalho.

Antes de usar o Chamar um fluxo de trabalho AEM apresentar ação, definir as configurações do AEM DS. Para obter informações sobre como criar um Fluxo de Trabalho AEM, consulte Fluxos de trabalho centrados em formulários no OSGi.

Revalidação do lado do servidor em forma adaptável server-side-revalidation-in-adaptive-form

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 formulários adaptáveis. 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 de formulários adaptáveis 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? 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:

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

Figura: 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.

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

Às vezes, no caso de 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.

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

O autor pode configurar uma 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 de envio error-handling-on-submit-action

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

Para obter mais informações, consulte Personalização de páginas mostradas pelo Manipulador de erros.