Criar uma ação enviar personalizada para o Forms adaptável writing-custom-submit-action-for-adaptive-forms

Um Formulário adaptável fornece várias Ações de envio prontas para uso (OOTB). Uma Ação de envio especifica detalhes das ações a serem executadas nos dados coletados por meio do Formulário adaptável. Por exemplo, enviar dados em um email.

Você pode criar uma Ação de Envio personalizada para adicionar funcionalidades não incluídas em Ações de Envio predefinidas ou não suportadas por meio de uma única Ação de Envio OOTB. Por exemplo, enviar dados para um fluxo de trabalho, salvar os dados em um armazenamento de dados, enviar uma notificação por email à pessoa que envia o formulário e enviar um email à pessoa responsável pelo processamento do formulário enviado para aprovações e rejeições por meio de uma única Ação de envio.

Formato de dados XML xml-data-format

Os dados XML são enviados ao servlet usando o parâmetro de solicitação jcr:data. As Ações de envio podem acessar o parâmetro para processar os dados. O código a seguir descreve o formato dos dados XML. Os campos associados ao modelo de formulário aparecem na seção afBoundData. Campos não vinculados aparecem na seção afUnoundData.

<?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 a tag HTML input) ao HTML de formulário renderizado. Esses campos ocultos podem conter valores necessários ao processar o envio do formulário. Ao enviar o formulário, esses valores de campo são postados de volta como parâmetros de solicitação que a Ação de envio pode usar durante o manuseio do envio. Os campos de entrada são chamados de campos de ação.

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

Um script pode fornecer os valores dos campos startTime e endTime quando o formulário é renderizado e antes do envio do formulário, respectivamente. O script de Ação de Envio post.jsp 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 de envio também podem usar os anexos de arquivo dos quais você faz upload usando o componente Anexo de arquivo. Os scripts de Ação Enviar podem acessar esses arquivos usando a API RequestParameter do sling. O método isFormField da API ajuda a identificar se o parâmetro de solicitação é um campo de arquivo ou de formulário. Você pode iterar sobre os parâmetros da Solicitação em uma Ação de envio para identificar os parâmetros de Anexo de arquivo.

O código de exemplo a seguir identifica os anexos de arquivo na solicitação. Em seguida, ele lê os dados no arquivo usando a Obter API. Por fim, ele cria um objeto 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()));
    }
}

Ao anexar arquivos ao Formulário adaptável, o servidor valida os anexos de arquivo após o envio do Formulário adaptável e retorna uma mensagem de erro se:

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

Depois de executar a ação necessária, o servlet Submit 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 Submit 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 do 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 Guide Submit. Você também pode configurar os parâmetros de Solicitação enviados para o URL de redirecionamento usando a API setRedirectParameters no servlet de Envio do guia.

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 seguintes etapas para criar uma Ação enviar personalizada que salve os dados no repositório do CRX e envie um email para você. O formulário adaptável contém o conteúdo do armazenamento de ação de envio OOTB (desaprovado) que salva os dados no repositório do CRX. Além disso, o AEM fornece uma API de Email que pode ser usada para enviar emails. Antes de usar a API de email, configure 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 do CRX.

Usar a propriedade submitService para ações de envio personalizadas submitservice-property

Ao definir a Ação de Envio personalizada, que inclui a propriedade submitService, o formulário aciona o FormSubmitActionService no envio. O FormSubmitActionService usa o método getServiceName para recuperar o valor da propriedade submitService. Com base no valor da propriedade submitService, o serviço invoca o método de envio apropriado. Inclua o FormSubmitActionService no pacote personalizado que você carregou para o servidor AEM Forms.

Adicione a propriedade submitService do tipo cadeia de caracteres ao sling:Folder de sua Ação de Envio personalizada para habilitar Adobe Sign para o Formulário adaptável. Você pode selecionar a opção Habilitar Adobe Sign na seção Assinatura Eletrônica das propriedades do contêiner de Formulário Adaptável somente após definir o valor da propriedade submitService da sua Ação de Envio personalizada.