DataSourceInfo |
Information de source de données |
| Power Fx |
Syntaxe
|
DataSourceInfo( DataSource, Information [, ColumnName] )
|
Paramètres
| Nom |
Description |
| DataSource |
Ce paramètre représente la source de données sur laquelle on souhaite obtenir des informations. Ce paramètre permet d'identifier la table, collection ou connexion ciblée. |
| Information |
Ce paramètre spécifie le type d'information à extraire (par exemple : DataSourceInfo.Readable, DataSourceInfo.Writable). Ce paramètre permet de définir la nature de l'information souhaitée. |
| ColumnName |
Ce paramètre représente le nom d'une colonne spécifique dans la source de données. Ce paramètre permet d'obtenir des informations ciblées sur cette colonne (comme sa validation ou sa nécessité). |
Description
Cette fonction permet de retourner des informations sur une source de données, telles que les capacités de lecture et d'écriture.
Remarques
- La fonction DataSourceInfo permet d'interroger dynamiquement une source de données pour en connaître les capacités ou contraintes, comme la possibilité
d'écrire ou de lire. Elle est utile pour adapter le comportement d'une application en fonction des droits ou des restrictions d'une source externe. C'est une approche proactive
améliorant la fiabilité des interactions avec les données.
- Le paramètre Information donne accès à différents types de métadonnées, tels que DataSourceInfo.Readable, Writable, Required, ou encore MaxLength. Ces constantes
permettent de structurer des interfaces utilisateurs plus intelligentes et robustes. Par exemple, vous pouvez désactiver un bouton de soumission si une colonne obligatoire
est manquante.
- En ajoutant un troisième paramètre ColumnName, on peut affiner la requête et obtenir des informations précises sur une colonne donnée. Cela permet par exemple de détecter
si une colonne est obligatoire avant d'autoriser la création d'un enregistrement. C'est une fonctionnalité clé pour garantir la conformité des données entrées.
- DataSourceInfo s'applique aussi bien aux collections locales qu'aux connexions vers des sources externes comme
SharePoint, Dataverse, ou SQL Server.
Cela garantit une utilisation homogène de cette fonction, quel que soit le back-end choisi. Elle s'intègre naturellement dans une logique multiplateforme de gestion des
données.
- La fonction est particulièrement utile dans les applications évolutives ou multi-utilisateurs, où les capacités de la source de données peuvent varier selon les rôles
ou les droits d'accès. Par exemple, certains utilisateurs peuvent écrire dans une table tandis que d'autres ne peuvent que la lire. Avec DataSourceInfo, on peut adapter
l'expérience utilisateur à la volée.
- DataSourceInfo peut être utilisée à des fins de validation conditionnelle, notamment dans les formulaires Power Apps. Elle permet d'afficher dynamiquement des
messages d'avertissement ou de bloquer certaines interactions si une contrainte n'est pas respectée. Cela contribue à améliorer la qualité des données dès leur saisie.
- Son utilisation améliore la transparence et la documentation implicite de l'application. En rendant explicites les capacités des données, elle aide les développeurs à
éviter des erreurs de logique, comme essayer d'écrire dans une source en lecture seule. Cela réduit les risques d'erreur d'exécution à la publication de l'application.
- En environnement professionnel, DataSourceInfo peut être utilisée pour créer des solutions « auto-adaptatives », capables de s'ajuster à des modèles de données
évoluant dans le temps. Par exemple, si une colonne devient obligatoire dans la source, l'application peut détecter ce changement sans modification manuelle du code.
C'est un outil stratégique pour garantir la pérennité et la maintenance simplifiée des applications.
Dernière mise à jour : Jeudi, le 1 Mai 2025