SubmitForm

Syntaxe

Paramètres

Description

Cette fonction permet d'enregistrer les modifications apportées à un formulaire dans la source de données.

Remarques

• Automatise l'enregistrement des données dans la source : SubmitForm est essentielle pour envoyer les données saisies ou modifiées dans un formulaire vers la source de données associée, qu'il s'agisse de SharePoint, Dataverse ou autre. Cela garantit la persistance des modifications effectuées par l'utilisateur dans l'interface.
• Nécessite que le formulaire soit correctement configuré : Pour fonctionner correctement, le formulaire référencé par SubmitForm doit être lié à une source de données valide. Si le formulaire n'est pas connecté ou contient des erreurs de configuration, la soumission échouera et générera une erreur.
• Déclenche les événements de validation intégrés au formulaire : Lorsque SubmitForm est exécutée, toutes les règles de validation définies dans le formulaire sont automatiquement évaluées. Cela permet de garantir que seules les données valides seront envoyées à la source, empêchant ainsi les enregistrements incorrects.
• Peut être combinée avec OnSuccess et OnFailure : Il est courant d'utiliser SubmitForm avec les propriétés OnSuccess et OnFailure du formulaire pour définir des actions en cas de réussite ou d'échec. Cela permet, par exemple, de naviguer vers un autre écran après un enregistrement réussi ou d'afficher un message d'erreur si la soumission échoue.
• Remplace les appels manuels à Patch pour les formulaires simples : Dans les cas classiques où un formulaire est utilisé pour ajouter ou modifier des données, SubmitForm permet d'éviter l'usage plus complexe de la fonction Patch. Elle fournit une solution plus rapide et intuitive pour manipuler les données via l'interface graphique.
• L'ordre de soumission est important dans certains contextes : Lorsqu'un écran contient plusieurs formulaires, il peut être nécessaire de contrôler l'ordre de soumission via plusieurs appels à SubmitForm. Ceci est crucial notamment si les données sont dépendantes entre elles ou doivent respecter une séquence logique.
• N'affiche pas automatiquement de confirmation visuelle : Par défaut, SubmitForm ne génère pas de message de confirmation à l'utilisateur. Il est donc recommandé d'ajouter un retour visuel explicite (par exemple avec une variable ou une étiquette) pour informer l'utilisateur que les données ont bien été enregistrées.
• Peut déclencher des flux de travail en aval : Lorsque des données sont soumises via SubmitForm, cela peut déclencher des automatisations définies en aval dans la plateforme (comme Power Automate). Cela permet d'intégrer le formulaire dans des processus métier plus larges, comme des avertissements ou des validations.