Colonnes Format et FormatName

Format et FormatName sont les colonnes qui stockent les valeurs de format et sont utilisées par les contrôles et l’interface utilisateur pour savoir comment afficher le contenu.

Le format est l’ancienne colonne qui stocke les valeurs utilisées par Microsoft Dataverse. Pour maintenir la compatibilité descendante, les nouveaux formats n’ont pas pu être introduits. En raison de cela, certaines réponses de l’API ne s’alignent pas sur le nouveau format. Pour les colonnes Text et Multiline Text, il est recommandé d’utiliser la colonne FormatName.

FormatName est la nouvelle colonne utilisée pour spécifier le format des types de Text données de colonne et Multiline Text de colonne. FormatName la colonne fournit une réponse plus précise pour le format sélectionné et prend en charge les types de format plus récents.

Comportement de l’API

• Lors de l’opération Create , si la charge utile entrante contient des informations Format et FormatName , la valeur FormatName est considérée en premier. Si la charge utile ne contient qu’une seule valeur, le système considère ce qui est présent dans la charge utile.

• Lors de l’opération Retrieve, un type de données avec un format défini peut fournir des valeurs différentes pour les réponses de l’API et Format en fonction de la FormatName compatibilité. Par exemple, une colonne de texte au format RichText retourne les éléments suivants :

  • Format : 'Text'
  • FormatName : 'RichText'.
  • L’opération de récupération corrige les valeurs Format ou FormatName incompatibles présentes sur un type de données en modifiant les valeurs par défaut. Par exemple, si une colonne de texte est remplacée par Date uniquement dans Dataverse, l’opération de récupération corrige le format des valeurs suivantes :
    • Format : 'Text'
    • FormatName : 'Text'.

• Lors de l’opération Update , le système prend uniquement en compte la valeur FormatName . La valeur de Formatn’est pasconsidérée même si la valeur FormatName n’est pas présente.

Le tableau suivant fournit les valeurs Format et FormatName et les réponses d’API pour chaque type :

Type de colonne	Format de la plateforme / Valeur dans la solution XML	Définition du SDK de format	Définition du Kit de développement logiciel (SDK) FormatName	Valeur de réponse de l’API	Remarques
Texto	Texto	StringFormat.Text	StringFormatName.Text	Format : Texte FormatName : Texte	Valeur de format par défaut pour la colonne String.
	Messagerie électronique	StringFormat.Email	StringFormatName.Email	Format : e-mail FormatName : e-mail
	Zone de texte	StringFormat.TextArea	StringFormatName.TextArea	Format : TextArea FormatName : TextArea
	URL	StringFormat.Url	StringFormatName.Url	Format : URL FormatName : URL
	Symbole de l’action	StringFormat.TickerSymbol	StringFormatName.TickerSymbol	Format: TickerSymbol FormatName : TickerSymbol
	Numéro de version	FormatDeChaîne.NuméroDeVersion	StringFormatName.VersionNumber	Format : VersionNumber FormatName : Numéro_version
	Téléphone	StringFormat.Phone	StringFormatName.Téléphone	Format : Texte FormatName : Téléphone
	JSON	StringFormat.Json	StringFormatName.Json	Format : Texte FormatName : Json
	Texte enrichi	StringFormat.RichText	MemoFormatName.RichText	Format : Texte FormatName : RichText	Uniquement autorisé pour le fournisseur de données non-SQL.
Texte multiligne/mémo	Texto	StringFormat.Text	MemoFormatName.Text	Format : Texte FormatName : Texte	Valeur de format par défaut pour la colonne Mémo/Multiligne.
	Messagerie électronique	StringFormat.Email	MemoFormatName.Email	Format : e-mail FormatName : e-mail
	Zone de texte	StringFormat.TextArea	MemoFormatName.TextArea	Format : TextArea FormatName : TextArea
	InternalExtentdata	StringFormat.Te	StringFormatName.Text	Format : Texte FormatName : Texte
	Json	StringFormat.Json	MemoFormatName.Json	Format : Texte FormatName : Json	Uniquement autorisé pour le fournisseur de données non-SQL.
	Texte enrichi	StringFormat.RichText	MemoFormatName.RichText	Format : Texte FormatName : RichText
Nombre entier	None/String.Empty	IntegerFormat.None	N/A	Format : Aucun	Valeur de format par défaut pour la colonne Integer.
	Durée	IntegerFormat.Duration	N/A	Format : Durée
	TimeZone	IntegerFormat.TimeZone	N/A	Format : TimeZone
	Language	IntegerFormat.Language	N/A	Format : Langue
	Paramètres régionaux	IntegerFormat.Locale	N/A	Format : Paramètres régionaux
Date et heure	Date et heure	DateTimeFormat.DateAndTime	N/A	Format : DateAndTime	Valeur de format par défaut pour la colonne DateTime.

Articles connexes

Conversions de format de type de données
Validations de format