Zum Inhalt springen

Caller() mvSQL-Laufzeitfunktion im Jitterbit App Builder

Zusammenfassung

Die Spalten der aktuellen Zeile können den nachgelagerten Datenobjekten zur Verfügung gestellt werden. Diese Funktion kann dann an mehreren Stellen auf diese Werte zugreifen.

Caller() kann in Ausdrücken in CRUD-Regeln innerhalb von Ereignissen, Erfolgsbehandlern oder Fehlerbehandlern verwendet werden. Wenn die Caller()-Funktion in einem Erfolgs- oder Fehlerbehandler verwendet wird, sucht die Aktion nach einem bestimmten Feld aus der Aktionsregel, von der sie ausgeführt wird. Wenn die Caller()-Funktion in einer Aktionsregel verwendet wird, betrachtet sie die Feldwerte aus dem Datensatz des Geschäftobjekts, auf dem das Ereignis ausgeführt wird (siehe Beispiele).

Laufzeitfunktionen können mehr als einen String zurückgeben, wenn ein Typparameter angegeben ist.

Hinweis

Diese mvSQL-Funktion funktioniert nur mit CRUD-Regeln und nicht mit anderen Datenobjekten.

Syntax

CALLER(<name> [, <datatype> ])

Parameter

Name

Ein String, der den Namen der angeforderten Kriterien darstellt.

Datentyp

Datentyp, String ist standardmäßig, optional. Unterstützte Datentypen:

  • String (Standard)
  • Numeric
  • UUID
  • Boolean
  • DateTime

Hinweis

Der Parameter datatype ist standardmäßig optional. Wenn die Option Require Function Type Parameter in den Erweiterten Einstellungen der Datenquelle aktiviert ist, wird der Parameter erforderlich. Dies ist nützlich, wenn Anwendungen über verschiedene Datenbanktypen hinweg bereitgestellt werden.

Rückgabewert

Ein Wert des Datentyps datatype oder NULL, wenn name auf eine nicht verfügbare Spalte verweist.

Beispiele

Beispiel, das eine andere Tabelle anvisiert

  • Eine Zeile aus der Kundentabelle hat ein Großbuchstabenereignis, das eine andere Tabelle anvisiert.

Diese Regel könnte erstellt werden:

SELECT UPPER(CALLER('CustomerName')) as UppercasedName FROM CustomerArchive
Die zur Laufzeit ausgewertet wird zu:

SELECT UPPER('John Doe') as UppercasedName FROM CustomerArchive

Beispielverwendung mit Erfolgsbehandler

  • Das Geschäftsobjekt 123 hat ein Ereignis namens event.
  • event hat eine Regeltyp-Aktion mit der Regel abc.
  • abc hat ein Erfolgsbehandler-Ereignis, bei dem die Aktion des Regeltyps die Regel def hat.
  • def hat einen Ausdruck Caller('uuid').
  • Caller('uuid') zielt auf den PK der Zieltabelle für def mit bind als Zieltyp.
  • uuid aus Caller('uuid') existiert nur namentlich in abc, nicht im Geschäftsobjekt 123.
  • Im entsprechenden Szenario wird der Erfolgsbehandler ausgelöst und aktualisiert erfolgreich den entsprechenden Datensatz in der Zieltabelle von def gemäß der Regel.