Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Dieser Artikel enthält Informationen zu den primitiven Datentypen, die in Ausdrücken für die elektronische Berichterstellung (EB) unterstützt werden. Hier ist eine Liste der Typen der primitiven Daten:
Aktiv
Der primitive Datentyp boolean enthält einen Wert, der entweder als wahr oder falsch bewertet wird. Sie können die reservierten Literalschlüsselwörter Wahr und Falsch überall verwenden, wo ein boolescher Ausdruck erwartet wird. Der Standardwert ist Falsch.
Die interne Darstellung eines boolean ist eine Integer. Der Ganzzahl-Wert 0 (Null) wird als falsch bewertet, und alle anderen Ganzzahl-Werte werden als wahr bewertet. Wenn Sie einen konfigurierten Ausdruck bestätigen, der einen boolean im EB-Formeldesigner zurückgibt, präsentiert das Testergebnisfenster 0 (null), wenn ein Ausdruck falsch zurückgibt. Andernfalls wird im Testergebnisbereich 1 angezeigt.
Ein boolean hat keine impliziten Konvertierungen. Sie können jedoch die Funktion TEXT zum expliziten Konvertieren von boolean zu einer Zeichenfolge:
- Der falsche Wert wird in die Textzeichenfolge Falsch umgewandelt.
- Der wahre Wert wird in die Textzeichenfolge Wahr umgewandelt.
Notiz
Diese Konvertierung hängt nicht vom Kontext der bereitgestellten Sprache und Kultur ab.
Vergleichsoperatoren sind der einzige Operatortyp, der mit demDatentyp boolean verwendet werden kann. Die folgenden Operatoren können verwendet werden, um zwei boolesche Werte zu vergleichen: <> und =.
Date
Der primitive Datentyp Datum enthält Tag, Monat und Jahr. Daten können mit folgenden Funktionen initiiert werden:
Der Datentyp Datum kann Daten zwischen dem 1. Januar 1900 und dem 31. Dezember 2154 enthalten. Der Standardwert ist Null, und die interne Darstellung ist das Datum 1. Januar 1900.
Ein Datum hat keine impliziten Konvertierungen. Sie können jedoch die folgenden expliziten Konvertierungsfunktionen verwenden:
Mit der ADDDAYS-Funktion können Sie Tage von Datumsangaben hinzufügen und davon subtrahieren. Auf diese Weise können Sie das Datum um eine bestimmte Anzahl von Tagen in die Zukunft und in die Vergangenheit verschieben. Mit der DAYS-Funktion können Sie Daten voneinander subtrahieren und die Differenz in Tagen berechnen. Weitere Informationen zur Transformation von Datumswerten, siehe Liste der EB-Funktionen in der Katgorie „Datum und Uhrzeit“.
Vergleichsoperatoren sind der einzige Operatortyp, der mit dem Datentyp Datum verwendet werden kann. Die folgenden Operatoren können verwendet werden, um zwei Datumswerte zu vergleichen: <>, <, <und =. = > und >
Datetime
Der primitive Datentyp datetime kombiniert den Typ Datum und einen Wert, der die seit Mitternacht vergangene Zeit darstellt. Die Zeit wird in Stunden, Minuten, Sekunden und Sekundenbruchteilen angegeben. Ein datetime-Wert enthält auch Informationen über die Zeitzone.
Der Datentyp datetime kann Daten zwischen dem 1. Januar 1900 (1900-01-01T00:00:00.0000000+00:00 im Round-Trip-Format) und 31. Dezember, 2154 (2154/12/31T11:59:59.9999999+00:00 im Round-Trip-Format) enthalten. Die kleinste Zeiteinheit in einer datetime ist eine Zehnmillionstelsekunde.
Notiz
Wenn der HH-Bezeichner für Stunden verwendet wird, können Zeitwerte über 12:59:59:9999999 nicht als gültige Zeiten interpretiert werden.
Wenn der HH-Bezeichner für Stunden verwendet wird, können Zeitwerte über 23:59:59:9999999 nicht als gültige Zeiten interpretiert werden.
Der Standardwert ist Null, und die interne Darstellung ist das Datum 1. Januar 1900 (1900-01-01T00:00:00.0000000+00:00 im Roundtrip-Format).
Datetimes können mit folgenden Funktionen initiiert werden:
Ein datetime hat keine impliziten Konvertierungen. Sie können jedoch die folgenden expliziten Konvertierungsfunktionen verwenden:
Weitere Informationen zur Transformation von datetime-Werten, siehe Liste der EB-Funktionen in der Katgorie „Datum und Uhrzeit“.
Vergleichsoperatoren sind der einzige Operatortyp, der mit dem Datentyp datetime verwendet werden kann. Die folgenden Operatoren können verwendet werden, um zwei datetime-Werte zu vergleichen: <>, <, <=, =, >, und >=..
Aufzählung
Der primitive Datentyp Enumeration ist eine Liste von Literalen. Sie können Aufzählungen verwenden, die in der Anwendung Quellcode definiert sind. Sie können auch Ihre eigenen Aufzählungen in die Komponenten EB-Datenmodell und EB-Format einführen.
Eine Anwendung Enumeration kann in Ausdrücken jedes EB-Modell-Mappings und EB-Formats verwendet werden.
Die folgende Abbildung zeigt, wie Sie die Modellenumeration CustVendCorrectiveReasonCode zum bearbeitbaren EB-Datenmodell hinzufügen.
Eine Modellenumeration kann in Ausdrücken aller EB-Modellzuordnungen und EB-Formate verwendet werden, die unter einem Datenmodell erstellt wurden, in dem die Enumeration wurde vorgestellt.
Die folgende Abbildung zeigt, wie Sie die Formatenumeration Liste der Natura-Verlagerungsunterkategorien in das bearbeitbare ER-Format.
Eine Formatenumeration kann nur in Ausdrücken des EB-Formats verwendet werden, in denen die Enumeration wurde vorgestellt.
Sie müssen den entsprechenden Typ von EB-Datenquellen verwenden, um eine bestimmte Enumeration als Konstante oder als Wert, den der Benutzer, der eine EB-Lösung ausführt, im Dialogfeld zur Laufzeit definiert hat, in eine konfigurierte EB-Komponente zu bringen.
Auf Anwendungsenumeration kann zugegriffen werden, indem Sie die Datenquellen Dynamics 365 for Operations \ Aufzählung und Allgemein \ Benutzereingabeparameter Datenquellen verwenden. Die folgende Abbildung zeigt, wie Sie dem bearbeitbaren EB-Format die Datenquellen BlinddarmNeinJa und uipNeinJa hinzufügen, die sich auf die Anwendungsenumeration NoYes beziehen.
Auf Datenmodellenumeration kann zugegriffen werden, indem Sie die Datenquellen Datenmodell \ Enumeration und Datenmodell \ Enumerationsbenutzereingabeparameter verwenden. Die folgende Abbildung zeigt, wie Sie dem bearbeitbaren EB-Format die Datenquelle CustVendCorrectiveReasonCode hinzufügen, die sich auf die Anwendungsenumeration CustVendCorrectiveReasonCode bezieht.
Auf Formatenumeration kann zugegriffen werden, indem Sie die Datenquellen Format \ Enumeration und Format \ Enumerationsbenutzereingabeparameter verwenden. Die folgende Abbildung zeigt, wie Sie dem bearbeitbaren EB-Format die Datenquelle NaturaReverseCharge hinzufügen, die sich auf die Formatenumeration Natura-Verlagerungsunterkategorien bezieht.
Eine Enumeration hat keine impliziten Konvertierungen. Sie können jedoch die Konvertierungsfunktion TEXT zum Konvertieren einer Enumeration zu einer Textzeichenfolge. Diese Konvertierung ist nicht sprachabhängig. Informationen dazu, wie Sie einen Enumerationswert einem entsprechenden sprachspezifischen Label zuordnen können, finden Sie in den Verwendungsbeispielen für die Funktionen LISTOFFFIELDS und GETENUMVALUEBYNAME.
Vergleichsoperatoren sind der einzige Operatortyp, der mit dem Datentyp Enumeration verwendet werden kann. Die folgenden Operatoren können verwendet werden, um zwei Enumerationswerte zu vergleichen: <> und =.
Guid
Der primitive Datentyp guid enthält einen Global Unique Identifier (GUID)-Wert. Eine GUID ist ein Wert, der auf allen Computern und Netzwerken verwendet werden kann, wo immer eine eindeutige Kennung erforderlich ist. Es ist unwahrscheinlich, dass die Nummer verdoppelt wird. Eine gültige GUID erfüllt alle folgenden Spezifikationen:
- Es müssen 32 hexadezimale Ziffern vorhanden sein.
- Darüber hinaus müssen vier Bindestriche an den folgenden Stellen eingebettet sein: 8-4-4-4-12.
- Zusätzlich können optionale Klammern {} am Anfang und Ende der Zeichenfolge hinzugefügt werden. Beispielsweise sind sowohl {2CDB0FE7-D7B3-4938-A0F0-FE28FB8FE212} als auch 2CDB0FE7-D7B3-4938-A0F0-FE28FB8FE212 gültige GUID-Zeichenfolgen.
- Daher müssen insgesamt 36 oder 38 Zeichen vorhanden sein, je nachdem, ob geschweifte Klammern hinzugefügt werden.
- Die als Hexadezimalziffern verwendeten Buchstaben können Großbuchstaben (A–F), Kleinbuchstaben (a–f) oder gemischt sein.
Sie können die folgenden expliziten Konvertierungsfunktionen verwenden:
Vergleichsoperatoren sind der einzige Operatortyp, der mit dem Datentyp guid verwendet werden kann. Die folgenden Operatoren können verwendet werden, um zwei guid-Werte zu vergleichen: <> und =.
Ganzzahl
Der primitive Datentyp Ganzzahl stellt eine Zahl dar, die keine Dezimalstellen hat. Ganzzahlen werden als Kontrollvariablen in sich wiederholenden Anweisungen oder als Indizes in Datensatzlisten verwendet.
Ein Ganzzahl ist die ganze Zahl, wie sie direkt in einen EB-Ausdruck (Formel) eingegeben wird, wie zum Beispiel 12345. Ein Ganzzahl ist 32 Bit breit. Der Standardwert ist 0, und die interne Darstellung ist eine lange Zahl. Eine Ganzzahl wird automatisch in eine echte umgewandelt.
Zusätzlich können die folgenden expliziten Konvertierungsfunktionen verwendet werden:
Der Bereich einer Ganzzahl ist [-2,147,483,647: 2,147,483,647]. Alle ganzen Zahlen dieses Bereichs können als Literale verwendet werden.
Alle Vergleiche und mathematischen Operatoren kann mit dem Datentyp Ganzzahl verwendet werden.
Int64
Der primitive Datentyp int64 stellt eine Zahl dar, die keine Dezimalstellen hat. Int64-Werte werden als Kontrollvariablen in sich wiederholenden Anweisungen oder als Datensatzbezeichner verwendet.
Ein int64 ist 64 Bit breit. Der Standardwert ist 0, und die interne Darstellung ist eine lange Zahl. Ein int64 wird automatisch in eine echte umgewandelt.
Zusätzlich können die folgenden expliziten Konvertierungsfunktionen verwendet werden:
Der Bereich einer int64 ist [-9,223,372,036,854,775,807: 9,223,372,036,854,775,807].
Alle Vergleiche und mathematischen Operatoren kann mit dem Datentyp int64 verwendet werden.
Gleitkommazahl
Der primitive Datentyp echt kann neben ganzen Zahlen auch Dezimalwerte enthalten. Sie können Dezimalliterale überall verwenden, wo ein echter erwartet wird. Ein Dezimalliteral ist die Dezimalzahl, wie sie direkt im Code eingegeben wird, wie z. B. 2.19.
Notiz
In EB-Ausdrücken wird immer ein Punkt (.) als Dezimaltrennzeichen verwendet.
Reelle Zahlen können in allen Ausdrücken verwendet werden, und sie können sowohl mit Vergleichs- als auch mit arithmetischen Operatoren verwendet werden. Eine echte hat eine Genauigkeit von 16 signifikanten Stellen. Der Standardwert für eine echte ist 0.0, und die interne Darstellung ist eine binär codierte digitale (BCD) Zahl. Die BCD-Codierung ermöglicht exakte Darstellungen von Werten, die Vielfache von 0,1 sind. Die Reichweite von einer echten Variable ist -(10)127 bis (10)127. Alle reellen Zahlen in diesem Bereich können als Literale in EB-Ausdrücken verwendet werden.
Eine echte hat keine impliziten Konvertierungen. Sie können jedoch die folgenden Funktionen verwenden, um eine echte zu anderen Datentypen und anderen Datentypen zu einer echten signifikant umzuwandeln:
Alle Vergleiche und mathematischen Operatoren kann mit dem Datentyp echt verwendet werden.
String
Der primitive Datentyp Zeichenfolge stellt eine Folge von Zeichen dar, die als Texte, Kontonummern, Adressen und Telefonnummern verwendet werden.
Zeichenfolgenliterale sind Zeichen, die in Anführungszeichen („“) eingeschlossen sind. Zeichenfolgeliterale können überall verwendet werden, wo Zeichenfolgewerte in EB-Ausdrücken erwartet werden. Sie können Zeichenfolgen in logischen Ausdrücken verwenden, z. B. in Vergleichen. Sie können auch Zeichenfolgewerte verketten, indem Sie den & Operator oder die CONCATENATE Funktion verwenden.
Notiz
Wenn Sie zwei Zeichenfolgewerte verketten, und Sie wollen, dass die resultierende Zeichenfolge mehr als eine Zeile umfassent, verwenden Sie das Zeilenumbruchtrennzeichen zwischen den Werten. Für die TEXT-Ausgabe kann dieses Trennzeichen ein Zeichen sein, das mit dem Ausdruck CHAR(10) oder CHAR(13) generiert wird. Für HTML kann es das Tag <br> sein.
Der Standardwert für eine Zeichenfolge ist eine leere Textzeichenfolge ohne Zeichen, und die interne Darstellung ist eine Liste von Zeichen.
Es gibt keine automatischen Konvertierungen für Strings. Sie können jedoch die folgenden expliziten Konvertierungsfunktionen verwenden:
Weitere Informationen zur Transformation von Zeichenfolgewerten, siehe Liste der EB-Funktionen der Listenkategorie.
Eine Zeichenfolge kann eine unbestimmte Anzahl von Zeichen enthalten.
Alle Vergleiche und mathematischen Operatoren kann mit dem Datentyp Zeichenfolge verwendet werden.