Scrittura dell’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 il task eseguito sui dati inviati tramite un modulo adattivo. Adobe Experience Manager (AEM) include azioni di invio pronte all'uso che dimostrano attività personalizzate eseguibili utilizzando i dati inviati dall'utente. Ad esempio, puoi eseguire attività quali l’invio di e-mail o la memorizzazione dei dati.

Flusso di lavoro per un'azione di invio workflow-for-a-submit-action

Il diagramma di flusso mostra il flusso di lavoro per un'azione di invio 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 in 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 confronta questi dati con campi di azione. Invia i dati al servlet finale (servlet di invio guida) tramite un’azione di invio modulo. Quindi, il servlet inoltra il controllo all’azione Invia. L’azione Invia può inoltrare la richiesta a una risorsa sling diversa o reindirizzare il browser a un altro URL.

Formato dati XML xml-data-format

I dati XML vengono inviati al servlet utilizzando il parametro di richiesta jcr:data. Le azioni di invio possono accedere al parametro per elaborare i dati. Nel codice seguente viene descritto il formato dei dati XML. I campi associati al modello di modulo vengono visualizzati nella sezione afBoundData. I campi non associati vengono visualizzati nella sezione afUnoundData. Per ulteriori informazioni sul formato del file data.xml, vedere Introduzione alla precompilazione dei campi del 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 il tag HTML input) al form HTML sottoposto a rendering. Questi campi nascosti possono contenere i valori necessari durante l’elaborazione dell’invio del modulo. Durante l’invio del modulo, questi valori dei campi vengono postback come parametri di richiesta che l’azione Invia può utilizzare durante la gestione dell’invio. I campi di input sono denominati campi di azione.

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

Uno script può fornire i valori dei campi startTime e endTime rispettivamente durante il rendering del modulo e prima dell'invio del modulo. L'ActionScript di invio post.jsp può quindi accedere a questi campi utilizzando i parametri di richiesta e calcolare il tempo totale necessario per compilare il modulo.

File allegati file-attachments

Le azioni di invio possono inoltre utilizzare i file allegati caricati utilizzando il componente File allegato. Gli script di azioni di invio possono accedere a questi file utilizzando l'API sling RequestParameter. Il metodo isFormField dell'API consente di identificare se il parametro della richiesta è un file o un campo modulo. È possibile scorrere i parametri di richiesta in un'azione di invio per identificare i parametri di file allegato.

Il codice di esempio seguente identifica gli allegati della richiesta. Successivamente, legge i dati nel file utilizzando Get 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()));
    }
}

Percorso di inoltro e URL di reindirizzamento forward-path-and-redirect-url

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

Se l’azione non fornisce un percorso di inoltro, il servlet di invio reindirizzerà il browser utilizzando l’URL di reindirizzamento. L’autore configura l’URL di reindirizzamento utilizzando la configurazione della pagina di ringraziamento nella finestra di dialogo Modifica modulo adattivo. Puoi anche configurare l’URL di reindirizzamento tramite l’azione Invia o l’API setRedirectUrl nel servlet di invio della guida. Puoi anche configurare i parametri di richiesta 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

Per creare un’azione di invio personalizzata che salvi i dati nell’archivio CRX, quindi ti invia un’e-mail, effettua le seguenti operazioni. Il modulo adattivo contiene l’azione predefinita Invia a Contenuto archivio (obsoleto) che salva i dati nell’archivio CRX. Inoltre, CQ fornisce un'API Mail che può essere utilizzata per inviare e-mail. Prima di utilizzare l'API Mail, configura il servizio Day CQ Mail tramite la console di sistema. Puoi riutilizzare l’azione Archivia contenuto (obsoleta) per memorizzare i dati nell’archivio. L’azione Archivia contenuto (obsoleta) è disponibile nella posizione /libs/fd/af/components/guidesubmittype/store nell’archivio CRX.