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

Ouvrez la ligne de commande et sélectionnez 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 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 porte le nom de 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. Le <appid> de votre projet AEM se trouve dans le fichier archetype.properties.

Tout au long de 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 donnez-lui un nom de votre choix. Par exemple, nommez le dossier customsubmitaction.

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

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

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

Important : remplacez <app-id> par 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 le [customsubmitaction] par le nom de votre action d’envoi personnalisée, comme 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 : remplacez <app-id> par votre ID d’application réel.

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

Ouvrez ce fichier et ajoutez le code pour l’implémentation de votre action d’envoi personnalisée.

Par exemple, le code Java ci-dessous est un service OSGi qui gère l’envoi du formulaire en consignant les données envoyées et renvoie un OK de statut. 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 comme Custom Submit Action.

Remplissez le formulaire et envoyez-le.

Une fois le formulaire envoyé, vous pouvez vérifier la configuration de la console web de Adobe Experience Manager ​ ​afin de 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 page Prise en charge du journal de la console web de 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 y ont été ajoutées.