Envoyer votre formulaire
La dernière étape de l’utilisation d’un contrôle Formulaire consiste à soumettre les modifications. Pour ce faire, nous utilisons la fonction SubmitForm. Cette fonction est souvent placée sur un contrôle Bouton appelé Save ou Submit. La formule pour OnSelect est SubmitForm(YourFormName).
Cette fonction prend toutes les données entrées dans les contrôles sur vos cartes de données et les enregistre dans la source de données du contrôle Formulaire. Chaque carte de données sur votre contrôle Formulaire contient une propriété Update qui spécifie les données, sous la forme de formule qui sera écrite à la source de données lorsque SubmitForm sera appelé. Si vous avez déverrouillé votre carte, vous pouvez modifier cette formule. Cette opération est souvent inutile et seulement effectuée dans des circonstances particulières.
Important
Lorsque vous commencez à modifier les formules des cartes, vous devez faire correspondre le type de données attendu par votre source, faute de quoi vous risquez de recevoir une erreur et de ne pas enregistrer correctement vos données.
Après l’envoi de votre formulaire
Le contrôle Formulaire est simple à utiliser, car il suffit d’un appel de la fonction SubmitForm pour faire disparaître vos données et mettre à jour votre source de données. Le contrôle Formulaire a trois propriétés qui opèrent après l’envoi des données en fonction du résultat de l’envoi. Ces propriétés sont OnSuccess, OnFailure et OnReset. De plus, la propriété LastSubmit vous fournit un enregistrement des données soumises à partir du formulaire.
Remarque
Si vous voulez que l’envoi de votre formulaire fasse quelque chose d’autre, comme naviguer vers un autre écran, ajoutez le codage dans l’une de ces trois propriétés de formulaire. N’ajoutez pas de code supplémentaire au bouton, à l’icône ou à la fonction qui appelle l’action SubmitForm.
Pour chacune de ces propriétés, vous pouvez entrer une formule. Par exemple, si vous souhaitez que l’utilisateur accède à un autre écran après l’envoi réussi de ses données, dans OnSuccess, utilisez la fonction Navigate(SuccessScreen, ScreenTransition.Cover) pour l’envoyer à l’écran appelé SuccessScreen.
Propriété OnFailure
Utilisez la propriété OnFailure si une erreur se produit lors de l’envoi des données. Vous pouvez utiliser une formule pour spécifier un message d’avertissement qui s’affiche lorsque la défaillance se produit. La formule suivante est un exemple d’utilisation de la fonction Notify pour fournir plus d’informations à l’utilisateur.
Notify("Your data was not saved. Please try again or contact an administrator.", NotificationType.Error)
Cette fonction affiche un avertissement rouge en haut de l’écran avec le message « Vos données n’ont pas été enregistrées. Réessayez ou contactez un administrateur. » Ce message facilite la résolution du problème par l’utilisateur.
Propriété OnReset
Utilisez la propriété OnReset si le formulaire est réinitialisé. Une réinitialisation de formulaire se produit lorsque la fonction ResetForm est utilisée. La fonction ResetForm réinitialise le formulaire avec ses valeurs par défaut, puis exécute toute formule spécifiée dans la propriété OnReset. Par exemple, supposez que vous souhaitez réinitialiser un contrôle Variable ou Minuteur utilisé avec les interactions avec le formulaire.
Propriété LastSubmit
Après l’envoi réussi de votre formulaire, vous pouvez référencer directement l’enregistrement envoyé. Le dernier enregistrement envoyé est disponible en utilisant la propriété LastSubmit qui contient l’enregistrement complet. Vous pouvez accéder à l’enregistrement à l’aide de la formule FormName.LastSubmit (remplacez FormName par le nom de votre formulaire). Vous pouvez également accéder à un élément de l’enregistrement LastSubmit en insérant un contrôle Libellé dans votre application, puis en utilisant une formule telle que : FormName.LastSubmit.ID qui renvoie la propriété ID du dernier enregistrement soumis. Il est essentiel de comprendre que LastSubmit est un concept très efficace quand vous commencez à générer des données relationnelles et avez besoin de connaître la valeur d’un envoi de formulaire précédent.
Dans l’unité suivante, nous aborderons certaines propriétés spécifique du contrôle de formulaire, qui peuvent s’avérer très utiles.