NewForm

Syntaxe

Paramètres

Description

Cette fonction permet de changer un formulaire en mode nouveau.

Remarques

• Active le mode d'ajout pour un formulaire : La fonction NewForm est essentielle lorsqu'on souhaite préparer un formulaire à recevoir de nouvelles données. Elle réinitialise le formulaire et le met en mode "création", ce qui permet à l'utilisateur de saisir un nouvel enregistrement sans interférence avec des données existantes.
• Doit être appelée avant l'affichage du formulaire : Pour que le formulaire apparaisse correctement en mode "nouveau", il est recommandé d'exécuter NewForm avant de naviguer vers l'écran où se trouve le formulaire, ou dans l'événement OnVisible de cet écran, afin de s'assurer que le formulaire est dans le bon état.
• Travaille en synergie avec SubmitForm : NewForm prépare le formulaire pour la création, mais il faut ensuite utiliser SubmitForm pour envoyer les données saisies. Ces deux fonctions sont souvent utilisées ensemble dans les applications Power Apps pour gérer le cycle de vie d'un enregistrement.
• Réinitialise tous les champs du formulaire : L'appel à NewForm efface toutes les données précédemment visibles dans les champs du formulaire. Cela évite que l'utilisateur voie ou modifie accidentellement des informations issues d'un autre enregistrement.
• Utile dans les applications à saisie répétée : Dans les cas où un utilisateur doit créer plusieurs enregistrements à la suite (par exemple dans un inventaire ou une liste de tâches), NewForm permet de réinitialiser le formulaire après chaque envoi pour recommencer une nouvelle saisie immédiatement.
• Ne fonctionne qu'avec les contrôles de formulaire : La fonction NewForm est spécifique aux objets Form (comme EditForm dans Power Apps). Elle ne peut pas être utilisée sur des galeries ou des champs isolés, ce qui souligne la nécessité de bien structurer les interfaces autour de ces contrôles.
• Améliore la gestion des états de l'interface : En distinguant clairement le mode "nouveau" (avec NewForm) du mode "édition" (avec EditForm), on peut adapter dynamiquement l'interface utilisateur selon le contexte, par exemple en changeant le texte des boutons ou en affichant certains champs uniquement en création.
• Peut être combinée à des contextes personnalisés : On peut combiner l'appel à NewForm avec la mise à jour de variables de contexte via UpdateContext pour personnaliser davantage le formulaire, comme préremplir certains champs selon le profil utilisateur ou des règles métiers.