Überlegungen zu REST-basierten Connectoren in Jitterbit Integration Studio

Einführung

Mehrere Integration Studio Konnektoren können verwendet werden, um eine Verbindung zu RESTful-Webdiensten herzustellen, die auch als REST- APIs bezeichnet werden. Auf dieser Seite finden Sie Hinweise zur Auswahl des zu verwendenden Konnektors. Sie haben die Wahl zwischen zwei generischen HTTP-Konnektoren oder zahlreichen anwendungsspezifischen Konnektoren. Es können auch benutzerdefinierte REST-basierte Konnektoren erstellt werden.

Allgemeine Überlegungen und zukünftige Abkündigung

Anwendungskonnektoren enthalten häufig endpunktspezifische Funktionen, die mit dem spezifischen Connector einfacher zu konfigurieren sind als mit den generischen Connectoren. Die generischen Konnektoren bieten jedoch im Allgemeinen mehr Flexibilität bei der Konfiguration. Benutzerdefinierte Konnektoren bieten zusätzliche Optionen, deren Erstellung im Vorfeld Arbeit erfordert, es den Benutzern jedoch erleichtert, Ihren Marken-Connector mit Konfigurationen zu verwenden, die andernfalls möglicherweise nicht verfügbar wären.

Generische Konnektoren

Jitterbit bietet zwei generische Konnektoren für die Verbindung mit REST- APIs:

HTTP: Der HTTP-Connector ist der ursprüngliche HTTP-Connector von Jitterbit, dessen zugrunde liegender Code seit mehr als einem Jahrzehnt im Einsatz ist. Dieser Connector ist bewährt und vertrauenswürdig, lässt sich jedoch nur schwer erweitern und warten. Daher wird sich die zukünftige Entwicklung nicht auf diesen Connector konzentrieren.
HTTP v2: Der HTTP v2-Connector ist die nächste Version des HTTP-Connectors von Jitterbit. Er wurde mit Jitterbits erweiterbarem Connector SDK neu erstellt, wodurch neue Funktionen schneller verfügbar werden. Der HTTP v2-Connector unterstützt zusätzliche Authentifizierungstypen, Keep-Alive-Verbindungen und URL Parameter in Anforderungs-/Antwortschemata. Die zukünftige Entwicklung wird sich auf diesen Connector konzentrieren.

Jitterbit unterstützt sowohl den HTTP- als auch den HTTP v2-Anschlüsse.

Jitterbit beabsichtigt langfristig, den HTTP-Connector abzuschaffen. Dies wird in Übereinstimmung mit Jitterbits End-of-Life-Richtlinie angekündigt. Derzeit gibt es keinen Zeitplan für die Abkündigung und der HTTP-Connector wird weiterhin vollständig unterstützt. Wir empfehlen Ihnen, vorhandene HTTP-Verbindungen und-Aktivitäten auf HTTP v2 umzuwandeln, wenn möglich.

Anwendungskonnektoren

Zahlreiche Anwendungskonnektoren stehen zur Verfügung und werden ständig weiterentwickelt.

Wenn für Ihren Endpoint ein Anwendungskonnektor verfügbar ist, sollten Sie in den meisten Fällen diesen anstelle eines generischen HTTP-Konnektors verwenden. Anwendungskonnektoren enthalten häufig endpunktspezifische Funktionen, die mit dem spezifischen Konnektor einfacher zu konfigurieren sind als mit den generischen Konnektoren. Wenn Sie jedoch einen bestimmten Bedarf haben, der im Endpoint nicht verfügbar ist, ist die Verwendung eines generischen Konnektors eine logische Alternative.

Angesichts der Absicht von Jitterbit, den HTTP-Konnektor irgendwann abzuschaffen, empfehlen wir, bei neuen Projektdesigns nach Möglichkeit Anwendungskonnektoren oder den HTTP v2-Konnektor zu verwenden.

Benutzerdefinierte Konnektoren

Für mehr Flexibilität können Sie benutzerdefinierte Konnektoren erstellen mit Connector Builder oder dem Connector SDK:

Connector Builder
Custom Connector Builder-Konnektoren können so gestaltet werden, dass sie entweder eine einfache oder keine Authentifizierung verwenden. Während der Erstellung des Konnektors wählen Sie aus den unterstützten HTTP-Methoden GET, POST, PUT, DELETE, PATCH oder MERGE aus, um die entsprechenden Aktivitäten zu erstellen, die Benutzer konfigurieren können.
Connector SDK
Konnektoren des benutzerdefinierten Konnektors SDK können so gestaltet werden, dass sie jeden Authentifizierungstyp verwenden, und die Unterstützung für jede Methode kann in den Konnektor integriert werden. Diese Art von benutzerdefiniertem Konnektor bietet die größte Flexibilität, da ein Entwickler Erweiterungen entsprechend den Anforderungen Ihres Unternehmens hinzufügen kann.

Leistungsmatrix für Jitterbit-Anschlüsse

Connector-Fähigkeit	HTTP v2 Connector	HTTP-Anschluss	Anwendungsspezifischer Konnektor
Autorisierungsunterstützung	Eine HTTP v2-Verbindung unterstützt diese Autorisierungstypen: API Schlüssel AWS-Signatur Basisautorisierung Trägertoken Digest-Autorisierung Keine Autorisierung OAuth 2.0	Eine HTTP-Verbindung unterstützt diese Autorisierungstypen: Basisautorisierung Digest-Autorisierung	Die Unterstützung variiert je nach Connector.
HTTP-Methodenunterstützung	Der HTTP v2-Connector unterstützt diese Methoden mit den gleichnamigen Aktivitäten: GET POST EINSETZEN LÖSCHEN PATCH KOPF OPTIONEN	Der HTTP-Connector unterstützt diese Methoden mit diesen gleichnamigen Aktivitäten: GET POST EINSETZEN LÖSCHEN Benutzerdefiniert (jedes benutzerdefinierte Verb)	Die Unterstützung variiert je nach Connector.
Operationsmuster-Unterstützung für Aktivitäten, die als Quellen verwendet werden	Als Quelle verwendete HTTP v2-Aktivitäten können mit diesen Mustern verwendet werden: Transformation Zwei-Ziel-Archivmuster (nur als erste Quelle) HTTP-Archivmuster mit zwei Zielen (nur als erste Quelle) Zwei-Transformations-Muster (als erste oder zweite Quelle)	HTTP-Aktivitäten, die als Quelle verwendet werden, können mit diesen Mustern verwendet werden: Archivmuster Transformation Zwei-Ziel-Archivmuster (nur als erste Quelle) HTTP-Archivmuster mit zwei Zielen (als erste oder zweite Quelle) (Siehe Hinweis zu HTTP GET-Aktivitäten unter dieser Tabelle.) Zwei-Transformationsmuster (nur als erste Quelle) Salesforce Bulk Target Pattern	Die Unterstützung variiert je nach Connector. Die meisten anwendungsspezifischen Connector-Aktivitäten, die als Quelle verwendet werden, können mit diesen Mustern verwendet werden: Transformation Zwei-Ziel-Archivmuster (nur als erste Quelle) HTTP-Archivmuster mit zwei Zielen (nur als erste Quelle) Zwei-Transformations-Muster (als erste oder zweite Quelle)
Operationsmuster-Unterstützung für Aktivitäten, die als Ziele verwendet werden	Als Ziel verwendete HTTP v2-Aktivitäten können mit diesen Mustern verwendet werden: Transformation Zwei-Transformationsmuster (als erstes oder zweites Ziel)	HTTP-Aktivitäten, die als Ziel verwendet werden, können mit diesen Mustern verwendet werden: Archivmuster Script Transformation Zwei-Ziel-Archivmuster (nur als zweites Ziel) HTTP-Archivmuster mit zwei Zielen (als erstes oder zweites Ziel) (Siehe Hinweis zu HTTP-GET-Aktivitäten unter dieser Tabelle.) Zwei-Transformationsmuster (nur als zweites Ziel) Salesforce Bulk Source Pattern	Die Unterstützung variiert je nach Connector. Die meisten anwendungsspezifischen Connector-Aktivitäten, die als Ziel verwendet werden, können mit diesen Mustern verwendet werden: Transformation Zwei-Transformationsmuster (als erstes oder zweites Ziel)
Schema-Unterstützung	Benutzerdefinierte Anforderungs- und Antwortschemata sind optional und können vom Benutzer während der HTTP v2-Aktivitätskonfiguration bereitgestellt werden. Wenn in der Aktivitätskonfiguration keine benutzerdefinierten Schemata bereitgestellt werden, werden Standardschemata verwendet, die ein allgemeines REST- API Design unterstützen.	Benutzerdefinierte Anforderungs- und Antwortschemata sind optional und können vom Benutzer während der HTTP-Aktivitätskonfiguration bereitgestellt werden.	Die Unterstützung variiert je nach Connector. Anforderungs- und Antwortschemata können direkt vom Endpoint generiert werden, oder es ist Unterstützung für benutzerdefinierte Schemata verfügbar.
Dateibasiertes Jitterbit und JavaScript-Funktionen	Schreibe die Daten in eine temporäre Datei und verwende dann den String-Referenzpfad zu dieser temporären Dateiaktivität als `sourceId` oder `targetId` Funktionsparameter.	Verwenden Sie den String-Referenzpfad zur Aktivität als `sourceId` oder `targetId` Funktionsparameter.	Schreiben Sie die Daten in eine temporäre Datei und verwenden Sie dann den String-Referenzpfad zu dieser temporären Dateiaktivität als `sourceId` oder `targetId` Funktionsparameter. Einige Konnektoren verfügen möglicherweise über zusätzliche Unterstützung.
Anzahl der Wiederholungsversuche	Maximal 5 Wiederholungsversuche im Abstand von bis zu 5 Sekunden. Nur auf privaten Agenten unterstützt.	Höheres Maximum (nicht mehr als 5 Wiederholungsversuche empfohlen) im Abstand von bis zu 5 Sekunden. Nur auf privaten Agenten unterstützt.	Unterstützung variiert je nach Connector.
Übertragungs-Timeout	Standardmäßig 30 Sekunden. Die `connection-timeout` Der Schlüssel im Bereich Zusätzliche Einstellungen der HTTP v2-Aktivitätskonfiguration kann verwendet werden, um das Übertragungstimeout zu ändern.	3.600 Sekunden standardmäßig. Die Jitterbit-Quellvariablen und Zielvariablen deren Namen enden mit `http.transfer.timeout` kann verwendet werden, um das Übertragungstimeout zu ändern.	Die Unterstützung variiert je nach Connector.
Unterstützung für Weiterleitungen	50 Weiterleitungen standardmäßig. Die `max-redirect` Der Schlüssel im Bereich Zusätzliche Einstellungen der HTTP v2-Aktivitätskonfiguration kann verwendet werden, um die Anzahl der zu befolgenden Weiterleitungen zu ändern.	Weiterleitungen werden standardmäßig nicht befolgt. Die Jitterbit-Quellvariablen und Zielvariablen deren Namen enden mit `http.max_redirs` kann verwendet werden, um die Verfolgung von Weiterleitungen zu ermöglichen.	Die Unterstützung variiert je nach Connector.
Unterstützung für Formulardaten	Die Multipart-Einstellung von HTTP v2 POST, SETZEN und PATCH Die Aktivitätskonfiguration kann verwendet werden, um RFC 1687-Formular-Uploads bei Verwendung von Standardschemata zu unterstützen. Wird bei benutzerdefinierten Schemata nicht unterstützt.	Die Jitterbit-Zielvariablen, deren Namen umfassen `http.form_data` kann mit RFC 1687-Formular-Uploads verwendet werden.	Die Unterstützung variiert je nach Connector.
Unterstützung für das Entfernen von nachstehenden Leerzeichen und Zeilenumbrüchen	Anforderungs-Leerzeichen und Zeilenumbrüche bleiben standardmäßig unverändert. Die `trailing-linebreaks` Schlüssel im Bereich Zusätzliche Einstellungen der HTTP v2-Aktivitätskonfiguration kann auf true gesetzt werden, um führende und nachfolgende Leerzeichen sowie Zeilenumbrüche zu entfernen.	Der `http.remove_trailing_linebreaks` Jitterbit-Zielvariable kann verwendet werden, um führende und nachfolgende Leerzeichen sowie Zeilenumbrüche zu entfernen.	Die Unterstützung variiert je nach Connector.
Keep Alive-Einstellung	Die Keep Alive-Einstellung in einer HTTP v2-Verbindung kann verwendet werden, um eine einzelne TCP-Verbindung für mehrere HTTP-Anfragen und-Antworten offen zu halten.	Wird nicht unterstützt.	Die Unterstützung variiert je nach Connector.
Unterstützung für Cookies	Nicht unterstützt.	Wird nur unterstützt, wenn ein privater Agent verwendet wird und die `jitterbit.http.enable_cookies` Einstellung ist eingestellt auf `true` in der Agentenkonfigurationsdatei (`jitterbit.conf`).	Die Unterstützung variiert je nach Anschluss.
Unterstützung für benutzerdefinierte Zertifikate	Wird nicht unterstützt.	Ein Zertifikat zur Authentifizierung beim HTTP-Server kann im Feld Zertifikat einer HTTP-Verbindung angegeben werden.	Die Unterstützung variiert je nach Anschluss.
Unterstützung für Expect: 100-continue	Wird nicht unterstützt.	Der Expect: 100 continue-Header wird gesendet, wenn Send `Expect 100-continue` ist in einer HTTP-Verbindung ausgewählt.	Die Unterstützung variiert je nach Anschluss.
Unterstützung für schwache Chiffren	Wird nicht unterstützt.	HTTP-Server, die schwache Chiffren (DES/3DES und RC4) verwenden, können verwendet werden, wenn Schwache Chiffren zulassen in einer HTTP-Verbindung ausgewählt ist.	Die Unterstützung variiert je nach Anschluss.
Unterstützung für Jitterbit-Plugins	Nicht unterstützt.	Jitterbit-Plugins können im letzten Schritt der HTTP-Aktivitätskonfiguration konfiguriert werden (siehe Zu einer Aktivität hinzugefügte Plugins).	Wird nicht unterstützt.
Unterstützung für die Protokollierung Private Agenten	Der HTTP v2-Connector unterstützt ausführliche Connector-Protokollierung.	Der HTTP-Connector unterstützt Curl- debuggen Protokollierung.	Die Unterstützung variiert je nach Anschluss.

Hinweis für HTTP GET Aktivitäten

Wenn eine HTTP-GET-Aktivität als Zielaktivität 1 / Quellaktivität 2 im HTTP-Archivmuster mit zwei Zielen verwendet wird, die Aktivität gibt eine Erfolgsmeldung zurück {"success": true}oder Versagen {"success": false}anstelle der tatsächlichen Antwort.

Dateibasierte Jitterbit- und JavaScript-Funktionen

Dateibasierte Jitterbit- und JavaScript-Funktionen sind unten aufgeführt. HTTP-Connector-Aktivitäten können direkt als Funktionsparameter verwendet werden. Für die Verwendung mit HTTP v2 und Anwendungs-Connectoren schreiben Sie die Daten in eine temporäre Datei und verwenden Sie diese temporäre Datei dann in der Skriptfunktion.

Jitterbit-Funktionen

JavaScript Jitterbit-Funktionen