Fournit des informations sur une source de données.

Vue d’ensemble

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 Modifier et Nouveau 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.

Description

Informations sur les colonnes

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 Valeur 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 Valeur 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 Valeur booléenne 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 Valeur booléenne 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 Valeur booléenne 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 Valeur booléenne 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.

Syntaxe

DataSourceInfo( DataSource, Information, ColumnName )

  • DataSource : requis. Source de données à utiliser.
  • Information : requis. 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é.

    Remarque: pour des sources de données Excel ou SharePoint contenant des noms de colonne avec des espaces, spécifiez chacune d’elles sous la forme « _x0020_ ». Par exemple, spécifiez « Nom de colonne » sous la forme « Nom_x0020_de_x0020_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