Fonction DataSourceInfo
S’applique à :
Applications canevas Applications pilotées par modèle
Fournit des informations sur une source de données.
Résumé
Les sources de données sont une véritable manne d’informations et optimisent ainsi l’expérience utilisateur.
Vous pouvez utiliser les informations au niveau de la colonne pour valider les saisies de l’utilisateur et lui fournir des commentaires immédiats avant d’utiliser la fonction Patch. La fonction Validate utilise les mêmes informations.
Vous pouvez utiliser les informations au niveau de la source de données, par exemple pour désactiver ou masquer les boutons Edit et New lorsque les utilisateurs ne sont pas autorisés à modifier et à créer des enregistrements.
Les sources de données ne fournissent pas toutes la même quantité d’informations. Parfois même, elles n’en fournissent aucune. Les collections ne fournissent aucune information. Si un élément d’information n’est pas fourni, une valeur par défaut est utilisée ou une valeur vide est renvoyée.
Note
Actuellement, la fonction DataSourceInfo n’est pas prise en charge dans les listes. Microsoft
Description
Informations sur la colonne
Vous pouvez utiliser DataSourceInfo pour obtenir des informations sur une colonne en particulier d’une source de données :
| Argument d’informations | Type de résultat | Description |
|---|---|---|
| Informations sur la source de données.Nom d’affichage | Chaîne | Nom d’affichage de la colonne. Si aucun nom d’affichage n’est défini, renvoie le nom de colonne. |
| Informations sur la source de données.Longueur maximale | Nombre | Nombre maximal de caractères que peut contenir la colonne. S’applique uniquement aux colonnes qui contiennent des chaînes. Si aucune valeur maximale n’est définie, renvoie vide. |
| Informations sur la source de données.Valeur maximale | Nombre | Valeur numérique maximale qu’une colonne peut contenir. S’applique uniquement aux colonnes qui contiennent des nombres. Si aucune valeur maximale n’est définie, renvoie vide. |
| Informations sur la source de données.Valeur minimale | Nombre | Valeur numérique minimale qu’une colonne peut contenir. S’applique uniquement aux colonnes qui contiennent des nombres. Si aucune valeur minimale n’est définie, renvoie vide. |
| DataSourceInfo.Obligatoire | Booléenne | Une valeur est-elle attendue pour cette colonne ? Si elle n’est pas définie par la source de données, renvoie false. |
Le troisième argument est le nom d’une colonne en tant que chaîne. Par exemple, la colonne Phone dans la collection People est transmise en tant que "Phone" avec des guillemets doubles.
Informations sur la source de données
Vous pouvez également utiliser DataSourceInfo pour obtenir des informations sur une source de données dans son ensemble :
| Argument d’informations | Type de résultat | Description |
|---|---|---|
| DataSourceInfo.Valeurs autorisées | Booléenne | Quels types d’autorisations peuvent être accordées aux utilisateurs pour cette source de données ? Si rien n’est défini par la source de données, retourne vide. |
| Informations sur la source de données.Créer une autorisation | Booléen | L’utilisateur actuel dispose-il d’autorisations pour créer des enregistrements dans cette source de données ? Si rien n’est défini par la source de données, renvoie true. |
| DataSourceInfo.Supprimer l’autorisation | Booléen | L’utilisateur actuel dispose-il d’autorisations pour supprimer des enregistrements dans cette source de données ? Si rien n’est défini par la source de données, renvoie true. |
| DataSourceInfo.EditPermission | Booléen | L’utilisateur actuel dispose-il d’autorisations pour modifier des enregistrements dans cette source de données ? Si rien n’est défini par la source de données, renvoie true. |
| Informations sur la source de données.Permission de lecture | Booléen | L’utilisateur actuel dispose-il d’autorisations pour lire des enregistrements dans cette source de données ? Si rien n’est défini par la source de données, renvoie true. |
Note
DataSourceInfo renvoie true s’il ne peut pas déterminer si l’utilisateur actuel dispose de l’autorisation demandée. Les autorisations seront à nouveau vérifiées par le serveur lorsque l’opération en cours sera effectuée ; une erreur s’affiche si elle n’a pas été autorisée. À ce stade, la vérification des autorisations avec DataSourceInfo n’est possible qu’en utilisant Microsoft Dataverse.
Syntaxe
DataSourceInfo( DataSource, Information [, ColumnName] )
- DataSource – Obligatoire. Source de données à utiliser.
- Informations – Obligatoire. Type d’informations à récupérer.
- ColumnName – Facultatif. Le nom de la colonne pour lequel récupérer des informations au niveau de la colonne. Pour plus d’informations au niveau de la source de données, l’argument ColumnName ne peut pas être utilisé.
Note
Dans Power Apps avant la version 3.24042, les noms de colonnes étaient spécifiés avec une chaîne de texte utilisant des guillemets doubles et, s’ils étaient connectés à une source de données, ils devaient également être des noms logiques. Par exemple, le nom logique "cr43e_name" avec des guillemets doubles a été utilisé à la place du nom complet Nom sans guillemets. Pour les sources de données SharePoint et Excel contenant des noms de colonnes avec des espaces, chaque espace était spécifié avec "_x0020_", par exemple "Nom de la colonne" comme "Column_x0020_Name". Après cette version, toutes les applications ont été automatiquement mises à jour sur la nouvelle syntaxe décrite dans cet article.
Examples
Dans les exemples de cette section, nous utilisons une source de données appelée IceCream :
Cette source de données fournit également les informations suivantes :
- Le nom d’affichage pour Quantity est "Quantity on Hand".
- La longueur maximale de Flavor est de 30 caractères.
- La colonne Flavor doit contenir une valeur. La colonne Quantity n’est pas requise.
- La valeur minimale de Quantity est 0.
- La valeur maximale de Quantity est 100.
- L’utilisateur actuel peut lire et modifier les enregistrements de la source de données IceCream, mais il ne peut pas en créer ni en supprimer.
| Formule | Description | Résultat |
|---|---|---|
| DataSourceInfo(Crème glacée, DataSourceInfo.DisplayName, Quantité) | Renvoie le nom complet de la colonne Quantity de la source de données IceCream. | "Quantity on Hand" |
| DataSourceInfo(Crème glacée, DataSourceInfo.MaxLength, Saveur) | Renvoie la longueur maximale de la chaîne pour la colonne Flavor de la source de données IceCream. | 30 |
| DataSourceInfo(Crème glacée, DataSourceInfo.Required, Saveur) | La colonne Flavor de la source de données IceCream est-elle requise ? | vrai |
| DataSourceInfo(Crème glacée, DataSourceInfo.Required, Quantité) | La colonne Quantity de la source de données IceCream est-elle requise ? | FAUX |
| DataSourceInfo(Crème glacée, DataSourceInfo.MaxValue, Quantité) | Renvoie la valeur numérique maximale de la colonne Quantity de la source de données IceCream. | 100 |
| DataSourceInfo(Crème glacée, DataSourceInfo.MinValue, Quantité) | Renvoie la valeur numérique minimale de la colonne Quantity de la source de données IceCream. | 0 |
| DataSourceInfo(Crème glacée, DataSourceInfo.ReadPermission) | L’utilisateur actuel peut-il lire les enregistrements dans la source de données IceCream ? | vrai |
| DataSourceInfo(Crème glacée, DataSourceInfo.EditPermission) | L’utilisateur actuel peut-il modifier les enregistrements de la source de données IceCream ? | vrai |
| DataSourceInfo(Crème glacée, DataSourceInfo.CreatePermission) | L’utilisateur actuel peut-il créer des enregistrements dans la source de données IceCream ? | FAUX |
| DataSourceInfo(Crème glacée, DataSourceInfo.DeletePermission) | L’utilisateur actuel peut-il supprimer des enregistrements de la source de données IceCream ? | FAUX |