Spalten „Format“ und „FormatName“

"Format" und "FormatName" sind die Spalten, die die Formatwerte speichern und von den Steuerelementen und der Benutzeroberfläche verwendet werden, um zu wissen, wie der Inhalt angezeigt wird.

Format ist die ältere Spalte, in der die von Microsoft Dataverse verwendeten Werte gespeichert werden. Um die Abwärtskompatibilität aufrechtzuerhalten, konnten keine neuen Formate eingeführt werden. Aus diesem Grund werden einige API-Antworten nicht mit dem neuen Format übereinstimmen. Für Text und Multiline Text Spalten wird empfohlen, die FormatName Spalte zu verwenden.

"FormatName " ist die neue Spalte, die zum Angeben des Formats für Text und Multiline Text Spaltendatentypen verwendet wird. FormatName Spalte bietet eine genauere Antwort für das ausgewählte Format und unterstützt neuere Formattypen.

API-Verhalten

• Wenn die eingehende Nutzlast beim Create-Vorgang sowohl Format - als auch FormatName-Informationen enthält, wird der FormatName-Wert zuerst berücksichtigt. Wenn die Nutzlast nur einen Wert enthält, berücksichtigt das System, was in der Nutzlast vorhanden ist.

• Beim Abrufvorgang kann ein Datentyp mit einem definierten Format unterschiedliche Werte für die API-Antworten Format und FormatName basierend auf der Kompatibilität bereitstellen. Beispielsweise gibt eine Textspalte, die auf RichText das Format festgelegt ist, Folgendes zurück:

  • Format: 'Text'
  • FormatName: 'RichText'.
  • Der Vorgang korrigiert alle inkompatiblen Format - oder FormatName-Werte , die in einem Datentyp vorhanden sind, indem die Werte in den Standardwert geändert werden. Wenn beispielsweise eine Textspalte in "Date Only in Dataverse" geändert wird, korrigiert der Abrufvorgang das Format auf die folgenden Werte:
    • Format: 'Text'
    • FormatName: 'Text'.

• Bei Aktualisierungsvorgang berücksichtigt das System nur den FormatName-Wert . Der Wert von Format wird NICHTberücksichtigt, auch wenn der FormatName-Wert nicht vorhanden ist.

Die folgende Tabelle enthält die Werte "Format " und " FormatName " und "API"-Antworten für jeden Typ:

Spaltentyp	Plattformformat / Wert in Lösungs-XML	Format SDK-Definition	FormatName SDK-Definition	API-Antwortwert	Anmerkungen
Text	Text	StringFormat.Text	StringFormatName.Text	Format: Text FormatName: Text	Standard-Formatwert für Stringspalte.
	Email	StringFormat.Email	StringFormatName.Email	Format: E-Mail FormatName: E-Mail
	Textfeld	StringFormat.Textbereich	StringFormatName.TextArea	Format: TextArea FormatName: TextArea
	URL	StringFormat.Url	StringFormatName.Url	Format: URL FormatName: URL
	Börsenkürzel	StringFormat.TickerSymbol	StringFormatName.TickerSymbol	Format: TickerSymbol FormatName: Tickersymbol
	Versionsnummer	StringFormat.VersionNumber	StringFormatName.VersionNumber	Format: VersionNumber FormatName: VersionNumber
	Telefonnummer	StringFormat.Phone	StringFormatName.Phone	Format: Text FormatName: Telefon
	JSON	StringFormat.Json	StringFormatName.Json	Format: Text FormatName: Json
	Rich-Text	StringFormat.RichText	MemoFormatName.RichText	Format: Text FormatName: RichText	Nur für Nicht-SQL-Datenanbieter zulässig.
Memo/Mehrzeilentext	Text	StringFormat.Text	MemoFormatName.Text	Format: Text FormatName: Text	Standardformatwert für Memo-/Mehrzeilenspalte.
	Email	StringFormat.Email	MemoFormatName.Email	Format: E-Mail FormatName: E-Mail
	Textfeld	StringFormat.Textbereich	MemoFormatName.TextArea	Format: TextArea FormatName: TextArea
	InternalExtentdaten	StringFormat.Te	StringFormatName.Text	Format: Text FormatName: Text
	JSON	StringFormat.Json	MemoFormatName.Json	Format: Text FormatName: Json	Nur für Nicht-SQL-Datenanbieter zulässig.
	Rich-Text	StringFormat.RichText	MemoFormatName.RichText	Format: Text FormatName: RichText
Ganze Zahl	None/String.Empty	IntegerFormat.None	N/A	Format: Keine	Standardformatwert für die Spalte "Integer".
	Duration	IntegerFormat.Duration	N/A	Format: Dauer
	TimeZone	IntegerFormat.TimeZone	N/A	Format: Zeitzone
	Language	Ganzzahlformat.Sprache	N/A	Format: Sprache
	Gebietsschema	IntegerFormat.Locale	N/A	Format: Locale
Datum und Uhrzeit	DateTime	DateTimeFormat.DatumUndUhrzeit	N/A	Format: DateAndTime	Standardformatwert für DateTime-Spalte.

Verwandte Artikel

Datentypformatkonvertierungen
Formatüberprüfungen