Erstellen einer benutzerdefinierten Sendeaktion 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 Ihrer Anwendung benannt (z. B. app-id). Dieser Ordner enthält alle Dateien und den Code, die aus Ihrem AEM as a Cloud Service-Git-Repository heruntergeladen wurden. 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 zum folgenden Verzeichnis in Ihrem [AEMaaCS project directory]:

/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 Sendeaktion und geben Sie ihm einen Namen Ihrer Wahl. Benennen Sie den Ordner beispielsweise mit "customsubmitaction".

Navigieren Sie zum Ordner mit der hinzugefügten benutzerdefinierten Übermittlungsaktion .

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

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

Important: Replace <app-id> mit Ihrer eigentlichen 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 Sendeaktion.

<?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 beispielsweise "[customsubmitaction]"durch den Namen Ihrer angepassten Sendeaktion "1".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 Ordner "customsubmitaction"zur Datei "filter.xml"hinzuzufügen:

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

Speichern Sie die Änderungen.

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

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

Öffnen Sie diese Datei und fügen Sie den Code für Ihre Implementierung der benutzerdefinierten Übermittlungsaktion hinzu.

Der folgende Java-Code ist beispielsweise ein OSGi-Dienst, der die Formularübermittlung durch Protokollierung der gesendeten Daten verarbeitet und den Status OK zurückgibt. Fügen Sie den folgenden Code in die Datei CustomSubmitService.java 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 aus der Dropdownliste Aktion übermitteln die Sendeaktion aus. Wählen Sie beispielsweise für die Sendeaktion "Custom Submit Action"aus.

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

Nachdem das Formular erfolgreich gesendet wurde, können Sie die Adobe Experience Manager Web Console Configuration überprüfen, um die Aktion der benutzerdefinierten Sendeaktion in der lokalen Entwicklungsumgebung zu überprüfen.

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

Navigieren Sie zur Adobe Experience Manager Web Console Log Support unter http://<host>:<port>/system/console/slinglog.

Klicken Sie auf die Option logs/error.log .

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