Freigeben über

Konvertierungen von Datentypformaten

Microsoft Dataverse verfügt über mehrere Datentypen , die mit unterschiedlichen Formaten konfiguriert werden können. Sie können das Format der Spalte entweder über den Solution Explorer oder durch API-Vorgänge angeben. Die folgenden Abschnitte enthalten weitere Details zu Datentypformaten, einschließlich:

Unterstützte Formate nach Datentyp

In der Formatspalte wird die Benutzeroberfläche zum Anzeigen des Inhalts angegeben. Einige Formate, die auf der Benutzeroberfläche verfügbar sind, sind Telefon, E-Mail oder Dauer. Die angewendeten Formate überprüfen keinen Kontext, keine Domänen oder andere Werte. Sie weisen die Benutzeroberfläche an, welches Steuerelement für diesen Typ verwendet werden soll.

Formate

Die folgende Tabelle enthält Informationen zu den für jeden Datentyp verfügbaren Formaten:

Datentyp Formatname Beschreibung Für App-Entwickler verfügbar? Hinweise
Text Text Einfache Textspalte, die Textzeichen enthält. Yes Standardwert für die Textspalte.
Textfeld Textspalte, die Textzeichen enthält und auch Zeilenumbrüche zulässt. Yes
Email Der Text enthält einen Link zum Öffnen der E-Mail-Anwendung des Benutzers. Yes
URL Der Text stellt einen Link zum Öffnen der angegebenen Seite bereit. Jedem Text, der nicht mit einem gültigen Protokoll beginnt, wird https:// vorangestellt Yes
Börsenkürzel Für die meisten Sprachen ist der Text als Link zum Öffnen der MSN Money-Website aktiviert, um Details zum Aktienkurs anzuzeigen, der durch das Tickersymbol dargestellt wird. Yes
Telefonnummer Spalten sind klickfähig, um Anrufe zu initiieren. Yes
JSON Speichert Text mit JSON-Formatierung Ja (nur API) Nur in Nicht-SQL-Speichern wie "Audit".
Rich-Text Ermöglicht Rich-Text-Formatierung, einschließlich HTML-Markup. Ja (nur API)
Versionsnummer Speichert die Versionsnummer für Zeilen. Nein Nur zur Systemnutzung.
Mehrzeiler Text (Memo) Text Einfache Textspalte, die Textzeichen enthält. Yes
Textfeld Die Textspalte enthält Textzeichen und ermöglicht Zeilenumbrüche. Yes
Email Nur zur internen Verwendung. Nein
JSON Speichert Text mit JSON-Formatierung Ja (nur API) Nur in Nicht-SQL-Speicher wie Log.
RichText Ermöglicht Rich-Text-Formatierung, einschließlich HTML-Markup. Y (nur API)
InternalExtentData Nur zur internen Verwendung. Nein Nur Systemverwendung
Keine/string.Empty Mit dieser Option wird einfach eine Zahl angezeigt. Yes Standardformatwert für ganze Zahlenspalte.
Ganze Zahl Duration Mit dieser Formatoption wird eine Liste der Daueroptionen angezeigt. Die Datenmengen, die in der Datenbank gespeichert sind, entsprechen immer einer Anzahl von Minuten. Das Feld sieht wie eine Dropdownliste aus und bietet vorgeschlagene Optionen wie 1 Minute, 15 Minuten, 30 Minuten bis zu 3 Tage. Benutzer können aber auch die Optionen auswählen oder einfach eine Anzahl von Minuten eingeben, die dann zu diesem Zeitraum aufgelöst wird. Geben Sie z. B. "60" ein, und es entspricht 1 Stunde. Oder sie können „1 Stunde“ oder „2 Tage“ eingeben, was zu dieser Zeit aufgelöst wird.
Die Dauer muss im folgenden Format eingegeben werden: "x Minuten", "x Stunden" oder "x Tage". Stunden und Tage können auch mit Dezimalstellen eingegeben werden, z. B. "x.x Stunden" oder "x.x Tage".
HINWEIS: Werte müssen in Minuten ausgedrückt werden, Subminutenwerte werden auf die nächste Minute gerundet.		 Yes Dieser Wert wird vom System in Sekunden gelesen.
Timezone Mit dieser Option wird eine Auswahlliste der Zeitzonen unter Verwendung von Zeitzonencodes angezeigt. Jede dieser Zonen wird als Zahl gespeichert. Für die Zeitzone (GMT-08:00) Pacific Time (USA & Kanada) ist der TimeZoneCode beispielsweise 4. Modellgesteuerte Apps zeigen diese Codes als Zeitzonennamen an, während Canvas-Apps sie als gespeicherte Zahlen darstellen. Yes
Language Mit dieser Option wird eine Liste der für Ihre Organisation bereitgestellten Sprachen angezeigt. Die Werte werden mithilfe von LCID-Codes als Zahl gespeichert. Sprachcodes sind vierstellige oder fünfstellige Gebietsschema-IDs. Gültige Gebietsschema-ID-Werte finden Sie unter Gebietsschema-ID-Diagramm (LCID). Modellgesteuerte Apps zeigen die Sprachen als Sprachnamen an, Canvas-Apps werden als gespeicherte Zahl angezeigt. Yes
Gebietsschema Wert, der einem bestimmten Gebietsschema mit ISO-Standardwerten entspricht. Ja (nur API) Nicht in der Power Apps Maker-Benutzeroberfläche angezeigt.
Datum und Uhrzeit Nur Datum Nur Datum. Enthält eine Uhrzeit von 00:00:00, wenn Ortszeit Benutzer oder Zeitzonenunabhängig ausgewählt ist. Yes
Datum und Uhrzeit Datums- und Uhrzeitformat. Yes Standardformatwert für DateTime-Spalte.

Formatkonvertierung

Sie können das Datentypformat in jedes der kompatiblen Formate ändern, die vom Datentyp unterstützt werden. Das Ändern des Formats behält Ihre vorherigen Tabellendefinitionen (maxsize) bei, wenn sie im neuen Zielformat vorhanden sind. Wenn eine eingehende Nutzlast kein Format enthält, geht Dataverse davon aus, dass das Format nicht geändert werden soll. Sie können das Format durch einen API-Aufruf mit der gewünschten Nutzlast in der FormatName Spalte konvertieren. Das Ändern des Werts in der Format Spalte wird empfohlen, da alle neu hinzugefügten Format Auswahlen ignoriert werden.

Hinweis

Zurzeit werden Formatkonvertierungen nur durch API-Vorgänge durchgeführt. Das Ändern von Formaten ändert keine Daten, die in der Spalte vorhanden sind. Aus diesem Grund bemerken Sie möglicherweise unerwartete Formatierungsprobleme, die nach der Konvertierung behoben werden müssen.

Wie in der vorherigen Tabelle erwähnt, gibt es einige Einschränkungen für Formatkonvertierungen:

  • JSON kann nur verwendet werden, wenn eine Tabelle Teil des Nicht-SQL-Speichers ist (d. a. Log).
  • Spalten mit den Formaten des Typs emailbodyinternalextentdata können nicht in andere Formate konvertiert werden. Alle Versuche, diese Spalten zu konvertieren, werden ignoriert, und es wird keine Fehlermeldung bereitgestellt.
  • Sie können eine Spalte nicht in die Formate von emailbody, internalextentdata in andere Formate konvertieren. Wenn versucht wird, tritt ein Fehler auf.
  • "Datum allein kann nicht in DateTime konvertiert werden, aber Datum mit dem Verhalten von Benutzer lokal oder Zeitzonenunabhängig kann zu DateTime geändert werden."

Wenn Sie den Datentyp in ein inkompatibles Format ändern, wird der folgende Fehler angezeigt:

Das Format <<formatname>> ist für den Datentyp <<datatype>> der Spalte <<columnname>> der Tabelle <<tablename>> ungültig. Beispielsweise ist das Format "datetime" für die Texttypspalte ungültig.

Um das Format eines Datentyps zu ändern, müssen Sie die neuen Formatdetails zu einem OData-API-PUT-Aufruf hinzufügen:

PUT [Organization URI]/api/data/v9.0/EntityDefinitions(<<entity name>>)/Attributes(<<attribute name>>)
To set or change the format of a data type, you need to add the new format details into an OData API **POST** for a new column or **PUT** call to update an existing column:

> [!NOTE]
> For more samples on how to use the API, see https://github.com/microsoft/PowerApps-Samples

Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
{
 "AttributeType": \<\<Data type you are setting the format for\>\>,
 "AttributeTypeName": {
"Value": *\<\<Datatype Type\>\>*
},
"Description": {
"@odata.type": "Microsoft.Dynamics.CRM.Label",
"LocalizedLabels": [
{
"@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
"Label": *\<\<text label to use for the format\>\>*
"LanguageCode": 1033
}
]
},
"DisplayName": {
"@odata.type": "Microsoft.Dynamics.CRM.Label",
"LocalizedLabels": [
{
"@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
"Label": *\<\<text label to use for the format\>\>*
"LanguageCode": 1033
}
]
},
"RequiredLevel": {
"Value": "None",
"CanBeChanged": true,
"ManagedPropertyLogicalName": "canmodifyrequirementlevelsettings"
},
"SchemaName": *\<\<Your chosen schema name\>\>*
"@odata.type": "Microsoft.Dynamics.CRM.StringAttributeMetadata",
"FormatName": {
"Value": *\<\<Formatname value\>\>*
},
"MaxLength": 100
}

Spalten "Format" und "FormatName"
Formatüberprüfungen

  • Last updated on