Enum() mvSQL- Laufzeit im Jitterbit App Builder

Zusammenfassung

Die Enum-Funktion in App Builder ersetzt den Primärschlüssel durch den Enumerationsausdruck. Die Enumerationsfunktion kann nur verwendet werden, um Werte in Tabellen nachzuschlagen, die einen einzigen Primärschlüssel definiert haben (nicht mehr als einen PK) und deren Spalten als Enumerationstyp markiert sind.

Ein ENUM ist ein Zeichenfolgenobjekt mit einem Wert, der aus einer Liste zulässiger Werte ausgewählt wird, die bei der Tabellenerstellung explizit in der Spaltenspezifikation aufgelistet werden. Die Enumerationsfunktion in App Builder kann verwendet werden, um Regeln, die in der Business-Logik-Schicht erstellt werden, für den Menschen lesbar zu halten. Die Verwendung von Enum in App Builder ist nützlich, wenn Sie Apps erstellen, an denen mehrere Personen arbeiten, um das Verständnis der Regeln zu vereinfachen.

Wenn die Enumerationsfunktion in mvSQL entweder in einer Where-Klausel oder einer IIF-Anweisung verwendet wird, zeigt das resultierende SQL-Panel auf dem Business-SQL-Bildschirm für die Regel den Primärschlüsselwert UUID an (aus der Tabelle, in der sich die Enumerationsspalte befindet). Dies kann nützlich sein, wenn Sie bestätigen möchten, dass die Regel die richtigen Daten ersetzt.

Syntax

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

Beispiel für die Verwendung von Enum 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 aufgezählten Wert nachschlagen werden.

Aufzählungswert

Der Wert in der Spalte mit dem 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.

Hinweise

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

Beispiele

Beispiel Nr. 1

In diesem Beispiel wird Enum in der Statustabelle verwendet, dann zu einer vorhandenen Geschäftslogikregel (dem Statusobjekt (Quelle)) hinzugefügt und dann der Anwendungsbenutzeroberfläche im Status-Mehrzeilenbereich angezeigt.

1. Fügen Sie der Statustabelle die Spalte Enum 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 vorhandene ändern. In diesem Beispiel fügen wir die Spalte Enumeration zur vorhandenen Regel Status (Quelle) hinzu.

   

4. Wenn die Enumerationsspalte einer Regel hinzugefügt wurde, können wir sie zur Anwendungs-UI-Ebene hinzufügen, um sie dort anzuzeigen. Hier fügen wir sie als Steuerelement zum Status-Mehrzeilen-Panel hinzu:

   

Beispiel Nr. 2

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

1. Fügen Sie die Spalte Enum zur EmployeeType-Tabelle hinzu, 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 angeben können, oder die Spalte als Steuerelement für die Anwendungs-UI verfügbar machen und die Daten dort eingeben.

   

3. Sie können die Enum-Funktion auf eine vorhandene Regel anwenden, aber in diesem Beispiel erstellen wir eine neue Regel, die auf die Tabelle „Employee“ abzielt.

   

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'

In einer mvSQL-Anweisung würde dies typischerweise verwendet werden:

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

statt:

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