Enum() mvSQL- Laufzeit im Jitterbit App Builder

Zusammenfassung

Die Enum-Funktion im App Builder ersetzt den Primärschlüssel durch den Enum-Ausdruck. Die Enum-Funktion kann nur zum Nachschlagen von Werten in Tabellen verwendet werden, für die ein einziger Primärschlüssel (maximal ein PK) definiert ist und eine ihrer Spalten als Enum-Verwendungstyp gekennzeichnet ist.

Ein ENUM ist ein Zeichenfolgenobjekt mit einem Wert aus einer Liste zulässiger Werte, die bei der Tabellenerstellung explizit in der Spaltenspezifikation aufgeführt werden. Die Enum-Funktion im App Builder kann verwendet werden, um die in der Business-Logik-Schicht erstellten Regeln lesbar zu halten. Die Verwendung von Enum im App Builder ist nützlich, wenn mehrere Personen an Apps arbeiten, um das Verständnis der Regeln zu erleichtern.

Wenn die Enumerationsfunktion in mvSQL in einer Where-Klausel oder einer IIF-Anweisung verwendet wird, zeigt das resultierende SQL-Panel im Business-SQL-Bildschirm für die Regel die UUID des Primärschlüsselwerts (aus der Tabelle, in der sich die Enumerationsspalte befindet) an. Dies kann hilfreich sein, um zu bestätigen, dass die Regel die korrekten Daten ersetzt.

Hinweis

Die Enumerationsfunktion kann nicht in Migrationsregeln verwendet werden.

Damit die Funktion ordnungsgemäß funktioniert, müssen Sie die Enumerationsspaltendaten ausfüllen (entweder in der Business-Logik-Schicht oder in der Anwendungs-UI-Schicht).

Syntax

enum(<LookupTableName>,'<EnumValue>')

Beispiel für die Verwendung von Enumerationen in einer Where-Klausel mit mehreren Werten:

TableID IN (Enum(LookupTableName, 'EnumValue'), Enum(LookupTableName, 'EnumValue'), Enum(LookupTableName, 'EnumValue'), ...)

Parameter

Nachschlagetabellenname

Der Name der Tabelle, in der wir den Aufzählungswert suchen.

Enumerationswert

Der Wert in der Spalte „Aufzählungstyp“. Dies sollte eine Zeichenfolge sein.

Rückgaben

Der Primärschlüssel wird zur Laufzeit durch den Enumerationswert ersetzt, der in der Nachschlagetabelle gesucht wird. Der Typ, durch den er ersetzt wird, hängt vom Typ des Primärschlüssels der untersuchten Nachschlagetabelle ab.

Bemerkungen

Die Enumerationsfunktion wird typischerweise in der Where-Klausel verwendet, kann aber auch in anderen Teilen der mvSQL-Anweisung verwendet werden.

Beispiele

Beispiel 1

In diesem Beispiel wird Enum in der Statustabelle verwendet, anschließend einer bestehenden Geschäftslogikregel (dem Statusobjekt (Quelle)) hinzugefügt und anschließend in der Anwendungsoberfläche im Status-Mehrzeilenbereich angezeigt.

1. Fügen Sie die Spalte Enum zur Statustabelle hinzu, setzen Sie den logischen Datentyp auf String und die Verwendung auf Enum.

   

2. Klicken Sie auf die Schaltfläche Ergebnisse für die Statustabelle und geben Sie die Werte für die Enumerationsspalte an.

3. Sie können entweder eine neue Regel erstellen, um den Enumerationswert zu nutzen, oder eine bestehende ändern. In diesem Beispiel fügen wir die Spalte Enumeration zur bestehenden Regel Status (Quelle) hinzu.

   

4. Nachdem die Enumerationsspalte einer Regel hinzugefügt wurde, können wir sie in die Anwendungs-UI-Ebene einfügen und dort anzeigen. Hier fügen wir sie als Steuerelement zum mehrzeiligen Status-Panel hinzu:

   

Beispiel 2

In diesem Beispiel wird Enum in der Tabelle „EmployeeType“ verwendet und anschließend mithilfe der Enum-Funktion in einer Where-Klausel (in mvSQL) einer neuen Regel hinzugefügt.

1. Fügen Sie die Spalte Enum zur Tabelle „EmployeeType“ hinzu und setzen Sie den logischen Datentyp auf String und die Verwendung auf Enum.

   

2. Klicken Sie auf die Schaltfläche Ergebnisse für die Tabelle „EmployeeType“ und geben Sie die Werte für die Spalte „Enum“ an. Alternativ können Sie eine Konfigurationsseite in der App einrichten, auf der Benutzer diese Werte festlegen können, oder die Spalte als Steuerelement in der Anwendungsoberfläche bereitstellen und die Daten dort eingeben.

   

3. Sie können die Enumerationsfunktion auf eine bestehende Regel anwenden. In diesem Beispiel erstellen wir jedoch eine neue Regel für die Tabelle „Mitarbeiter“.

   

4. In der Regel fügen wir die Enum-Funktion einer Where-Klausel im mvSQL-Fenster hinzu.

   

Beispiel Nr. 3

Enum(EmployeeTypeLookup, 'Fulltime')Gibt den Primärschlüssel der EmployeeTypeLookupTable zurück. Beispiel:

'17457c85-b0c9-4d45-8681-5ee566429ddd'

Die typische Verwendung in einer mvSQL-Anweisung lautet:

select * from Employee where EmployeeTypeId = enum(EmployeeTypeLookup,'Fulltime')

statt:

select * from Employee where EmployeeTypeId = '17457c85-b0c9-4d45-8681-5ee566429ddd'