Création d’une action Envoyer personnalisée pour les formulaires adaptatifs writing-custom-submit-action-for-adaptive-forms

Un formulaire adaptatif fournit plusieurs actions Envoyer prêtes à l’emploi. Une action Envoyer spécifie les détails des actions à effectuer sur les données collectées via le formulaire adaptatif, par exemple l’envoi de données sur un e-mail.

Vous pouvez créer une action Envoyer personnalisée pour ajouter des fonctionnalités non incluses dans les actions Envoyer prêtes à l’emploi ou qui ne sont pas prises en charge par une seule action Envoyer prête à l’emploi. Il peut s’agir par exemple de l’envoi de données à un processus, de l’enregistrement des données dans un magasin de données, de l’envoi d’une notification par e-mail à la personne qui envoie le formulaire et de l’envoi d’un e-mail à la personne responsable du traitement du formulaire envoyé pour approbation ou rejet par le biais d’une seule action Envoyer.

Format des données XML xml-data-format

Les données XML sont envoyées à la servlet à l’aide du paramètre de requête jcr:data. Les actions Envoyer peuvent accéder au paramètre pour traiter les données. Le code ci-après décrit le format des données XML. Les champs liés au modèle de formulaire apparaissent dans la section afBoundData. Les champs non liés apparaissent dans la afUnoundDatasection.

<?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>

Champs d’action action-fields

Une action Envoyer peut ajouter des champs d’entrée masqués (à l’aide de la balise HTML input) au code HTML du formulaire affiché. Ces champs masqués peuvent contenir les valeurs dont elle a besoin lors du traitement de l’envoi du formulaire. Lors de l’envoi du formulaire, ces valeurs de champ sont publiées en tant que paramètres de requête que l’action Envoyer peut utiliser lors de la gestion de l’envoi. Les champs d’entrée sont appelés champs d’action.

Par exemple, une action Envoyer qui capture également le temps nécessaire pour remplir un formulaire peut ajouter les champs d’entrée masqués startTime et endTime.

Un script peut fournir les valeurs des champs startTime et endTime lors du rendu du formulaire et avant l’envoi du formulaire. Le script de l’action Envoyer post.jsp peut ensuite accéder à ces champs à l’aide des paramètres de requête et calculer le temps total nécessaire au remplissage du formulaire.

Pièces jointes file-attachments

Les actions Envoyer peuvent également utiliser les pièces jointes que vous chargez à l’aide du composant Pièce jointe. Les scripts des actions Envoyer peuvent accéder à ces fichiers à l’aide de l’API RequestParameter sling. La méthode isFormField de l’API permet de déterminer si le paramètre de requête correspond à un fichier ou à un champ de formulaire. Vous pouvez effectuer une itération sur les paramètres de requête dans une action Envoyer pour identifier les paramètres de pièce jointe.

L’exemple de code ci-après identifie les pièces jointes de la requête. Il lit ensuite les données du fichier à l’aide de Get API. Il crée enfin un objet Document à l’aide des données et l’ajoute à la liste.

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()));
    }
}

Lorsque vous joignez des fichiers au formulaire adaptatif, le serveur valide les pièces jointes après l’envoi du formulaire adaptatif et renvoie un message d’erreur dans les cas suivants :

Chemin de transfert et URL de redirection forward-path-and-redirect-url

Après avoir exécuté l’action requise, la servlet Submit transfère la requête vers le chemin de transfert. Une action utilise l’API setForwardPath pour définir le chemin de transfert dans la servlet Guide Submit.

Si l’action ne fournit pas de chemin de transfert, la servlet Submit redirige le navigateur à l’aide de l’URL de redirection. L’auteur ou l’autrice configure l’URL de redirection à l’aide de la configuration de la page de remerciement dans la boîte de dialogue Modifier du formulaire adaptatif. Il est également possible de configurer l’URL de redirection par le biais de l’action Envoyer ou de l’API setRedirectUrl de la servlet Guide Submit. Vous pouvez également configurer les paramètres de requête envoyés à l’URL de redirection à l’aide de l’API setRedirectParameters du servlet Guide Submit.

Action Envoyer submit-action

Une action Envoyer est un sling:Folder qui contient les éléments suivants :

Création d’une action Envoyer personnalisée creating-a-custom-submit-action

Pour créer une action Envoyer personnalisée qui enregistre les données dans le référentiel CRX et vous envoie ensuite un e-mail, suivez la procédure ci-après. Le formulaire adaptatif contient l’action Envoyer Stocker le contenu (obsolète) prête à l’emploi qui permet d’enregistrer les données dans le référentiel CRX. En outre, AEM fournit une API de messagerie qui peut être utilisée pour envoyer des e-mails. Avant d’utiliser l’API de messagerie, configurez le service de messagerie Day CQ via la console système. Vous pouvez réutiliser l’action Stocker le contenu (obsolète) pour stocker les données dans le référentiel. L’action Stocker le contenu (obsolète) se trouve à l’emplacement /libs/fd/af/components/guidesubmittype/store dans le référentiel CRX.

Utilisez la propriété submitService pour les actions Envoyer personnalisées submitservice-property

Lorsque vous définissez l’action Envoyer personnalisée, qui comprend la propriété submitService, le formulaire déclenche l’action FormSubmitActionService lors de l’envoi. L’action FormSubmitActionService utilise la méthode getServiceName pour récupérer la valeur de la propriété submitService. En fonction de la valeur de la propriété submitService, le service appelle la méthode d’envoi appropriée. Incluez FormSubmitActionService dans le lot personnalisé que vous téléchargez sur le serveur AEM Forms.

Ajoutez la propriété submitService de type string sur sling:Folder de votre action Envoyer personnalisée pour activer Adobe Sign pour le formulaire adaptatif. Vous pouvez sélectionner l’option Activer Adobe Sign dans la section Signature électronique des propriétés du conteneur de formulaires adaptatifs uniquement après avoir défini la valeur de la propriété submitService de votre action d’envoi personnalisée.