Creare un’azione di invio personalizzata per Adaptive Forms (Componenti core)

Aprire la riga di comando e scegliere una directory in cui archiviare l'archivio AEM as a Cloud Service, ad esempio /cloud-service-repository/.

Esegui il comando seguente per clonare l’archivio:

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

Dove trovare queste informazioni?

Per istruzioni dettagliate su come individuare questi dettagli, consulta l'articolo di Adobe Experience League "Accesso a Git".

Il progetto è pronto!

Al termine del comando viene visualizzata una nuova cartella creata nella directory locale. Questa cartella prende il nome dall’applicazione (ad esempio, app-id). Questa cartella contiene tutti i file e il codice scaricati dall’archivio Git di AEM as a Cloud Service. Puoi trovare <appid> per il progetto AEM nel file archetype.properties.

In questa guida questa cartella viene indicata come [AEMaaCS project directory].

Apri la cartella dell’archivio in un editor.

Passare alla seguente directory all'interno di [AEMaaCS project directory]:

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

Importante: sostituisci <app-id> con il tuo ID applicazione effettivo.

Crea una nuova cartella per l’azione di invio personalizzata e assegnagli un nome a tua scelta. Ad esempio, assegnare alla cartella il nome customsubmitaction.

Passa alla directory dell’azione di invio personalizzata aggiunta.

All'interno di [AEMaaCS project directory], passa al seguente percorso:

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

Important: Sostituisci <app-id> con l'ID applicazione effettivo.

Crea un nuovo file di configurazione.
Nella cartella customsubmitaction, creare un nuovo file denominato .content.xml.

Apri il file e incolla il seguente contenuto, sostituendo [customsubmitaction] con il nome dell'azione di invio

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

Ad esempio, sostituisci [customsubmitaction] con il nome dell'azione di invio personalizzato Custom Submit Action.

Passa al file /ui.apps/src/main/content/META-INF/vault/filter.xml nella directory del progetto [AEMaaCS].

Apri il file e aggiungi la seguente riga alla fine:

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

Aggiungere ad esempio la seguente riga di codice per aggiungere la cartella customsubmitaction nel file filter.xml:

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

Salva le modifiche.

Passare alla seguente directory all'interno di [AEMaaCS project directory]:
/core/src/main/java/com/<app-id>/core/service/
Important: Sostituisci <app-id> con l'ID applicazione effettivo.

Crea un nuovo file Java per implementare il servizio per l’azione di invio aggiunta. Ad esempio, aggiungere un nuovo file Java come CustomSubmitService.java.

Apri questo file e aggiungi il codice per l’implementazione dell’azione di invio personalizzata.

Il codice Java seguente, ad esempio, è un servizio OSGi che gestisce l'invio del modulo registrando i dati inviati e restituendo uno stato OK. Aggiungi il seguente codice nel file 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;
     }
    }

Salva le modifiche.

Accedi all’istanza AEM Forms as a Cloud Service.

Vai a Forms > Forms e documenti.

Seleziona un modulo adattivo e fai clic su Modifica. Il modulo si apre in modalità di modifica.

Apri il browser Contenuto e seleziona il componente Contenitore guida del modulo adattivo.

Fare clic sull'icona delle proprietà del Contenitore Guida TV . Viene visualizzata la finestra di dialogo Contenitore modulo adattivo (Adaptive Form Container).

Fare clic sulla scheda Invio.

Dall'elenco a discesa Azione invio, selezionare l'azione di invio. Selezionare ad esempio l'azione di invio come Custom Submit Action.

Compila il modulo e invialo.

Dopo aver inviato il modulo, è possibile controllare la configurazione della console Web Adobe Experience Manager per verificare l'azione dell'azione di invio personalizzata nell'ambiente di sviluppo locale.

Passa a http://<host>:<port>/system/console/configMgr.

Passare a Supporto log console Web Adobe Experience Manager in http://<host>:<port>/system/console/slinglog.

Fare clic sull'opzione logs/error.log.

Aprire il file error.log per verificare che i dati siano stati aggiunti alla fine.