Invio asincrono di moduli adattivi asynchronous-submission-of-adaptive-forms

CAUTION
AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.

In genere, i moduli web sono configurati per l’invio in modo sincrono. Quando gli utenti inviano un modulo, vengono reindirizzati a una pagina di conferma o, in caso di errore di invio, a una pagina di errore. Tuttavia, le moderne esperienze web come le applicazioni a pagina singola stanno guadagnando popolarità laddove la pagina web rimane statica mentre l'interazione client-server avviene in background. È ora possibile fornire questa esperienza con i moduli adattivi configurando l’invio asincrono. In questo caso, un modulo adattivo si comporta come un’applicazione a pagina singola in quanto il modulo non viene ricaricato o il suo URL non cambia quando i dati del modulo inviati vengono convalidati sul server.

Continua a leggere per i dettagli sull’invio asincrono nei moduli adattivi.

Configurare l’invio asincrono configure

Per configurare l’invio asincrono per un modulo adattivo:

  1. In modalità di creazione dei moduli adattivi, seleziona l’oggetto Contenitore modulo e tocca cmppr1 per aprire le relative proprietà.

  2. In Invio sezione proprietà, abilita Utilizzare l’invio asincrono.

  3. In Al momento dell’invio selezionare una delle opzioni seguenti da eseguire in caso di invio corretto del modulo.

    • Reindirizzare a URL: Reindirizza all’URL o alla pagina specificati all’invio del modulo. Puoi specificare un URL o sfogliare per scegliere il percorso di una pagina nel URL/percorso di reindirizzamento campo .
    • Mostra messaggio: Visualizza un messaggio all’invio del modulo. Puoi scrivere un messaggio nel campo di testo sotto l’opzione Mostra messaggio . Il campo di testo supporta la formattazione RTF.
  4. Tocca pulsante di spunta1 per salvare le proprietà.

Funzionamento dell’invio asincrono how-asynchronous-submission-works

AEM Forms fornisce gestori di errori e di successo preconfigurati per l’invio dei moduli. I gestori sono funzioni lato client che vengono eseguite in base alla risposta del server. Quando un modulo viene inviato, i dati vengono trasmessi al server per la convalida, che restituisce una risposta al client con informazioni sull’evento riuscito o di errore per l’invio. Le informazioni vengono passate come parametri al gestore pertinente per eseguire la funzione .

Inoltre, gli autori e gli sviluppatori dei moduli possono scrivere regole a livello di modulo per ignorare i gestori predefiniti. Per ulteriori informazioni, consulta Ignora gestori predefiniti utilizzando le regole.

Esaminiamo innanzitutto la risposta del server per gli eventi di successo ed errore.

Risposta del server per l'invio dell'evento di successo server-response-for-submission-success-event

La struttura della risposta del server per l’evento di successo dell’invio è la seguente:

{
  contentType : "<xmlschema or jsonschema>",
  data : "<dataXML or dataJson>" ,
  thankYouOption : <page/message>,
  thankYouContent : "<thank you page url/thank you message>"
}

La risposta del server in caso di invio corretto del modulo include:

  • Tipo di formato dei dati del modulo: XML o JSON
  • Dati modulo in formato XML o JSON
  • Opzione selezionata per reindirizzare a una pagina o visualizzare un messaggio come configurato nel modulo
  • URL della pagina o contenuto del messaggio configurato nel modulo

Il gestore di successo legge la risposta del server e quindi reindirizza all’URL della pagina configurato o visualizza un messaggio.

Risposta del server all’evento di errore di invio server-response-for-submission-error-event

La struttura per la risposta del server all'evento di errore di invio è la seguente:

{
   errorCausedBy : "<CAPTCHA_VALIDATION or SERVER_SIDE_VALIDATION>",

   errors : [
               { "somExpression" : "<SOM Expression>",
                 "errorMessage"  : "<Error Message>"
               },
               ...
             ]
 }

La risposta del server in caso di errore nell’invio del modulo include:

  • Motivo dell’errore, convalida CAPTCHA non riuscita o convalida lato server
  • Elenco degli oggetti errore, che include l'espressione SOM del campo che non ha superato la convalida e il messaggio di errore corrispondente

Il gestore errori legge la risposta del server e visualizza di conseguenza il messaggio di errore sul modulo.

Ignora gestori predefiniti utilizzando le regole custom

Gli sviluppatori e gli autori di moduli possono scrivere regole a livello di modulo nell’editor di codice per ignorare i gestori predefiniti. La risposta del server per gli eventi di successo ed errore è esposta a livello di modulo, a cui gli sviluppatori possono accedere utilizzando $event.data nelle regole.

Esegui i seguenti passaggi per scrivere regole nell'editor di codice per gestire eventi di successo ed errore.

  1. Apri il modulo adattivo in modalità di creazione, seleziona un oggetto modulo qualsiasi e tocca edit-rules1 per aprire l’editor di regole.
  2. Seleziona Modulo nell’albero Oggetti modulo e toccare Crea.
  3. Seleziona Editor di codice dal menu a discesa selezione modalità.
  4. Nell’editor di codice, tocca Modifica codice. Tocca Modifica nella finestra di dialogo di conferma.
  5. Scegli Invio riuscito o Errore nell'invio dal Evento a discesa.
  6. Scrivere una regola per l’evento selezionato e toccare Fine per salvare la regola.
recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da