Invio del modulo
L'ultimo passaggio per lavorare con un controllo Form consiste nell'inviare le modifiche. A tale scopo si usa la funzione SubmitForm. Questa funzione viene spesso inserita in un controllo Pulsante con etichetta Salva o Invia. La formula per OnSelect è SubmitForm(YourFormName).
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 del controllo Form ha una proprietà Update che specifica i dati, sotto forma di formula, che verrà scritta nell'origine dati alla chiamata di SubmitForm. Se la scheda è stata sbloccata, la formula può essere modificata. Questa operazione è spesso superflua e viene eseguita solo in circostanze particolari.
Importante
Quando si inizia a modificare le formule delle schede, occorre associare il tipo di dati previsto dall'origine, altrimenti potrebbe verificarsi un errore e i dati immessi potrebbero non venire salvati correttamente.
Dopo l'invio del modulo
Il controllo Form è facile da usare in quanto con la chiamata della funzione SubmitForm i dati vengono trasferiti rapidamente e l'origine dati viene aggiornata. Il controllo Form ha tre proprietà che vengono elaborate dopo l'invio dei dati. L'uso di una o dell'altra dipende dall'esito dell'invio. Queste proprietà sono OnSuccess, OnFailure e OnReset. Inoltre, la proprietà LastSubmit fornisce un record che indica quali dati del modulo sono stati inviati.
Nota
Se si desidera inviare il modulo per altri motivi, ad esempio per passare a un'altra schermata, aggiungere il codice in una di queste tre proprietà del modulo. Non aggiungere altro codice a un pulsante, un'icona o una funzione qualsiasi che richiama l'azione SubmitForm.
Per ognuna di queste proprietà è possibile immettere una formula. Se ad esempio si vuole che l'utente passi a una schermata diversa dopo che i dati sono stati inviati correttamente, nella proprietà 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 visualizzerà un avviso rosso nella parte superiore della schermata con il messaggio "I dati non sono stati salvati. Provare di nuovo o contattare l'amministratore". Questo messaggio consente all'utente di risolvere il problema più facilmente.
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.
Proprietà LastSubmit
Dopo che il modulo è stato inviato con esito positivo, è 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 (sostituire FormName con il nome del modulo). Si può anche accedere a un elemento del record LastSubmit inserendo un controllo Etichetta nell'app e quindi usando una formula quale FormName.LastSubmit.ID, che restituisce la proprietà ID dell'ultimo record inviato. La comprensione del concetto alla base della proprietà LastSubmit è molto utile quando si inizia a creare dati relazionali in cui è necessario conoscere il valore di un precedente invio di modulo.
La prossima unità illustra alcune preziose proprietà speciali del controllo Form.