Creare un’azione di invio personalizzata per Adaptive Forms writing-custom-submit-action-for-adaptive-forms

Un modulo adattivo fornisce più azioni di invio pronte all’uso. Un’azione di invio specifica i dettagli delle azioni da eseguire sui dati raccolti tramite il modulo adattivo. Ad esempio, l’invio di dati tramite e-mail.

È possibile creare un'azione di invio personalizzata per aggiungere funzionalità non incluse in azioni di invio predefinite o non supportate tramite una singola azione di invio OOTB. Ad esempio, l’invio di dati a un flusso di lavoro, il salvataggio dei dati in un archivio dati, l’invio di una notifica e-mail alla persona che invia il modulo e l’invio di un’e-mail alla persona responsabile dell’elaborazione del modulo inviato per le approvazioni e i rifiuti tramite una singola azione di invio.

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.

<?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 di invio può aggiungere campi di input nascosti (utilizzando il tag HTML input) al HTML del modulo 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 di invio può utilizzare durante la gestione dell’invio. I campi di input sono denominati campi di azione.

Ad esempio, un'azione di invio 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. Lo script dell'azione 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 mediante 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()));
    }
}

Quando si allegano file al modulo adattivo, il server convalida gli allegati dopo l’invio del modulo adattivo e restituisce un messaggio di errore se:

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 di invio 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 invio submit-action

Un’azione di invio è un 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 il contenuto dell’archivio azioni di invio OOTB (obsoleto) che salva i dati nell’archivio CRX. Inoltre, AEM 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.

Utilizzare la proprietà submitService per azioni di invio personalizzate submitservice-property

Quando si imposta l'azione di invio personalizzata, che include la proprietà submitService, il modulo attiva FormSubmitActionService all'invio. FormSubmitActionService utilizza il metodo getServiceName per recuperare il valore per la proprietà submitService. In base al valore della proprietà submitService, il servizio richiama il metodo submit appropriato. Includere FormSubmitActionService nel bundle personalizzato caricato nel server AEM Forms.

Aggiungi la proprietà submitService di tipo stringa a sling:Folder dell'azione di invio personalizzata per abilitare Adobe Sign per il modulo adattivo. È possibile selezionare l'opzione Abilita Adobe Sign nella sezione Firma elettronica delle proprietà del contenitore Modulo adattivo solo dopo aver impostato il valore per la proprietà submitService dell'azione di invio personalizzata.