Création d’une action d’envoi personnalisée pour le Forms adaptatif (composants principaux)

Ouvrez la ligne de commande et choisissez un répertoire pour stocker votre référentiel AEM as a Cloud Service, tel que /cloud-service-repository/.

Exécutez la commande ci-dessous pour cloner le référentiel :

git clone https://git.cloudmanager.adobe.com/<organization-name>/<app-id>/

Où trouver ces informations ?

Pour obtenir des instructions détaillées sur la localisation de ces détails, reportez-vous à l’article de Adobe Experience League "Accès à Git".

Votre projet est prêt !

Une fois la commande terminée, un nouveau dossier est créé dans votre répertoire local. Ce dossier est nommé d’après votre application (par exemple, app-id). Ce dossier contient tous les fichiers et le code téléchargés à partir de votre référentiel Git AEM as a Cloud Service. Vous pouvez trouver <appid> pour votre projet AEM dans le fichier archetype.properties .

Dans ce guide, nous nous référons à ce dossier sous le nom de [AEMaaCS project directory].

Ouvrez le dossier du référentiel dans un éditeur.

Accédez au répertoire suivant dans votre [AEMaaCS project directory] :

/ui.apps/src/main/content/jcr_root/apps/<app-id>/

Important : remplacez <app-id> par votre ID d’application réel.

Créez un dossier pour votre action d’envoi personnalisée et attribuez-lui un nom de votre choix. Par exemple, nommez le dossier customsubmitaction.

Accédez au répertoire d’action d’envoi personnalisée ajouté.

Dans votre [AEMaaCS project directory], accédez au chemin suivant :

/ui.apps/src/main/content/jcr_root/apps/<app-id>/customsubmitaction/

Important : Remplacer <app-id> avec votre ID d’application réel.

Créez un fichier de configuration.
Dans le dossier customsubmitaction, créez un fichier nommé .content.xml.

Ouvrez ce fichier et collez le contenu suivant, en remplaçant [customsubmitaction] par le nom de votre action d’envoi.

<?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="[customsubmitaction]"
jcr:primaryType="sling:Folder"

guideComponentType="fd/af/components/guidesubmittype"
guideDataModel="basic,xfa,xsd"
submitService="[customsubmitaction]"/>

Par exemple, remplacez [customsubmitaction] par le nom de votre action d’envoi personnalisée Custom Submit Action.

Accédez au fichier /ui.apps/src/main/content/META-INF/vault/filter.xml dans votre [ répertoire de projet AEMaaCS].

Ouvrez le fichier et ajoutez la ligne suivante à la fin :

<filter root="/apps/<app-id>/[customsubmitaction-folder]"/>

Par exemple, ajoutez la ligne de code suivante pour ajouter le dossier customsubmitaction dans le fichier filter.xml :

<filter root="/apps/wknd/customsubmitaction"/>

Enregistrez les modifications.

Accédez au répertoire suivant dans votre [AEMaaCS project directory] :
/core/src/main/java/com/<app-id>/core/service/
Important : Remplacer <app-id> avec votre ID d’application réel.

Créez un fichier Java pour mettre en oeuvre le service pour l’action d’envoi ajoutée. Par exemple, ajoutez un nouveau fichier Java en tant que CustomSubmitService.java.

Ouvrez ce fichier et ajoutez le code correspondant à votre implémentation d’action d’envoi personnalisée.

Par exemple, le code Java ci-dessous est un service OSGi qui gère l’envoi du formulaire en enregistrant les données envoyées et en renvoyant un état OK. Ajoutez le code suivant dans le fichier CustomSubmitService.java :

package com.wknd.core.service;

import com.adobe.aemds.guide.model.FormSubmitInfo;
import com.adobe.aemds.guide.service.FormSubmitActionService;
import java.util.HashMap;
import java.util.Map;
import org.osgi.service.component.annotations.Component;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

    @Component(
    service = FormSubmitActionService.class,
    immediate = true
        )
    public class CustomSubmitService implements FormSubmitActionService {

    private static final String serviceName = "Custom Submit Action";

    private static Logger log = LoggerFactory.getLogger(CustomSubmitService.class);

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

    @Override
    public Map<String, Object> submit(FormSubmitInfo formSubmitInfo) {
    String data = formSubmitInfo.getData();
    log.info("Using custom submit action service, [data] --> " + data);
    Map<String, Object> result = new HashMap<>();
    result.put("status", "OK");
    return result;
     }
    }

Enregistrez les modifications.

Connectez-vous à votre instance AEM Forms as a Cloud Service.

Accédez à Formulaires > Formulaires et documents.

Sélectionnez un formulaire adaptatif et cliquez sur Modifier. Le formulaire s’ouvre en mode d’édition.

Ouvrez l’explorateur de contenu, puis sélectionnez le composant Conteneur de guide de votre formulaire adaptatif.

Cliquez sur l’icône des propriétés du conteneur de guide . La fenêtre du conteneur de formulaires adaptatifs s’ouvre.

Cliquez sur l’onglet Envoi.

Dans la liste déroulante Action d’envoi, sélectionnez l’action d’envoi. Par exemple, sélectionnez l’action d’envoi Custom Submit Action.

Remplissez le formulaire et envoyez-le.

Une fois le formulaire envoyé avec succès, vous pouvez vérifier la configuration de la console web Adobe Experience Manager pour vérifier l’action de l’action d’envoi personnalisée dans l’environnement de développement local.

Accédez à http://<host>:<port>/system/console/configMgr.

Accédez à la prise en charge du journal de la console web Adobe Experience Manager à l’adresse http://<host>:<port>/system/console/slinglog.

Cliquez sur l’option logs/error.log .

Ouvrez le fichier error.log pour vérifier que les données lui ont été ajoutées.