Créer un envoi personnalisé

AEM Forms propose un certain nombre d’options d’envoi prêtes à l’emploi qui répondent à la plupart des cas d’utilisation.Outre ces actions d’envoi prédéfinies, AEM Forms vous permet d’écrire votre propre gestionnaire d’envoi personnalisé pour traiter l’envoi du formulaire selon vos besoins.

Pour créer un service d’envoi personnalisé, procédez comme suit :

Créer un projet AEM

Si vous disposez déjà d’un projet AEM Forms as a Cloud Service, passez à l’écriture d’un service d’envoi personnalisé.

Écrire le service d’envoi personnalisé Write-the-custom-submit-service

Lancez IntelliJ et ouvrez le projet AEM. Créez une classe Java appelée HandleRegistrationFormSubmission comme illustré dans la capture d’écran ci-dessous

Le code suivant permet d’implémenter le service.

package com.aem.bankingapplication.core;
import java.util.HashMap;
import java.util.Map;
import com.google.gson.Gson;
import org.osgi.service.component.annotations.Component;
import com.adobe.aemds.guide.model.FormSubmitInfo;
import com.adobe.aemds.guide.service.FormSubmitActionService;
import com.adobe.aemds.guide.utils.GuideConstants;
import com.google.gson.JsonObject;
import org.slf4j.*;

@Component(
        service=FormSubmitActionService.class,
        immediate = true
)
public class HandleRegistrationFormSubmission implements FormSubmitActionService {
    private static final String serviceName = "Core Custom AF Submit";
    private static Logger logger = LoggerFactory.getLogger(HandleRegistrationFormSubmission.class);

    @Override
    public String getServiceName() {
        return serviceName;
    }

    @Override
    public Map<String, Object> submit(FormSubmitInfo formSubmitInfo) {
        logger.error("in my custom submit service");
        Map<String, Object> result = new HashMap<>();
        logger.error("in my custom submit service");
        String data = formSubmitInfo.getData();
        JsonObject formData = new Gson().fromJson(data,JsonObject.class);
        logger.error("The form data is "+formData);
        JsonObject jsonObject = new JsonObject();
        jsonObject.addProperty("firstName",formData.get("firstName").getAsString());
        jsonObject.addProperty("lastName",formData.get("lastName").getAsString());
        result.put(GuideConstants.FORM_SUBMISSION_COMPLETE, Boolean.TRUE);
        result.put("json",jsonObject.toString());
        return result;
    }

}

Créer un nœud CRX sous apps

Développez le nœud ui.apps et créez un package nommé HandleRegistrationFormSubmission sous le nœud apps, comme illustré dans la capture d’écran ci-dessous

Créez un fichier appelé .content.xml sous le HandleRegistrationFormSubmission. Copiez et collez le code suivant dans le fichier .content.xml.

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:sling="http://sling.apache.org/jcr/sling/1.0"
    jcr:description="Handle Registration Form Submission"
    jcr:primaryType="sling:Folder"
    guideComponentType="fd/af/components/guidesubmittype"
    guideDataModel="xfa,xsd,basic"
    submitService="Core Custom AF Submit"/>

La valeur de l’élément submitService doit correspondre à celle de serviceName = “Core Custom AF Submit” dans l’implémentation de FormSubmitActionService.

Déployez le code sur votre instance AEM Forms locale.

Avant d’envoyer les modifications au référentiel de cloud manager, il est recommandé de déployer le code sur votre instance d’auteur locale prête pour le cloud afin de tester le code. Vérifiez que l’instance de création est en cours d’exécution.
Pour déployer le code sur votre instance d’auteur prête pour le cloud, accédez au dossier racine de votre projet AEM et exécutez la commande suivante

mvn clean install -PautoInstallSinglePackage

Le code est alors déployé sous la forme d’un package unique sur votre instance de création.

Envoyez le code à Cloud Manager et déployez-le.

Après avoir vérifié le code sur votre instance locale, envoyez le code vers votre instance cloud.
Envoyez les modifications vers votre référentiel Git local, puis vers le référentiel Cloud Manager. Vous pouvez vous reporter aux articles Configuration de Git, Intégration du projet AEM au référentiel Cloud Manager et Déploiement dans l’environnement de développement.

Une fois le pipeline exécuté avec succès, vous devriez être en mesure d’associer l’action d’envoi de votre formulaire au gestionnaire d’envoi personnalisé, comme illustré dans la capture d’écran ci-dessous

Étapes suivantes

Afficher la réponse personnalisée dans votre application React