Ausdrücke

Bei der Verarbeitung von Datenaustauschdefinitionen können Sie neben XML-Knoten und Konstanten auch Ausdrücke verwenden, um einfache Rechenoperationen (mit Zahlen, Texten, Datumswerten und Ähnlichem) auf den importierten Spaltenwerten durchzuführen. Grundlegende Informationen zum Einrichten von Datenaustauschdefinitionen finden Sie unter Datenaustauschdefinitionen einrichten.

So richten Sie die Funktionalität für das Feld "Ausdruck" ein

  1. Klicken Sie im Menüband Dynamics 365 Business Central auf das Symbol Lupe ( Alt+Q), geben Sie im Suchfeld Datenaustauschdefinitionen ein und bestätigen Sie das übereinstimmende Suchergebnis mit der Eingabetaste.
  2. Klicken Sie in das Feld Code, um eine Datenaustauschdefinition zu öffnen.
  3. Klicken Sie im Inforegister Allgemein in das Feld Art und wählen Sie eine Option aus: Generischer Import oder VEO Export.

  4. Geben Sie im Feld Lese-/Schreibe-Codeunit einen Wert ein:

    • 5153106 für die Art Generischer Import

    • 5561710 für die Art VEO Export

      Hinweis

      Die Codeunit 5153106 unterstützt derzeit keine Namespaces beim Import der XML-Daten.

So verwenden Sie das Feld "Ausdruck"

Das Feld Ausdruck finden Sie auf der Seite Datenaustauschdefinitionen im Inforegister Spaltendefinitionen.

Für Ausdrücke gilt eine eingeschränkte Syntax:

  • Überflüssige Leerzeichen werden ignoriert (zum Beispiel wird NetAmount* 1.19 zu NetAmount*1.19).
  • Für die Klammersetzung werden runde Klammern verwendet (zum Beispiel NetAmount*((100.0+"VAT %")/100.0)).
  • Funktionsparameter werden durch ein Komma getrennt und in Klammern übergeben (zum Beispiel IIF(Name<>'', Name, "Name 2")).
  • Bei Funktionsaufrufen ohne Parameter müssen Klammern mitgegeben werden (zum Beispiel TODAY()).

Spaltenzugriff

Auf die Spalten im Inforegister Spaltendefinitionen können Sie über das Feld Name zugreifen. Falls Leerzeichen im Feld Name enthalten sind, muss der Name in Anführungszeichen eingeschlossen sein (zum Beispiel "Name 2").

Beispiel:
Der Ausdruck Name + '.' + "Name 2" + '@' + EMail liefert einen Text der Form 'Vorname.Nachname@EMailProvider.de' zurück.

Hinweis

Die Groß- und Kleinschreibung wird beim Spaltenzugriff berücksichtigt.

Konstanten

  • Texteingaben werden zum Verketten in Hochkommas (') eingeschlossen (zum Beispiel Name + '.' + Email).
  • Wahrheitswerte werden mit 'true' und 'false' dargestellt (zum Beispiel IIF(Name <> '', true, false)).
  • Dezimalzahlen werden mit einem Punkt (.) als Dezimaltrenner angegeben (zum Beispiel NetAmount* 1.19).
  • Datumswerte werden im Format yyyymmdd mit dem Suffix D angegeben (zum Beispiel 20231231D).

Rechenoperatoren

  • Addition: a + b
  • Subtraktion: a - b
  • Multiplikation: a * b
  • Division: a / b
  • Potenz: a ^ b

Vergleichsoperatoren

  • Kleiner gleich: <=
  • Kleiner: <
  • Größer gleich: >=
  • Größer: >
  • Ungleich: <>, !=
  • Gleich: =
Hinweis

Vergleichsoperationen werden immer zu einem Wahrheitswert (true / false) ausgewertet.

Logische Operatoren

  • UND: a AND b
  • ODER: a OR b

Funktionen

Funktion Beschreibung Beispiel
IIF(expr, arg2, arg3) Gibt einen von zwei Werten zurück, abhängig davon, ob expr true (arg2) oder *false *(arg3) ergibt. IIF(3>2, 3, 2)
Ergebnis: 2
TODAY() Gibt das aktuelle Datum zurück. TODAY()
Ergebnis: 20240312D
TIME() Gibt die aktuelle Uhrzeit zurück.
CurrentDateTime() Gibt den aktuellen Zeitstempel (Uhrzeit + Datum) zurück.
CompanyName() Gibt den aktuellen Mandantennamen zurück.
UserId() Gibt den aktuellen UserId zurück.
UserSecurityId() Gibt den aktuellen UserSecurityId/UserSID zurück.
SessionId() Gibt den aktuellen SessionId zurück.
TenantId() Gibt den aktuellen TenantId zurück.

Funktionen zur Textbearbeitung

Funktion Beschreibung Beispiel
FORMAT(arg) Wandelt den Parameter in einen Text um. FORMAT(20231231D) -> '31.12.2023'
STRPOS(String, SubStringText) Die Funktion STRPOS sucht in einer Zeichenkette (String) nach einer Zeichenkette (SubString) und liefert die Position des ersten Vorkommens der Suchkette in der Zeichenkette. STRPOS('Test','e') -> 2
SELECTSTR(Number, CommaString[, Separator]) Die Funktion SELECTSTR liefert aus einer Zeichenkette (CommaString) einen durch das Separator-Zeichen (oder Komma, falls kein Separator angegeben wurde) getrennten Teilstring (NewString). SELECTSTR(2,'MÖBEL-MÜLLER KG,Tischlerstr. 4-10,40593,Düsseldorf') -> 'Tischlerstr. 4-10'
COPYSTR(String, Position [, Length]) Die Funktion COPYSTR gibt einen Teil der Zeichenkette (String) zurück. Sie beginnt bei „Position” und hat die angegebene Länge (Length). COPYSTR('Test',3) -> 'st'
CONVERTSTR(String, FromCharacters, ToCharacters) Die Funktion CONVERTSTR tauscht aus einem Text (String) bestimmte Zeichen (FromCharacters) durch neue Zeichen (ToCharacters) aus. CONVERTSTR('TEST STRING','TES','tes') -> 'test stRING'
DELCHR(String[, Where][, Which]) Die Funktion DELCHR entfernt ein oder mehrere Zeichen (Which) in einem String und gibt den neuen String (NewString) zurück. DELCHR('Dies ist ein Teststring','=') -> 'Dieistein Teststring'
DELCHR('Dies ist ein Teststring','<>', 'Dg') -> 'ies ist ein Teststrin'
DELCHR('Dies ist ein Teststring','>', 'Rdng') -> 'ies ist ein Teststri'
DELSTR(String, Position[, Length]) Die Funktion DELSTR entfernt aus einer Zeichenkette (String) ab einer Position (Position) den Rest der Zeichenkette. DELSTR('Dies ist ein Test!',5,4) -> 'Dies ein Test'
INSSTR(String, SubString, Position) Die Funktion INSSTR fügt in einer Zeichenkette (String) eine Teilzeichenkette (SubString) an einer angegebene Position (Position) ein. INSSTR('Dies ist ein Test!','k',10) -> 'Dies ist kein Test!'
STRLEN(String) Die Funktion STRLEN gibt die Anzahl (Length) der Zeichen einer Zeichenkette (String) zurück. STRLEN('Test') -> 4
UPPERCASE(String) Die Funktion UPPERCASE wandelt den Inhalt einer Zeichenkette (String) in Großbuchstaben um. UPPERCASE('Test String') -> 'TEST STRING'
LOWERCASE(String) Die Funktion LOWERCASE wandelt den Inhalt einer Zeichenkette (String) in Kleinbuchstaben um. LOWERCASE('Test String') -> 'test string'
Hinweis

Unterschiede in der Groß- und Kleinschreibung werden bei Funktionsnamen ignoriert.

Tabellenzugriff

Ausdruck Beschreibung
@Tablename(key[, key, ...]) Gibt den Wert des Feldes Field in der BC-Tabelle Tablename mit dem Datensatzschlüssel key zurück.
@Location('HAUPT').Name Gibt den Wert des Feldes Name des Datensatzes aus der Tabelle Location (mit Schlüssel 'HAUPT') zurück.

Beispiele

Ausdruck Ergebnis (Beispiel) Beschreibung
Today() 20240312D Erstellt das aktuelle Datum.
Today()+1 20240313D Erstellt das Folgedatum zum aktuellen Datum.
20240215D + 1 20240216D Erstellt das Folgedatum für ein bestimmtes Datum (zum Beispiel 15.02.2024).
20240106D -20240101D 5 Gibt die Differenz zwischen zwei Datumswerten in Tagen an.
Name Peter Gibt den Wert der Spalte Name zurück.
Name +'.'+"Name 2" Peter.Meier Die Werte der Spalten Name und Name 2 werden mit dem Pluszeichen (+) und einem Punkt (.) aneinandergehängt.
IIF(3>2, 3, 2) 3 Da 3>2 wahr ist, wird 3 zurückgegeben.
IIF(3<2, 3, 2) 2 Da 3<2 falsch ist, wird 2 zurückgegeben.
IIF(DueDate < Today(), Today(), DueDate) 20240312D Gibt den späteren der beiden Datumswerte zurück.
NetAmount 100.0 Gibt den Wert der Spalte NetAmount zurück.
NetAmount*1.19 119.0 Der Wert in der Spalte NetAmount wird mit 1.19 multipliziert.
@Location('HAUPT').Name Hauptlagerort Holt den Datensatz mit dem Schlüssel 'HAUPT' aus der BC-Tabelle Location und liefert von diesem Datensatz den Wert des Feldes Name zurück.
@Company().FindFirst().Name CRONUS DE Gibt den Mandantennamen des ersten Datensatzes des aktuellen Mandanten zurück.

Siehe auch

Datenaustauschdefinitionen einrichten