Scrittura di un’azione di invio personalizzata per i moduli adattivi writing-custom-submit-action-for-adaptive-forms

I moduli adattivi richiedono azioni di invio per elaborare i dati specificati dall’utente. Un’azione Invia determina l’attività eseguita sui dati inviati utilizzando un modulo adattivo. Adobe Experience Manager (AEM) include Azioni di invio OOTB che illustrano le attività personalizzate che è possibile eseguire utilizzando i dati inviati dall’utente. Ad esempio, puoi eseguire attività quali l’invio di e-mail o l’archiviazione dei dati.

Flusso di lavoro per un’azione Invia workflow-for-a-submit-action

Il diagramma di flusso rappresenta il flusso di lavoro per un’azione Invia che viene attivata quando si fa clic sul pulsante Invia in un modulo adattivo. I file nel componente File allegato vengono caricati sul server e i dati del modulo vengono aggiornati con gli URL dei file caricati. All’interno del client, i dati vengono memorizzati nel formato JSON. Il client invia una richiesta Ajax a un servlet interno che massaggia i dati specificati e li restituisce in formato XML. Il client raccoglie questi dati con i campi delle azioni. Invia i dati al servlet finale (servlet di invio della guida) tramite un’azione di invio del modulo. Quindi, il servlet inoltra il controllo all’azione Invia. L’azione Invia può inoltrare la richiesta a una diversa risorsa sling o reindirizzare il browser a un altro URL.

Formato dati XML xml-data-format

I dati XML vengono inviati al servlet utilizzando jcr:data parametro di richiesta. Le azioni di invio possono accedere al parametro per elaborare i dati. Il codice seguente descrive il formato dei dati XML. I campi associati al modello Modulo vengono visualizzati nella afBoundData sezione . I campi non associati vengono visualizzati nella afUnoundData sezione . Per ulteriori informazioni sul formato del data.xml file, vedi Introduzione alla precompilazione dei campi modulo adattivo.

<?xml ?>
<afData>
<afUnboundData>
<data>
<field1>value</field2>
<repeatablePanel>
    <field2>value</field2>
</repeatablePanel>
<repeatablePanel>
    <field2>value</field2>
</repeatablePanel>
</data>
</afUnboundData>
<afBoundData>
<!-- xml corresponding to the Form Model /XML Schema -->
</afBoundData>
</afData>

Campi azione action-fields

Un’azione Invia può aggiungere campi di input nascosti (utilizzando HTML input al modulo di cui è stato effettuato il rendering in HTML. Questi campi nascosti possono contenere i valori necessari durante l’elaborazione dell’invio del modulo. Quando si invia il modulo, questi valori dei campi vengono inviati nuovamente come parametri di richiesta che l’azione Invia può utilizzare durante la gestione dell’invio. I campi di input sono chiamati campi di azione.

Ad esempio, un’azione Invia che acquisisce anche il tempo necessario per compilare un modulo può aggiungere campi di input nascosti startTime e endTime.

Uno script può fornire i valori startTime e endTime i campi in cui viene eseguito il rendering del modulo e prima dell’invio del modulo, rispettivamente. Lo script di azione Invia post.jsp può quindi accedere a questi campi utilizzando i parametri di richiesta e calcolare il tempo totale necessario per compilare il modulo.

Allegati file file-attachments

Le azioni di invio possono inoltre utilizzare gli allegati file caricati utilizzando il componente File allegato. Gli script di azione Invia possono accedere a questi file utilizzando lo sling API RequestParameter. La isFormField Il metodo dell'API aiuta a identificare se il parametro della richiesta è un file o un campo del modulo. È possibile eseguire iterazioni sui parametri di richiesta in un’azione Invia per identificare i parametri di File allegato.

Il codice di esempio seguente identifica gli allegati di file nella richiesta. Successivamente, legge i dati nel file utilizzando Ottieni API. Infine, crea un oggetto Document utilizzando i dati e lo aggiunge a un elenco.

RequestParameterMap requestParameterMap = slingRequest.getRequestParameterMap();
for (Map.Entry<String, RequestParameter[]> param : requestParameterMap.entrySet()) {
    RequestParameter rpm = param.getValue()[0];
    if(!rpm.isFormField()) {
        fileAttachments.add(new Document(rpm.get()));
    }
}

URL di percorso e reindirizzamento forward-path-and-redirect-url

Dopo aver eseguito l’azione richiesta, il servlet di invio inoltra la richiesta al percorso successivo. Un’azione utilizza l’API setForwardPath per impostare il percorso in avanti nel servlet di invio della guida.

Se l’azione non fornisce un percorso in avanti, il servlet di invio reindirizzerà il browser utilizzando l’URL di reindirizzamento. L’autore configura l’URL di reindirizzamento utilizzando la configurazione Pagina di ringraziamento nella finestra di dialogo Modifica modulo adattivo. Puoi anche configurare l’URL di reindirizzamento tramite l’azione Submit o l’API setRedirectUrl nel servlet di invio della guida. Puoi anche configurare i parametri Request inviati all’URL di reindirizzamento utilizzando l’API setRedirectParameters nel servlet di invio della guida.

Azione di invio submit-action

Un’azione Invia è una sling:Folder che include quanto segue:

Creazione di un’azione di invio personalizzata creating-a-custom-submit-action

Esegui i seguenti passaggi per creare un’azione di invio personalizzata che salva i dati nell’archivio CRX e quindi invia un’e-mail. Il modulo adattivo contiene l’azione Invia Contenuto archivio azioni (obsoleto) di OOTB che salva i dati nell’archivio CRX. Inoltre, CQ fornisce un Posta API che può essere utilizzata per inviare e-mail. Prima di utilizzare l'API Mail, [configurare](https://docs.adobe.com/docs/en/cq/current/administering/notification.html?#Configuring il servizio Mail) il servizio Day CQ Mail tramite la console di sistema. Puoi riutilizzare l’azione Archivia contenuto (obsoleto) per memorizzare i dati nell’archivio. L’azione Archivia contenuto (obsoleto) è disponibile nel percorso /libs/fd/af/components/guidesubmittype/store nell’archivio CRX.