REST JSON-Arrays (Drill Downs) im Jitterbit App Builder

Einführung

Der App Builder unterstützt die Übertragung komplexer, verschachtelter JSON-Arrays über die Drill Down-Funktion. Dies ermöglicht Entwicklern, hierarchische Datenstrukturen zu erstellen, indem sie Beziehungen zwischen einem Root-API-Aufruf und seinen zugehörigen Untertabellen festlegen.

Durch die Verwendung von Drill Downs können Sie eine JSON-Struktur navigieren, um sicherzustellen, dass übergeordnete Datensätze und ihre zugehörigen untergeordneten Datensätze in einem einzigen, einheitlichen Vorgang verarbeitet werden.

JSON-Arrays in GET-Anfragen

Ein häufiges Anwendungsbeispiel für JSON-Arrays ist eine "Eins-zu-Viele"-Beziehung, wie beispielsweise ein Kunde mit mehreren Adressen. In einer standardmäßigen GET-Anfrage interpretiert der App Builder diese als eine Sammlung, bei der das Root-Objekt ein Array von untergeordneten Objekten enthält.

Das folgende JSON zeigt einen Kunden-Datensatz mit mehreren Adressen:

"customers": [
    {
        "id": 1,
        "name": "Preston",
        "addresses": [
            {
                "street": "123 Broadway",
                "city": "NYC",
                "state": "NY"
            },
            {
                "street": "456 Multi-region Street",
                "city": "Boston",
                "state": "MA"
            }
        ]
    },
]

Der App Builder würde eine Root-Tabelle mit der ID und dem Namen erstellen sowie eine zusätzliche Adresse-Tabelle, um die Adressen zu enthalten, die über den ID-Fremdschlüssel mit der Root-Tabelle verbunden sind.

POST-Anfragen mit verschachtelten Daten konfigurieren

Um verschachtelte Daten an einen externen Dienst zu senden, müssen Sie zunächst Ihre lokalen Daten organisieren und dann den entsprechenden API-Endpunkt konfigurieren, um die hierarchische Struktur zu akzeptieren.

Schritt 1: Lokale Daten organisieren

Stellen Sie sicher, dass Ihre lokale Datenbank die Struktur widerspiegelt, die Sie senden möchten. Beispielsweise sollte eine lokale Kunden-Tabelle über einen CustomerID-Fremdschlüssel mit einer Adresse-Untertabelle verknüpft sein.

Schritt 2: Den POST-Endpunkt konfigurieren

Definieren Sie die Struktur der ausgehenden Daten innerhalb der REST-Datenserver-Konfiguration.

1. Navigieren Sie zu IDE > Datenserver.

2. Öffnen Sie Ihren REST-Datenserver und wählen Sie Endpunkte.

3. Fügen Sie einen POST-Endpunkt hinzu oder bearbeiten Sie ihn.

4. Geben Sie im Anforderungsinhalt ein Beispiel-JSON-Objekt an, das sowohl den übergeordneten Datensatz als auch das untergeordnete Array enthält.

5. Überprüfen Sie, ob der App Builder die erforderlichen Tabellen für den REST-Endpunkt generiert hat.

API-Aufrufkonfiguration

Um verschachtelte Daten erfolgreich zu senden, müssen Sie hierarchische API-Aufrufregeln definieren, die die Struktur Ihres JSON widerspiegeln.

Schritt 1: Definieren Sie die Stammregel

Erstellen Sie eine Regel vom Typ API-Aufruf, die die Stamm-Tabelle anvisiert (zum Beispiel customers (post)). Diese Regel ist verantwortlich für das Einfügen von Hauptfeldern wie ID und Name.

Schritt 2: Definieren Sie die verschachtelte Regel

Erstellen Sie eine sekundäre Regel vom Typ API-Aufruf, die den verschachtelten Pfad anvisiert (zum Beispiel customers (post)/addresses). Diese Regel fügt die zugehörigen Kindinformationen in das Array ein.

Verwendung von Drill Down

Die Drill Down-Einstellung ist der Mechanismus, der separate API-Aufrufregeln zu einem einzigen, verschachtelten Vorgang verbindet. Befolgen Sie diese Schritte:

1. Navigieren Sie zur obersten API-Aufrufregel.

2. Öffnen Sie Erweiterte Einstellungen und suchen Sie das Panel Drill Downs.

3. Klicken Sie auf + Drill Down und geben Sie die auszuführende Unterregel an (zum Beispiel Customer_Address_POST).

4. Konfigurieren Sie die Bindung, um sicherzustellen, dass die Kinddaten korrekt dem übergeordneten Datensatz zugeordnet werden.