Gravação da ação de Enviar personalizado para formulários adaptáveis writing-custom-submit-action-for-adaptive-forms

Formulários adaptáveis exigem ações de envio para processar dados especificados pelo usuário. Uma ação Enviar determina a tarefa executada nos dados enviados por meio de um formulário adaptável. Adobe Experience Manager (AEM) inclui Ações de envio de OOTB que demonstram as tarefas personalizadas que você pode executar usando os dados enviados pelo usuário. Por exemplo, é possível executar tarefas, como enviar emails ou armazenar dados.

Fluxo de trabalho para uma ação Enviar workflow-for-a-submit-action

O fluxograma descreve o fluxo de trabalho de uma ação Enviar que é acionada ao clicar no botão Enviar em um formulário adaptável. Os arquivos no componente Anexo de arquivo são carregados no servidor e os dados do formulário são atualizados com os URLs dos arquivos carregados. No cliente, os dados são armazenados no formato JSON. O cliente envia uma solicitação do Ajax para um servlet interno que massageia os dados especificados e os retorna no formato XML. O cliente combina esses dados com campos de ação. Ele envia os dados ao servlet final (servlet Guide Submit) por meio de uma ação Form Submit. Em seguida, o servlet encaminha o controle para a ação Enviar . A ação Enviar pode encaminhar a solicitação para um recurso de sling diferente ou redirecionar o navegador para outro URL.

Formato dos dados XML xml-data-format

Os dados XML são enviados para o servlet usando o jcr:data parâmetro de solicitação. As ações Enviar podem acessar o parâmetro para processar os dados. O código a seguir descreve o formato dos dados XML. Os campos vinculados ao modelo de formulário aparecem no afBoundData seção. Os campos não vinculados são exibidos na variável afUnoundData seção. Para obter mais informações sobre o formato da variável data.xml arquivo, consulte Introdução ao pré-preenchimento de campos de formulário adaptáveis.

<?xml ?>
<afData>
<afUnboundData>
<data>
<field1>value</field2>
<repeatablePanel>
    <field2>value</field2>
</repeatablePanel>
<repeatablePanel>
    <field2>value</field2>
</repeatablePanel>
</data>
</afUnboundData>
<afBoundData>
<!-- xml corresponding to the Form Model /XML Schema -->
</afBoundData>
</afData>

Campos de ação action-fields

Uma ação Enviar pode adicionar campos de entrada ocultos (usando o HTML input tag) para o HTML de formulário renderizado. Esses campos ocultos podem conter valores necessários durante o processamento do envio do formulário. Ao enviar o formulário, esses valores de campo são postados como parâmetros de solicitação que a ação Enviar pode usar durante o manuseio de envio. Os campos de entrada são chamados de campos de ação.

Por exemplo, uma ação Enviar que também captura o tempo gasto para preencher um formulário pode adicionar os campos de entrada ocultos startTime e endTime.

Um script pode fornecer os valores da variável startTime e endTime campos quando o formulário é renderizado e antes do envio do formulário, respectivamente. O script de ação Enviar post.jsp O pode então acessar esses campos usando parâmetros de solicitação e calcular o tempo total necessário para preencher o formulário.

Anexos de arquivo file-attachments

As ações Enviar também podem usar os anexos de arquivo que você faz upload usando o componente Anexo de arquivo . Enviar scripts de ação podem acessar esses arquivos usando o sling API RequestParameter. O isFormField O método da API ajuda a identificar se o parâmetro da solicitação é um arquivo ou um campo de formulário. Você pode iterar sobre os parâmetros da Solicitação em uma ação Enviar para identificar os parâmetros do Anexo de arquivo.

O código de exemplo a seguir identifica os anexos do arquivo na solicitação. Em seguida, ele lê os dados no arquivo usando o Obter API. Finalmente, ele cria um objeto de Documento usando os dados e o anexa a uma lista.

RequestParameterMap requestParameterMap = slingRequest.getRequestParameterMap();
for (Map.Entry<String, RequestParameter[]> param : requestParameterMap.entrySet()) {
    RequestParameter rpm = param.getValue()[0];
    if(!rpm.isFormField()) {
        fileAttachments.add(new Document(rpm.get()));
    }
}

Caminho de encaminhamento e URL de redirecionamento forward-path-and-redirect-url

Depois de executar a ação necessária, o servlet Enviar encaminha a solicitação para o caminho de encaminhamento. Uma ação usa a API setForwardPath para definir o caminho de encaminhamento no servlet Guide Submit.

Se a ação não fornecer um caminho de encaminhamento, o servlet Enviar redirecionará o navegador usando o URL de redirecionamento. O autor configura o URL de redirecionamento usando a configuração da Página de agradecimento na caixa de diálogo Edição de formulário adaptável. Você também pode configurar o URL de redirecionamento por meio da ação Enviar ou da API setRedirectUrl no servlet Enviar Guia. Você também pode configurar os parâmetros de Solicitação enviados para o URL de redirecionamento usando a API setRedirectParameters no servlet Guide Submit.

Ação de envio submit-action

Uma ação Enviar é uma sling:Folder que inclui o seguinte:

Criação de uma ação de envio personalizada creating-a-custom-submit-action

Execute as etapas a seguir para criar uma ação de Enviar personalizada que salve os dados no repositório CRX e, em seguida, envie um email para você. O formulário adaptável contém a ação OOTB Submit Store Content (obsoleto) que salva os dados no repositório CRX. Além disso, o CQ fornece uma Email API que pode ser usada para enviar emails. Antes de usar a API de email, [configure](https://docs.adobe.com/docs/en/cq/current/administering/notification.html?#Configuring o serviço de email) o serviço Day CQ Mail por meio do console do sistema. Você pode reutilizar a ação Armazenar conteúdo (obsoleto) para armazenar os dados no repositório. A ação Armazenar conteúdo (obsoleto) está disponível no local /libs/fd/af/components/guidesubmittype/store no repositório CRX.