Defaults

Syntaxe

Paramètres

Description

Cette fonction permet de retourner les valeurs par défaut pour une source de données.

Remarques

• La fonction Defaults permet de récupérer un enregistrement contenant les valeurs par défaut d'une source de données. Elle est particulièrement utile lorsqu'on souhaite créer un nouvel enregistrement avec des champs pré-remplis selon la configuration de la source. Cela évite de devoir définir manuellement des valeurs initiales pour chaque champ.
• Le paramètre DataSource est essentiel, car il détermine quelle table ou collection sera utilisée pour générer les valeurs par défaut. La qualité des valeurs retournées dépend de la configuration de cette source (valeurs définies côté base de données ou via le connecteur). Il est donc important de bien connaître les métadonnées associées à la source de données.
• En général, Defaults est utilisé en conjonction avec la fonction Patch pour insérer de nouveaux enregistrements dans une source de données. Par exemple, on initialise un formulaire avec Defaults(DataSource) pour ensuite le modifier avant soumission. Cette pratique améliore la cohérence et réduit le risque d'erreurs lors de l'enregistrement.
• Defaults ne modifie pas la source de données, elle ne fait que retourner un modèle d'enregistrement. Cela permet de préparer un nouvel enregistrement sans impacter les données existantes. C'est une approche sûre et non destructive pour initier des opérations de création.
• L'utilisation de Defaults est préférable à la création manuelle d'un enregistrement vide avec des champs définis à la main. Elle permet d'assurer la compatibilité avec les champs obligatoires ou pré-remplis définis dans la source de données. Ainsi, on respecte mieux les contraintes et les règles de validation de la base.
• Selon le connecteur utilisé (SharePoint, SQL Server, Dataverse,...), les valeurs retournées par Defaults peuvent différer. Certaines sources incluent des valeurs calculées ou dynamiques par défaut, d'autres retournent simplement des champs vides. Il convient donc de tester la fonction dans le contexte exact de son application.
• Defaults peut être utilisé dans une logique de formulaire (Form control) pour initialiser la propriété Item. Cela permet de distinguer clairement les scénarios de création d'enregistrement de ceux de mise à jour. Cette approche améliore la lisibilité et la structure du code dans Power Fx.
• Dans certains cas, l'enregistrement retourné par Defaults peut inclure des champs système ou techniques. Il est alors utile de filtrer ou masquer certains champs non pertinents dans l'interface utilisateur. Cela permet de garder un formulaire clair et concentré sur les informations utiles pour l'utilisateur final.