Erstellen einer benutzerdefinierten Übermittlungsaktion für adaptive Forms (Kernkomponenten)

Öffnen Sie die Befehlszeile und wählen Sie einen Ordner zum Speichern des AEM as a Cloud Service-Repositorys aus, z. B. /cloud-service-repository/.

Führen Sie den folgenden Befehl aus, um das Repository zu klonen:

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

Wo finden Sie diese Informationen?

Eine schrittweise Anleitung zum Auffinden dieser Details finden Sie im Adobe Experience League-Artikel Zugriff auf Git.

Ihr Projekt ist bereit.

Wenn der Befehl erfolgreich abgeschlossen wurde, wird in Ihrem lokalen Verzeichnis ein neuer Ordner erstellt. Dieser Ordner wird nach Ihrem Programm benannt (z. B. app-id). Dieser Ordner enthält alle Dateien und den Code, die Sie aus Ihrem AEM as a Cloud Service-Git-Repository heruntergeladen haben. Sie finden <appid> für Ihr AEM-Projekt in der Datei archetype.properties.

In diesem Handbuch wird dieser Ordner als [AEMaaCS project directory] bezeichnet.

Öffnen Sie den Repository-Ordner in einem Editor.

Navigieren Sie in Ihrem [AEMaaCS project directory] zum folgenden Verzeichnis:

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

Wichtig: Ersetzen Sie <app-id> durch Ihre tatsächliche Anwendungs-ID.

Erstellen Sie einen neuen Ordner für Ihre benutzerdefinierte Übermittlungsaktion und geben Sie ihr einen Namen Ihrer Wahl. Benennen Sie beispielsweise den Ordner als customsubmitaction.

Navigieren Sie zum hinzugefügten Verzeichnis für benutzerdefinierte Übermittlungsaktionen .

Navigieren Sie innerhalb Ihres [AEMaaCS project directory] zu folgendem Pfad:

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

Important: ersetzen <app-id> mit Ihrer tatsächlichen Anwendungs-ID.

Erstellen Sie eine neue Konfigurationsdatei.
Erstellen Sie im Ordner customsubmitaction eine neue Datei mit dem Namen .content.xml.

Öffnen Sie diese Datei und fügen Sie den folgenden Inhalt ein. Ersetzen Sie dabei [customsubmitaction] durch den Namen Ihrer Übermittlungsaktion

<?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]"/>

Ersetzen Sie zum Beispiel den [customsubmitaction] mit dem benutzerdefinierten Namen der Übermittlungsaktion wie Custom Submit Action.

Navigieren Sie zur Datei /ui.apps/src/main/content/META-INF/vault/filter.xml in Ihrem [AEMaaCS-Projektverzeichnis].

Öffnen Sie die Datei und fügen Sie die folgende Zeile am Ende ein:

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

Fügen Sie beispielsweise die folgende Codezeile hinzu, um den customsubmitaction Ordner in der filter.xml-Datei hinzuzufügen:

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

Speichern Sie die Änderungen.

Navigieren Sie in Ihrem [AEMaaCS project directory] zum folgenden Verzeichnis:
/core/src/main/java/com/<app-id>/core/service/
Important: ersetzen <app-id> mit Ihrer tatsächlichen Anwendungs-ID.

Erstellen Sie eine neue Java-Datei, um den Service für die hinzugefügte Übermittlungsaktion zu implementieren. Fügen Sie beispielsweise eine neue Java-Datei als CustomSubmitService.java hinzu.

Öffnen Sie diese Datei und fügen Sie den Code für Ihre benutzerdefinierte Übermittlungsaktionsimplementierung hinzu.

Der folgende Java-Code ist beispielsweise ein OSGi-Dienst, der die Formularübermittlung verarbeitet, indem er die übermittelten Daten protokolliert und einen OK zurückgibt. Fügen Sie den folgenden Code in die CustomSubmitService.java-Datei ein:

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

Speichern Sie die Änderungen.

Melden Sie sich bei Ihrer AEM Forms as a Cloud Service-Instanz an.

Gehen Sie zu Formulare > Formulare und Dokumente.

Wählen Sie ein adaptives Formular aus und klicken Sie auf Bearbeiten. Das Formular wird im Bearbeitungsmodus geöffnet.

Öffnen Sie den Inhalts-Browser und wählen Sie die Guide-Container-Komponente Ihres adaptiven Formulars aus.

Klicken Sie auf das Symbol für die Guide-Container-Eigenschaften . Das Dialogfeld „Container für ein adaptives Formular“ wird geöffnet.

Klicken Sie auf die Registerkarte Übermittlung.

Wählen Sie in Dropdown-Liste ​Übermittlungsaktion“ die Übermittlungsaktion aus. Wählen Sie beispielsweise die Übermittlungsaktion wie Custom Submit Action aus.

Füllen Sie das Formular aus und senden Sie es ab.

Nachdem das Formular erfolgreich übermittelt wurde, können Sie die Konfiguration der Adobe Experience Manager-Web-Konsole überprüfen, um die Aktion der benutzerdefinierten Übermittlungsaktion in der lokalen Entwicklungsumgebung zu überprüfen.

Rufen Sie http://<host>:<port>/system/console/configMgr auf.

Navigieren Sie zur Protokollunterstützung für die Adobe Experience Manager Web Console unter http://<host>:<port>/system/console/slinglog.

Klicken Sie auf die Option logs/error.log .

Öffnen Sie die error.log Datei , um zu sehen, dass die Daten angehängt wurden.