Zum Inhalt springen

Multipart-Anforderungstyp für die REST-API im Jitterbit App Builder

Die Verwendung des Multipart Anforderungsinhalts für REST-API-Webverbindungen ermöglicht es einem Benutzer, gegen eine REST-API in einem anderen Format als JSON zu POSTen. Mit dieser Methode werden die Daten direkt als Bytes gesendet, anstatt codiert zu werden, was vorteilhaft sein kann, wenn Dateien an eine API gesendet oder von ihr empfangen werden. Dieses Beispiel POSTet ein Bild zu imgur.com unter Verwendung ihrer Open-Source-API.

REST-Datenserver

Für dieses Beispiel beginnen Sie mit der Erstellung eines REST-Datenservers, Multipart-Anforderung, mit einer JSON-Antwort und verwenden das bereitgestellte Token. Diese Informationen werden unter IDE > Datenserver konfiguriert.

imgur.png Beispielkonfiguration des REST-API-Datenservers

Als Nächstes müssen wir den Endpunkt für diese Datenquelle erstellen, indem wir zu Details > Endpunkte gehen.

Von hier aus können wir unseren Autorisierungsheader hinzufügen, den wir von https://apidocs.imgur.com/#authorization-and-oauth erstellt haben, und dann unseren Endpunkt hinzufügen:

imgurendpoints.png Endpunktkonfiguration

Als Nächstes konfigurieren wir die Endpunktparameter. Für dieses Beispiel fügen wir Endpunktparameter für die folgenden hinzu, sowie drei weitere als "output", data/id, data/link und ImageId (die nur intern ist, um das Aktualisieren des Datensatzes zu erleichtern), die in der Tabelle angezeigt werden.

imgurparameters.png Konfiguration der Endpunktparameter

Hinweis

Die Ausgabewerte werden unter den Endpunktparametern auf dieser Seite nicht angezeigt, sind jedoch sichtbar, wenn Sie die Tabellendefinition von "upload" überprüfen. Sie müssen auch den öffentlichen Lese-/Schreibzugriff auf diese Tabelle unter den Einstellungen Mehr > Edge Case zulassen.

uploadtable.png Konfiguration der Upload-Tabelle

Als Nächstes müssen wir unsere Imgur-Datenquelle mit der App verknüpfen und eine MS SQL-Datenbank erstellen, die mit der REST-Datenquelle verknüpft ist.

linkimgur.png Verknüpfte Datenquellen

Hier fügen wir eine einfache Bildtabelle hinzu, erneut mit öffentlichem Lese-/Schreibzugriff unter den Einstellungen Mehr > Edge Case.

imagetable.png Konfiguration der Bildtabelle

Unterstützende Geschäftslogik

Als nächstes erstellen wir zwei Regeln für die lokale Tabelle (Bild), um gegen die REST-API zu posten und die Ergebnisse abzurufen:

Erstellen Sie eine API-Call-Regel, um gegen die REST-API zu POSTEN (muss aus dieser Datenquelle erstellt werden, damit sie in einem späteren Schritt in ein Ereignis eingefügt werden kann)

APIcall_1.png

Logik der API-Call-Regel

Erstellen Sie eine XP CRUD-Update-Regel, um die Bildtabelle mit link/daten/externalID von der REST-API zu aktualisieren

APIcall_2.png

Logik der XP CRUD-Update-Regel

Als nächstes haben wir die API-Call- und XP CRUD-Regeln mit den Ereignissen für beide Bildtabellen verknüpft.

associateevents.png

Verknüpfung von CRUD-Regeln mit Ereignissen

Anwendung

Zuletzt haben wir eine Seite zur Anwendung hinzugefügt, die Datensätze mit Bildern erstellt, die vom Benutzer bereitgestellt werden. Wenn der Link null ist, können Sie posten (das Ereignis aufrufen).

postpage.png

Seitenentwurfansicht für die zur Anwendung hinzugefügte Seite

pageuiexample.png

Anwendungsansicht für die zur Anwendung hinzugefügte Seite