Zum Inhalt springen

Funktionen im Jitterbit App Builder

Beim Schreiben von Ausdrücken (insbesondere beim Erstellen von Regeln) gibt es verschiedene Funktionen, die verwendet werden können, um Daten innerhalb des Ausdrucks zu verbinden, zu berechnen und anderweitig zu manipulieren. Diese Seite zeigt die derzeit verfügbaren Funktionen.

Hinweis

Beim Schreiben von Ausdrücken muss jede Zeichenfolge in einfache Anführungszeichen (' ') gesetzt werden, um als Text und nicht als Spaltenname oder Funktionsaufruf interpretiert zu werden. Zahlen, die berechnet werden sollen, benötigen keine Anführungszeichen.

Datenbankfunktionen

Datenbankfunktionen sind Funktionen, die in eine SQL-native Funktion übersetzt werden und daher vom Datenbank-Engine ausgewertet werden. Datenbankfunktionen haben Zugriff auf Informationen in der Datenebene, einschließlich Tabellen, Spalten und anderen Datenbankfunktionen.

Datenbankfunktionen werden hauptsächlich in der Geschäftlogik-Ebene konfiguriert, insbesondere im Spalten- oder Ausdrucksfeld, wenn die Logik für eine Geschäftsregel erstellt wird.

  • Abs: Gibt den Absolutwert einer Zahl zurück.
  • Average: Gibt den Durchschnitt (mathematisches Mittel) der Werte in einer Gruppe zurück. Ignoriert Nullwerte.
  • Cast: Konvertiert einen Ausdruck in einen anderen Datentyp.
  • Char: Konvertiert einen int ASCII-Code in einen Zeichenwert.
  • Concat: Gibt eine Zeichenfolge zurück, die das Ergebnis der Verkettung von zwei oder mehr Zeichenwerten ist (Leerzeichen manuell hinzufügen).
  • ConcatWithDash: Fügt den zweiten Parameter am Ende des ersten hinzu, getrennt durch einen Bindestrich.
  • ConcatWithParentheses: Fügt den zweiten Parameter am Ende des ersten in Klammern hinzu.
  • ContainsAlpha: Bestimmt, ob ein Ausdruck ein alphabetisches Zeichen (a-z) enthält. Gibt 1 oder 0 zurück.
  • Count: Gibt die Anzahl der Elemente in einer Gruppe zurück.
  • DateAdd: Fügt einem Datum eine bestimmte Anzahl von Tagen, Monaten oder Jahren hinzu.
  • DateDiff: Bestimmt, wie viel Zeit zwischen einem bestimmten Start- und Enddatum vergangen ist.
  • DateName: Gibt einen Teil eines Datums oder Datums-/Zeitwerts mit einer englischen Zeichenfolgenrepräsentation für Tage und Monate zurück.
  • DatePart: Gleich wie DateName, gibt jedoch die entsprechende Ganzzahl für einen Monat oder Tag zurück.
  • DenseRank: Nummeriert jede Zeile innerhalb einer Menge sequenziell, geordnet nach einer oder mehreren Spalten, beginnend bei 1. Diese Funktion erfordert den ORDER BY-Modifier und unterstützt auch den PARTITION BY-Modifier.
  • Differ: Überprüft, ob beide Argumente übereinstimmen. Wenn ja, gibt der App Builder eines von ihnen aus, wenn nicht, formatiert der App Builder es so, dass es wie Wert -----> Neuer Wert aussieht.
  • EscapeIfRequired: Entkommt einem Tabellen- oder Spaltennamen, falls erforderlich.
  • Expression: Ermöglicht dem Designer, seinen eigenen Funktionsausdruck für Aggregationen anzugeben.
  • FromOffSet: Gibt die Anzahl der Minuten für ein Offset-Argument zurück.
  • FromTimeZone: Konvertiert ein DATETIME in einer bestimmten Zeitzone in UTC.
  • GroupConcat: Ermöglicht das Aggregieren einer Zeichenfolgenspalte im Kontext einer Gruppierung, z. B. das Erstellen einer durch Kommas getrennten Liste.
  • HasFlag: Bewertet einen Ausdruck, um zu bestimmen, ob das Feld ein Flag hat.
  • IIF: Gibt einen von zwei Werten zurück, abhängig davon, ob der boolesche Ausdruck als wahr oder falsch ausgewertet wird.
  • IsNull: Gibt einen alternativen Wert für einen Null-Eintrag zurück oder NULL, wenn alle Argumente null sind.
  • IsNumeric: Gibt einen booleschen Wert zurück, der angibt, ob ein Ausdruck als Zahl ausgewertet werden kann.
  • Left: Gibt eine bestimmte Anzahl von Zeichen von der linken Seite einer bereitgestellten Zeichenfolge zurück.
  • Length: Gibt die Anzahl der Zeichen der angegebenen Zeichenfolge zurück, ohne nachfolgende Leerzeichen.
  • Lower: Gibt eine Kleinbuchstaben-Zeichenfolge zurück.
  • Lpad: Verursacht, dass eine Zeichenfolge eine bestimmte Länge hat.
  • Max: Gibt den größten Wert in einer gegebenen Liste zurück.
  • Min: Gibt den kleinsten Wert in einer gegebenen Liste zurück.
  • NewUUID: Generiert eine neue, zufällige UUID für jeden Eintrag in einer Tabelle.
  • Now: Gibt das aktuelle Datum und die aktuelle Uhrzeit zurück.
  • Null: Gibt einen Nullwert zurück Beispiel: IIF(Status='Delete',Null, Status)
  • Position: Findet die Position eines Teilstrings innerhalb einer Zeichenfolge.
  • Power: Gibt den Wert einer Zahl zurück, die auf eine andere erhoben wird, wobei beide Zahlen als Argumente übergeben werden.
  • Rank: Nummeriert jede Zeile innerhalb einer Menge sequenziell, geordnet nach einer oder mehreren Spalten, beginnend bei 1.
  • RowNumber: Nummeriert jede Zeile innerhalb einer Menge sequenziell, geordnet nach einer oder mehreren Spalten, beginnend bei 1. Diese Funktion erfordert den ORDER BY-Modifier und unterstützt auch den PARTITION BY-Modifier.
  • RemoveSpaces: Entfernt alle Leerzeichen aus einer Zeichenfolge.
  • Replace: Ersetzt alle Vorkommen eines bestimmten Zeichenfolgenwerts durch einen anderen Zeichenfolgenwert.
  • Right: Gibt eine bestimmte Anzahl von Zeichen von der rechten Seite einer bereitgestellten Zeichenfolge zurück.
  • Rj0: Verursacht, dass eine Zeichenfolge eine bestimmte Länge hat, indem der Anfang einer Zeichenfolge mit der Zahl 0 aufgefüllt wird.
  • Round: Rundet eine Zahl auf oder ab, wobei ein zweites Argument verwendet wird, um zu bestimmen, wie viele Stellen rechts (+) oder links (-) des Dezimalpunkts gerundet werden sollen.
  • Rpad: Gibt eine Kopie der Zeichenfolge zurück, die rechts auf die Gesamtanzahl der Zeichen, die das Längenargument angibt, aufgefüllt ist.
  • Sqrt: Gibt die Quadratwurzel einer Zahl zurück.
  • Substring: Zieht einen Teil einer Zeichenfolge heraus.
  • Sum: Gibt die Summe aller Werte zurück.
  • Timestamp: Nimmt eine Zeichenfolge, die eine Zeit und/oder ein Datum ist, und konvertiert sie in einen Zeitstempel.
  • ToOffSet: Gibt ein Offset für das Minutenargument zurück.
  • ToTimeZone: Konvertiert ein DATETIME in UTC in die angegebene Zeitzone.
  • Trim: Entfernt führende und nachfolgende Leerzeichen aus einer Zeichenfolge.
  • Type: Gibt Informationen über den Typ eines Ausdrucks zurück, ohne den Ausdruck selbst zu ändern.
  • Upper: Gibt einen Zeichen-Ausdruck mit in Großbuchstaben umgewandelten Kleinbuchstaben zurück.
  • UUID: Native Unterstützung für UUID, die sie über Anbieter hinweg standardisiert.
  • VisibilityOption: Bietet die Möglichkeit, benannte Sichtbarkeitswerte in einem Ausdruck zu verwenden.
  • Weekday: Gibt den Wochentag des Datums zurück.
  • Workday: Bewertet, ob ein bestimmtes Datum ein Arbeitstag ist.

Laufzeitfunktionen

Laufzeitfunktionen sind Funktionen, die zur Laufzeit ausgewertet werden, während Datenbankfunktionen in eine SQL-native Funktion übersetzt und vom Datenbank-Engine ausgewertet werden. Laufzeitfunktionen laufen in der Geschäftsschicht und können daher keine Informationen aus der Datenschicht referenzieren, wie z.B. Tabellenspalten und andere Datenbankfunktionen.

Laufzeitfunktionen können nicht mit Migrationsregeln verwendet werden. Migrationsregeln laufen in der Datenschicht, und Laufzeitfunktionen laufen zur Laufzeit. Zum Beispiel kann die Enum-Funktion nicht in einer Migrationsregel verwendet werden, da die Funktion nicht in der Lage ist, auf die Tabelle zuzugreifen und den erforderlichen PK zu Enum-String-Ersatz auszuführen.

Laufzeitfunktionen werden hauptsächlich in der Geschäftlogikschicht konfiguriert. Laufzeitfunktionen können im Spalten- oder Ausdrucksfeld verwendet werden, wenn die Logik für eine Geschäftsregel erstellt wird.

  • App: Gibt die Anwendungskennung als UUID zurück, in der das Ereignis ausgeführt wird.
  • Caller: Gibt den Wert der Spalte aus der Zeile zurück, die das Ereignis aufgerufen hat.
  • Changed : Meldet, ob ein Spaltenwert zu Beginn des Ereignisses geändert wurde.
  • Claim: Gibt einen Anspruch von einem Sicherheitsanbieter zurück.
  • Client: Gibt Clientinformationen wie IP-Adresse, Zeitzone, Zeitzonenoffset, Gebietsschema usw. zurück.
  • Enum: Ein benutzerdefinierter Datentyp, der aus ganzzahligen Konstanten besteht.
  • Event: Gibt Informationen über die aktuelle Ereignisausführung zurück.
  • Generated: Ruft einen generierten Wert während des Ereignisses durch die Geschäfts-Engine ab.
  • Memory: Gibt den Wert der Spalte aus der Shared()-Funktion zurück, falls vorhanden, andernfalls aus der Caller()-Funktion.
  • Page: Gibt die Seiten-ID zurück.
  • RandomBytes: Generiert zufällige Bytes auf dem Server und gibt sie als Hex-String zurück.
  • Recipient: Gibt eine URN zurück, die ein Objekt als Empfänger einer Benachrichtigung identifiziert.
  • Realm: Gibt die Kennung des Sicherheitsbereichs zurück, in dem das Ereignis ausgeführt wird.
  • Role: Bestimmt, ob der aktuelle Benutzer Mitglied einer bestimmten Rolle ist.
  • Session: Gibt die Kennung für die Sitzung des aktuellen Benutzers zurück.
  • Shared: Gibt die Kriterien für den gemeinsamen Link zurück.
  • Version: Bietet Zugriff auf die aktuellen Versionsinformationen des App Builders.
  • Who: Gibt Informationen über den angemeldeten Benutzer basierend auf dem angegebenen Parameter zurück.