In genere, i moduli web sono configurati per l’invio in modo sincrono. Nell’invio sincrono, quando gli utenti inviano un modulo, vengono reindirizzati a una pagina di conferma, a una pagina di ringraziamento 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. Puoi configurare l’invio asincrono per fornire questa esperienza con Adaptive Forms.
Nell’invio asincrono, quando un utente invia un modulo, lo sviluppatore del modulo inserisce un’esperienza separata, come il reindirizzamento ad un altro modulo o a una sezione separata del sito web. L’autore può anche collegare servizi separati come l’invio di dati a un archivio dati diverso o aggiungere un motore di analisi personalizzato. In caso di invio asincrono, un modulo adattivo si comporta come un’applicazione a pagina singola, in quanto il modulo non viene ricaricato o il relativo URL non cambia quando i dati del modulo inviati vengono convalidati sul server.
Continua a leggere per i dettagli sull’invio asincrono in Adaptive Forms.
Per configurare l’invio asincrono per un modulo adattivo:
In modalità di creazione del modulo adattivo, seleziona l’oggetto Contenitore modulo e tocca per aprire le relative proprietà.
In Invio sezione proprietà, abilita Utilizzare l’invio asincrono.
In Al momento dell’invio selezionare una delle opzioni seguenti da eseguire in caso di invio corretto del modulo.
Tocca per salvare le proprietà.
Experience Manager 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.
La struttura della risposta del server per l’evento di successo dell’invio è la seguente:
{oneOf: [
{ properties : {
contentType : {"type" : "string", "enum" : ["xmlschema", "jsonschema"]},
data : {type : "string", description : "Form data in XML or JSON format"},
thankYouOption : {type : "string"}
}},
properties : {
contentType : {"type" : "string", "enum" : ["xmlschema", "jsonschema"]},
data : {type : "string", description : "Form data in XML or JSON format"},
thankYouContent: {type: "string"}
}
]
}
La risposta del server in caso di invio corretto del modulo include:
Il gestore di successo legge la risposta del server e quindi reindirizza all’URL della pagina configurato o visualizza un messaggio.
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:
Il gestore errori legge la risposta del server e visualizza di conseguenza il messaggio di errore sul modulo.
Gli sviluppatori e gli autori di moduli possono scrivere regole a livello di modulo 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 per gestire eventi di successo ed errore.
Apri il modulo adattivo in modalità di creazione, seleziona un oggetto modulo qualsiasi e tocca per aprire l’editor di regole.
Seleziona Modulo nell’albero Oggetti modulo e toccare Crea.
Scegli invio completato o errore di invio dal Seleziona stato elenco a discesa.
Definire un Then per lo stato selezionato. Ad esempio, seleziona Passa a quindi digita o incolla un URL. È inoltre possibile trascinare qualsiasi funzione utilizzando Funzioni alla regola.
Tocca Fine per salvare la regola.