Zum Inhalt springen

Mehrteiliger Anforderungstyp für REST- API im Jitterbit App Builder

Die Verwendung des Multipart-Anforderungsinhaltstyps für REST- API Webverbindungen ermöglicht es einem Benutzer, in einem anderen Format als JSON gegen eine REST- API zu posten. Mit dieser Methode werden die Daten direkt als Bytes gesendet, anstatt codiert zu werden, was beim Senden von Dateien zu und von einer API von Vorteil sein kann. In diesem Artikelbeispiel wird ein Bild unter Verwendung der Open-Source API an imgur.com gepostet.

REST-Datenserver

Für dieses Beispiel erstellen Sie zunächst einen REST-Datenserver, eine mehrteilige Anfrage, mit einer JSON-Antwort und verwenden das bereitgestellte Token. Diese Informationen werden unter IDE > Datenserver konfiguriert.

imgur.png Beispiel für eine REST API Datenserverkonfiguration

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

Von hier aus können wir unseren Header hinzufügen, den wir unter https://apidocs.imgur.com/#authorization-and-oauth und fügen Sie dann unseren Endpoint hinzu:

imgurendpoints.png * Endpoint *

Als Nächstes konfigurieren wir die Endpoint. Für dieses Beispiel fügen wir Endpoint für Folgendes hinzu, sowie drei weitere wie „Ausgabe“, Daten/ID, Daten/Link und ImageId (die nur intern ist, um den Datensatz einfacher zu aktualisieren), die in der Tabelle angezeigt werden.

imgurparameters.png *Konfigurieren von Endpoint *

Notiz

Die Ausgabeparameter werden auf dieser Seite nicht unter den Endpoint angezeigt, werden aber angezeigt, wenn Sie die Tabellendefinition von „Upload“ aktivieren. Sie müssen außerdem unter den Einstellungen Mehr > Edge Case öffentlichen Lese-/Schreibzugriff auf diese Tabelle zulassen.

uploadtabelle.png Tabellenkonfiguration hochladen

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, wiederum mit öffentlichem Lese-/Schreibzugriff unter den Einstellungen Mehr > Randfall.

imagetable.png Bildtabellenkonfiguration

Unterstützende Geschäftslogik

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

Erstellen Sie eine API Aufrufregel zum POST gegen die REST API (muss aus dieser Datenquelle erstellt werden, damit sie in einem späteren Schritt einem Ereignis hinzugefügt werden kann)

APIcall_1.png

  • API Aufrufregellogik*

Erstellen Sie eine XP CRUD-Updateregel, um die Bildtabelle mit Link/Daten/externalID aus der REST- API zu aktualisieren.

APIcall_2.png

XP CRUD Update-Regellogik

Als Nächstes haben wir den API Aufruf und die XP-CRUD-Regeln den Ereignissen für beide Bildtabellen zugeordnet.

associateevents.png

CRUD-Regeln mit Ereignissen verknüpfen

Anwendung

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

postpage.png

Seitendesignansicht für die zur Anwendung hinzugefügte Seite

pageuiexample.png

Anwendungsansicht für zur Anwendung hinzugefügte Seite