Benutzerdefinierte SQL-Funktionen im Jitterbit App Builder

Die Syntax der benutzerdefinierten SQL-Funktion kann inline eingefügt werden mit App Builder unterstützte Syntax für Parametersubstitution.

Beispiel einer benutzerdefinierten SQL-Funktion

Zur Veranschaulichung beschreiben wir einen Anwendungsfall für eine benutzerdefinierte SQL-Funktion:

• Sie haben zwei Tabellen: Employees (Originaltabelle) und EmployeesPanel (neue Tabelle)
• Beide Tabellen haben dieselben Schlüssel
• Eine Tabelle enthält Werte, die aus der Datenquelle geladen wurden, die andere wurde als Panelquelle verwendet

Wenn Sie im obigen Szenario den Originalwert oder den Originalwert !! '-------' !! Neuer Wert für ein bestimmtes Feld anzeigen möchten, können Sie dies mit einer benutzerdefinierten SQL-Funktion tun. In diesem Beispiel verwenden wir eine benutzerdefinierte SQL-Funktion, um den FirstName-Wert aus unserer Originaltabelle (Employees, Alias E) und der neuen Tabelle (EmployeesPanel, Alias EP) zu vergleichen.

Hier ist die Definition für unsere benutzerdefinierte SQL-Beispielfunktion:

IIF({0} = {1}, {0}, {0}  || '------>' || {1})

Hier ist ein Screenshot, der zeigt, wie dieses Beispielszenario mit einer benutzerdefinierten SQL-Funktion aussehen könnte, aus der App Builder App-Ansicht:

So erstellen Sie eine benutzerdefinierte SQL-Funktion

Benutzerdefinierte SQL-Funktionen werden erstellt in App Builder Bereich „IDE-Konfigurationen“ auf dem Bildschirm „Funktionen“.

1. Gehen Sie zur Aktionsleiste und wählen Sie App Builder IDE aus dem Menü
2. Wählen Sie Site konfigurieren aus dem Menü Konfigurieren
3. Klicken Sie auf Funktionen
4. Klicken Sie auf die Schaltfläche Erstellen, um eine neue benutzerdefinierte SQL-Funktion hinzuzufügen.

5. Geben Sie Informationen zur benutzerdefinierten SQL-Funktion an:

   • Eigentümer - Standardmäßiger Wert
   • Typ - MVSQL oder SQL
   • Name - Benutzerdefinierter Name für die Funktion, sollte mit einem Unterstrich beginnen. Zum Beispiel _DiffFirstName
   • Anzahl der Argumente - Anzahl der Argumente in der Funktion
   • Definition - Die eigentliche SQL-Syntax für die Funktion
   • Beschreibung - Textbeschreibung dessen, was die SQL-Funktion tut
   • Beispiel - Ein Beispiel für die Verwendung der SQL-Funktion
   • Beispielergebnisse - Ergebnisse der SQL-Funktion

   

6. Klicken Sie auf Speichern

So verwenden Sie eine benutzerdefinierte SQL-Funktion in einer Regel

Nachdem Sie eine benutzerdefinierte SQL-Funktion erstellt haben, können Sie sie in einer Business-Objekt-Regel verwenden.

1. Gehen Sie zur Aktionsleiste und wählen Sie App Builder IDE aus dem Menü
2. Klicken Sie im Menü „Erstellen“ auf Anwendung erstellen
3. Klicken Sie auf die Menüschaltfläche Business Logic Layer
4. Klicken Sie auf das Symbol BOBJ für Ihre Anwendungsdatenquelle
5. Klicken Sie unter „Regeln“ auf Erstellen
6. Weisen Sie der benutzerdefinierten SQL-Funktion einen Namen zu und wählen Sie Business Object als Zweck
7. Klicken Sie auf Speichern

8. Klicken Sie auf das Symbol SQL, um die SQL-Logik für die benutzerdefinierte SQL-Funktion zu definieren. Die Schritte zum Konfigurieren dieser Funktion ähneln denen zum Definieren anderer SQL-Funktionen in App Builder. Wenn Sie zum Spaltenbereich gelangen, verweisen Sie auf Ihren benutzerdefinierten SQL-Funktionsnamen zusammen mit der Syntax:

   

9. Wenn Sie den Spaltenwert der benutzerdefinierten SQL-Funktion an anderer Stelle in der Anwendung verwenden möchten, klicken Sie unter Spalten auf Erstellen und fügen Sie eine eindeutige ID hinzu, die die Tabellen miteinander verbindet.

10. In diesem Beispiel möchten wir die Ergebnisse der benutzerdefinierten SQL-Funktion im Employees Panel sehen, das EmployeesPanel (Quelle) verwendet. Gehen Sie zur Business Logic EmployeesPanel (Quelle) und klicken Sie auf das SQL-Symbol für das Business Object EmployeesPanel (Quelle).
11. Klicken Sie unter Tabellen auf Erstellen und fügen Sie die Business Object-Regel der benutzerdefinierten SQL-Funktion ein. In diesem Beispiel ist es Employees (UDF _DiffFirstName).
12. Erstellen Sie einen Inner Join für die Tabelle und die Regel
13. Verbinden Sie die Spalten mit der eindeutigen ID
14. Klicken Sie unter Spalten auf Erstellen, um eine Spalte mit dem Ergebniswert Ihrer benutzerdefinierten SQL-Funktion hinzuzufügen, den Sie sehen möchten. Weisen Sie einen Alias zu und klicken Sie zum Speichern auf das Häkchen.