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 Microsoft Listes.
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 |
|---|---|---|
| DataSourceInfo.DisplayName | Chaîne | Nom d’affichage de la colonne. Si aucun nom d’affichage n’est défini, renvoie le nom de colonne. |
| DataSourceInfo.MaxLength | 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. |
| DataSourceInfo.MaxValue | 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. |
| DataSourceInfo.MinValue | 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.Required | 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.AllowedValues | 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. |
| DataSourceInfo.CreatePermission | 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.DeletePermission | 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. |
| DataSourceInfo.ReadPermission | 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.
Information : obligatoire. Type d’informations à récupérer.
ColumnName : facultatif. Nom de la colonne sous forme de chaîne pour plus d’informations au niveau de la colonne. Par exemple, la colonne Phone est transmise en tant que "Phone" avec des guillemets doubles. Pour plus d’informations au niveau de la source de données, l’argument ColumnName ne peut pas être utilisé.
Note
Pour des sources de données Excel ou SharePoint contenant des noms de colonne avec des espaces, spécifiez ceux-ci sous la forme « _x0020_ ». Par exemple, spécifiez « Nom de colonne » sous la forme « Nom_x0020_de colonne ».
Exemples
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( IceCream, DataSourceInfo.DisplayName, "Quantity" ) | Renvoie le nom complet de la colonne Quantity de la source de données IceCream. | "Quantity on Hand" |
| DataSourceInfo( IceCream, DataSourceInfo.MaxLength, "Flavor" ) | Renvoie la longueur maximale de la chaîne pour la colonne Flavor de la source de données IceCream. | 30 |
| DataSourceInfo( IceCream, DataSourceInfo.Required, "Flavor" ) | La colonne Flavor de la source de données IceCream est-elle requise ? | true |
| DataSourceInfo( IceCream, DataSourceInfo.Required, "Quantity" ) | La colonne Quantity de la source de données IceCream est-elle requise ? | false |
| DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Quantity" ) | Renvoie la valeur numérique maximale de la colonne Quantity de la source de données IceCream. | 100 |
| DataSourceInfo( IceCream, DataSourceInfo.MinValue, "Quantity" ) | Renvoie la valeur numérique minimale de la colonne Quantity de la source de données IceCream. | 0 |
| DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) | L’utilisateur actuel peut-il lire les enregistrements dans la source de données IceCream ? | true |
| DataSourceInfo( IceCream, DataSourceInfo.EditPermission) | L’utilisateur actuel peut-il modifier les enregistrements de la source de données IceCream ? | true |
| DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) | L’utilisateur actuel peut-il créer des enregistrements dans la source de données IceCream ? | false |
| DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) | L’utilisateur actuel peut-il supprimer des enregistrements de la source de données IceCream ? | false |