Invio del modulo

Completato

L'ultimo passaggio dell'uso di un controllo Form prevede l'invio delle informazioni nuove o modificate di un record immesse dall'utente. A tale scopo si usa la funzione SubmitForm. Questa funzione viene spesso inserita in un controllo Button con etichetta Salva o Invia. La formula per OnSelect è SubmitForm(NomeModulo).

Questa funzione prende tutti i dati immessi nei controlli delle schede dati e li salva nell'origine dati per il controllo Form. Ogni scheda dati nel controllo Form ha una proprietà Update in cui si specifica il valore o la formula da usare per aggiornare la colonna. Se la scheda è stata sbloccata, la formula può essere modificata. Questa operazione è spesso superflua e viene eseguita solo in circostanze particolari.

Dopo l'invio del modulo

Con il controllo Form è sufficiente fare clic sul pulsante SubmitForm per trasferire i dati e aggiornare l'origine dati. Il controllo Form ha tre proprietà che vengono elaborate dopo l'invio dei dati, a seconda del risultato dell'invio. Queste proprietà sono OnSuccess, OnFailure e OnReset.

Per ognuna di queste proprietà è possibile immettere una formula. Se ad esempio si vuole che l'utente passi a una schermata diversa dopo l'invio dei dati, in OnSuccess si userà la funzione Navigate(SuccessScreen, ScreenTransition.Cover) per indirizzare l'utente alla schermata denominata SuccessScreen.

Proprietà OnFailure

Usare la proprietà OnFailure se si verifica un errore quando i dati vengono inviati. È possibile usare una formula per specificare un messaggio di avviso che viene visualizzato quando si verifica l'errore. La formula seguente è un esempio dell'uso della funzione Notify per fornire maggiori informazioni all'utente.

Notify("Your data was not saved. Please try again or contact an administrator.", NotificationType.Error)

Questa funzione mostrerà un avviso rosso nella parte superiore della schermata con il messaggio "I dati non sono stati salvati. Riprovare o contattare un amministratore." Questo messaggio semplifica la risoluzione del problema da parte dell'utente.

Proprietà OnReset

Usare la proprietà OnReset se il modulo viene reimpostato. Quando si usa la funzione ResetForm, il modulo viene reimpostato. La funzione ResetForm ripristina i valori predefiniti del modulo e quindi esegue qualsiasi formula specificata nella proprietà OnReset. Un esempio può essere se si vuole reimpostare un controllo Variable o Timer usato quando si interagisce con il modulo.

Dopo che il modulo è stato inviato, è possibile fare riferimento direttamente al record inviato. L'ultimo record inviato è disponibile usando la proprietà LastSubmit che contiene l'intero record. È possibile accedere al record usando la formula FormName.LastSubmit, presupponendo che il controllo Form sia stato denominato FormName. È anche possibile accedere al singolo valore inserendo un controllo Label nell'app e quindi usando la formula FormName.LastSubmit.ID per restituire la proprietà ID dell'ultimo record inviato tramite il controllo Form denominato FormName. Questa funzione è un concetto avanzato, utile quando si inizia a creare dati relazionali in cui è necessario conoscere il valore di un precedente invio di modulo.