Überlegungen zu REST-basierten Konnektoren in Jitterbit Integration Studio

Einführung

Für die Verbindung mit RESTful-Webdiensten (auch REST- APIs genannt) können mehrere Integration Studio Konnektoren verwendet werden. Diese Seite bietet 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 Abschreibungen {: #high-level-considerations-and-future-deprecation }Anwendungskonnektoren enthalten häufig endpunktspezifische Funktionen, die mit dem spezifischen Connector einfacher zu konfigurieren sind als mit den generischen Connectors. Die generischen Konnektoren bieten jedoch im Allgemeinen mehr Flexibilität bei der Konfiguration. Benutzerdefinierte Konnektoren bieten zusätzliche Optionen, deren Erstellung zwar Vorarbeit erfordert, Nutzern aber die Nutzung Ihres Marken-Connectors mit Konfigurationen erleichtert, 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-Konnektor ist der ursprüngliche HTTP-Konnektor von Jitterbit, dessen zugrunde liegender Code seit über einem Jahrzehnt im Einsatz ist. Dieser Konnektor 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 Konnektor konzentrieren.
HTTP v2: Der HTTP v2-Konnektor ist die nächste Version des HTTP-Konnektors von Jitterbit. Er wurde mit Jitterbits erweiterbarem Connector SDK neu erstellt, wodurch neue Funktionen schneller verfügbar werden. Der HTTP v2-Konnektor unterstützt zusätzliche Authentifizierungstypen, Keep-Alive-Verbindungen und URL Parameter in Anforderungs-/Antwortschemata. Die zukünftige Entwicklung wird sich auf diesen Konnektor konzentrieren.

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

Jitterbit beabsichtigt langfristig, den HTTP-Connector abzuschaffen. Dies wird gemäß der End-of-Life-Richtlinie von Jitterbit angekündigt. Derzeit gibt es keinen Zeitplan für die Einstellung der Unterstützung, und der HTTP-Connector wird weiterhin vollständig unterstützt. Wir empfehlen Ihnen, vorhandene HTTP-Verbindungen und-Aktivitäten auf HTTP v2 umzustellen, wenn möglich.

Anwendungskonnektoren

Zahlreiche Anwendungskonnektoren sind verfügbar und werden ständig weiterentwickelt.

Wenn für Ihren Endpoint ein Anwendungskonnektor verfügbar ist, sollten Sie diesen in den meisten Fällen anstelle eines generischen HTTP-Konnektors verwenden. Anwendungskonnektoren enthalten häufig endpunktspezifische Funktionen, die sich mit dem spezifischen Konnektor einfacher konfigurieren lassen als mit den generischen Konnektoren. Wenn Sie jedoch einen spezifischen 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, in 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 dem Connector Builder oder dem Connector SDK:

Connector Builder
Konnektoren des Custom Connector Builders können mit einfacher oder keiner Authentifizierung erstellt werden. Beim Erstellen des Konnektors wählen Sie aus den unterstützten HTTP-Methoden GET, POST, PUT, DELETE, PATCH oder MERGE, um die entsprechenden Aktivitäten für die Benutzerkonfiguration zu erstellen.
Connector SDK
Benutzerdefinierte Connector-SDK-Konnektoren können für jeden Authentifizierungstyp entwickelt werden und unterstützen alle Methoden. Diese Art von benutzerdefinierten Konnektoren bietet die größte Flexibilität, da Entwickler Erweiterungen entsprechend den Anforderungen Ihres Unternehmens hinzufügen können.

Leistungsmatrix für Jitterbit-Anschlüsse

Konnektor-Funktionalität	HTTP v2-Konnektor	HTTP-Anschluss	Anwendungsspezifischer Konnektor
Autorisierungsunterstützung	Eine HTTP v2-Verbindung unterstützt diese Autorisierungstypen: API Schlüssel AWS-Signatur Basisautorisierung Inhaber-Token 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.
Operationsmusterunterstützung für Aktivitäten, die als Quellen verwendet werden	HTTP v2-Aktivitäten, die als Quelle verwendet werden, können mit diesen Mustern verwendet werden: Transformation Zwei-Ziel-Archivmuster (nur als erste Quelle) Zwei-Ziel-HTTP-Archivmuster (nur als erste Quelle) Zwei-Transformationsmuster (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) Zwei-Ziel-HTTP-Archivmuster (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) Zwei-Ziel-HTTP-Archivmuster (nur als erste Quelle) Zwei-Transformationsmuster (als erste oder zweite Quelle)
Operationsmusterunterstützung für Aktivitäten, die als Ziele verwendet werden	HTTP v2-Aktivitäten, die als Ziel verwendet werden, 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 (empfohlen: nicht mehr als 5 Wiederholungsversuche) im Abstand von bis zu 5 Sekunden. Nur auf privaten Agenten unterstützt.	Die Unterstützung variiert je nach Connector.
Übertragungszeitüberschreitung	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 mit enden `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 mit enden `http.max_redirs` kann verwendet werden, um das Verfolgen 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 Leerzeichen und Zeilenumbrüchen am Ende	Leerzeichen und Zeilenumbrüche in Anfragen bleiben standardmäßig unverändert. Die `trailing-linebreaks` Der 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	Wird nicht unterstützt.	Wird nur bei Verwendung eines [privaten Agenten][unterstützt.`PrivateAgent`] 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.`HTTPConnection`].	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 Senden `Expect 100-continue`wird in einer [HTTP-Verbindung][ausgewählt `HTTPConnection`].	Die Unterstützung variiert je nach Anschluss.
Unterstützung für schwache Verschlüsselungen	Wird nicht unterstützt.	HTTP-Server, die schwache Verschlüsselungen (DES/3DES und RC4) verwenden, können verwendet werden, wenn in einer [HTTP-Verbindung][die Option Schwache Verschlüsselungen zulassen ausgewählt ist.`HTTPConnection`].	Die Unterstützung variiert je nach Anschluss.
Unterstützung für Jitterbit-Plugins	Wird 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 zu HTTP GET-Aktivitäten

Wenn eine HTTP-GET-Aktivität als Zielaktivität 1 / Quellaktivität 2 im Zwei-Ziel-HTTP-Archivmuster 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-Konnektor-Aktivitäten können direkt als Funktionsparameter verwendet werden. Bei Verwendung mit HTTP v2 und Anwendungskonnektoren schreiben Sie die Daten in eine temporäre Datei und verwenden Sie diese dann in der Skriptfunktion.

Jitterbit-Funktionen

JavaScript-Jitterbit-Funktionen