Überlegungen zu REST-basierten Connectoren in Jitterbit Studio

Einführung

Mehrere Studio-Connectoren können verwendet werden, um sich mit RESTful-Webservices, auch als REST-APIs bekannt, zu verbinden. Diese Seite bietet Überlegungen zur Auswahl des zu verwendenden Connectors aus zwei generischen HTTP-Connectoren oder zahlreichen anwendungsspezifischen Connectoren. Es können auch benutzerdefinierte REST-basierte Connectoren erstellt werden.

Allgemeine Überlegungen und zukünftige Einstellung

Anwendungsconnectoren enthalten häufig endpunktspezifische Funktionen, die sich mit dem spezifischen Connector leichter konfigurieren lassen als mit den generischen Connectoren. Die generischen Connectoren ermöglichen jedoch in der Regel mehr Flexibilität bei der Konfiguration. Benutzerdefinierte Connectoren bieten zusätzliche Optionen, die zwar anfangs Arbeit erfordern, aber es Benutzern ermöglichen, deinen Connector mit Konfigurationen zu verwenden, die sonst möglicherweise nicht verfügbar sind.

Generische Connectoren

Jitterbit stellt zwei generische Connectoren für die Verbindung mit REST-APIs bereit:

HTTP: Der HTTP-Connector ist Jitterbits ursprünglicher HTTP-Connector, dessen zugrunde liegender Code seit mehr als einem Jahrzehnt verwendet wird. Dieser Connector ist bewährt und zuverlässig, lässt sich aber schwer erweitern und warten. Daher wird die zukünftige Entwicklung nicht auf diesen Connector ausgerichtet sein.
HTTP v2: Der HTTP v2-Connector ist Jitterbits nächste Version des HTTP-Connectors. Er wurde neu aufgebaut, um neue Funktionen schneller verfügbar zu machen. Der HTTP v2-Connector unterstützt zusätzliche Authentifizierungstypen, Keep-Alive-Verbindungen und URL-Parameter in Request-/Response-Schemas. Die zukünftige Entwicklung wird sich auf diesen Connector konzentrieren.

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

Jitterbits langfristige Absicht ist es, den HTTP-Connector einzustellen, was gemäß Jitterbits End-of-Life-Richtlinie angekündigt wird. Derzeit gibt es keinen Zeitplan für die Einstellung und der HTTP-Connector bleibt vollständig unterstützt. Wir empfehlen, vorhandene HTTP-Verbindungen und -Aktivitäten nach Möglichkeit zu HTTP v2 zu konvertieren.

Anwendungsconnectoren

Zahlreiche Anwendungsconnectoren sind verfügbar und werden weiterhin entwickelt.

In den meisten Fällen wird empfohlen, einen Anwendungsconnector für deinen Endpunkt zu verwenden, falls dieser verfügbar ist, anstatt einen der generischen HTTP-Connectoren zu nutzen. Anwendungsconnectoren enthalten häufig endpunktspezifische Funktionen, die sich mit dem spezifischen Connector leichter konfigurieren lassen als mit den generischen Connectoren. Wenn du jedoch ein spezifisches Anforderung hast, das im Anwendungsendpunkt nicht verfügbar ist, ist die Verwendung eines generischen Connectors eine logische Alternative.

Angesichts von Jitterbits Absicht, den HTTP-Connector schließlich einzustellen, empfehlen wir, in neuen Projektdesigns nach Möglichkeit Anwendungsconnectoren oder den HTTP v2-Connector zu verwenden.

Benutzerdefinierte Connectoren

Für erweiterte Flexibilität kannst du benutzerdefinierte Connectoren mit Connector Builder oder dem Connector SDK erstellen:

Connector Builder
Benutzerdefinierte Connector Builder-Connectoren können so gestaltet werden, dass sie entweder eine grundlegende oder keine Authentifizierung verwenden. Bei der Erstellung des Connectors wählst du aus den unterstützten HTTP-Methoden GET, POST, PUT, DELETE, PATCH oder MERGE aus, um die entsprechenden Aktivitäten für Benutzer zum Konfigurieren zu erstellen.
Connector SDK
Benutzerdefinierte Connector SDK-Connectoren können so gestaltet werden, dass sie jeden Authentifizierungstyp verwenden, und die Unterstützung für jede Methode kann in den Connector integriert werden. Dieser Typ von benutzerdefinierten Connectoren bietet die meiste Flexibilität, da ein Entwickler Verbesserungen gemäß den Anforderungen deiner Organisation hinzufügen kann.

Funktionsmatrix für Jitterbit-Konnektoren

Connector-Funktionalität	HTTP v2 Connector	HTTP Connector	Anwendungsspezifischer Connector
Autorisierungsunterstützung	Eine HTTP v2-Verbindung unterstützt diese Autorisierungstypen: API Key AWS Signature Basis-Autorisierung Bearer Token Digest-Autorisierung Hawk-Autorisierung Keine Autorisierung NTLM-Autorisierung OAuth 2.0 (2- und 3-beinig)	Eine HTTP-Verbindung unterstützt diese Autorisierungstypen: Basis-Autorisierung Digest-Autorisierung	Die Unterstützung variiert je nach Connector.
HTTP-Methodenunterstützung	Der HTTP v2-Connector unterstützt diese Methoden mit Aktivitäten desselben Namens: GET POST PUT DELETE PATCH HEAD OPTIONS	Der HTTP-Connector unterstützt diese Methoden mit Aktivitäten desselben Namens: GET POST PUT DELETE Benutzerdefiniert (beliebiges benutzerdefinierten Verb)	Die Unterstützung variiert je nach Connector.
Operationsmuster-Unterstützung für Aktivitäten als Quellen	HTTP v2-Aktivitäten, die als Quelle verwendet werden, können mit diesen Mustern verwendet werden: Transformationsmuster 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 Transformationsmuster Zwei-Ziel-Archivmuster (nur als erste Quelle) Zwei-Ziel-HTTP-Archivmuster (als erste oder zweite Quelle) (Siehe Hinweis für HTTP GET-Aktivitäten unter dieser Tabelle.) Zwei-Transformationsmuster (nur als erste Quelle) Salesforce Bulk Target-Muster	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: Transformationsmuster Zwei-Ziel-Archivmuster (nur als erste Quelle) Zwei-Ziel-HTTP-Archivmuster (nur als erste Quelle) Zwei-Transformationsmuster (als erste oder zweite Quelle)
Operationsmuster-Unterstützung für Aktivitäten als Ziele	HTTP v2-Aktivitäten, die als Ziel verwendet werden, können mit diesen Mustern verwendet werden: Transformationsmuster Zwei-Transformationsmuster (als erstes oder zweites Ziel)	HTTP-Aktivitäten, die als Ziel verwendet werden, können mit diesen Mustern verwendet werden: Archivmuster Skriptmuster Transformationsmuster Zwei-Ziel-Archivmuster (nur als zweites Ziel) Zwei-Ziel-HTTP-Archivmuster (als erstes oder zweites Ziel) (Siehe Hinweis für HTTP GET-Aktivitäten unter dieser Tabelle.) Zwei-Transformationsmuster (nur als zweites Ziel) Salesforce Bulk Source-Muster	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: Transformationsmuster Zwei-Transformationsmuster (als erstes oder zweites Ziel)
Schema-Unterstützung	Benutzerdefinierte Request- und Response-Schemas sind optional und können vom Benutzer während der HTTP v2-Aktivitätskonfiguration bereitgestellt werden. Wenn benutzerdefinierte Schemas nicht in der Aktivitätskonfiguration bereitgestellt werden, werden Standard-Schemas verwendet, die ein allgemeines REST-API-Design unterstützen.	Benutzerdefinierte Request- und Response-Schemas sind optional und können vom Benutzer während der HTTP-Aktivitätskonfiguration bereitgestellt werden.	Die Unterstützung variiert je nach Connector. Request- und Response-Schemas können direkt vom Endpunkt generiert werden oder benutzerdefinierte Schema-Unterstützung kann verfügbar sein.
Dateibasierte Jitterbit- und JavaScript-Funktionen	Schreiben Sie die Daten in eine temporäre Datei und verwenden Sie dann den Zeichenfolgen-Referenzpfad zu dieser temporären Datei-Aktivität als `sourceId`- oder `targetId`-Funktionsparameter.	Verwenden Sie den Zeichenfolgen-Referenzpfad zur Aktivität als `sourceId`- oder `targetId`-Funktionsparameter.	Schreiben Sie die Daten in eine temporäre Datei und verwenden Sie dann den Zeichenfolgen-Referenzpfad zu dieser temporären Datei-Aktivität als `sourceId`- oder `targetId`-Funktionsparameter. Einige Konnektoren können zusätzliche Unterstützung bieten.
Anzahl der Wiederholungen	Maximal 5 Wiederholungen in Intervallen von bis zu 5 Sekunden. Nur auf privaten Agenten unterstützt.	Höheres Maximum (empfohlen nicht mehr als 5 Wiederholungen) in Intervallen von bis zu 5 Sekunden. Nur auf privaten Agenten unterstützt.	Die Unterstützung variiert je nach Connector.
Übertragungszeitüberschreitung	Standardmäßig 30 Sekunden. Der Schlüssel `connection-timeout` im Bereich Zusätzliche Einstellungen der HTTP v2-Aktivitätskonfiguration kann verwendet werden, um die Übertragungszeitüberschreitung zu ändern.	Standardmäßig 3.600 Sekunden. Die Jitterbit-Quellvariablen und Zielvariablen, deren Namen mit `http.transfer.timeout` enden, können verwendet werden, um die Übertragungszeitüberschreitung zu ändern.	Die Unterstützung variiert je nach Connector.
Unterstützung für Umleitungen	Standardmäßig 50 Umleitungen. Der Schlüssel `max-redirect` im Bereich Zusätzliche Einstellungen der HTTP v2-Aktivitätskonfiguration kann verwendet werden, um die Anzahl der zu verfolgenden Umleitungen zu ändern.	Umleitungen werden standardmäßig nicht verfolgt. Die Jitterbit-Quellvariablen und Zielvariablen, deren Namen mit `http.max_redirs` enden, können verwendet werden, um Umleitungen zu verfolgen.	Die Unterstützung variiert je nach Connector.
Unterstützung für Formulardaten	Die Einstellung Multipart der HTTP v2-Aktivitätskonfiguration POST, PUT und PATCH kann verwendet werden, um RFC 1687-Formular-Uploads bei Verwendung von Standard-Schemas zu unterstützen. Nicht unterstützt mit benutzerdefinierten Schemas.	Die Jitterbit-Zielvariablen, deren Namen `http.form_data` enthalten, können mit RFC 1687-Formular-Uploads verwendet werden.	Die Unterstützung variiert je nach Connector.
Unterstützung zum Entfernen von nachgelagerten Leerzeichen und Zeilenumbrüchen	Request-Leerzeichen und Zeilenumbrüche bleiben standardmäßig unverändert. Der Schlüssel `trailing-linebreaks` im Bereich Zusätzliche Einstellungen der HTTP v2-Aktivitätskonfiguration kann auf „true" gesetzt werden, um führende und nachgelagerte Leerzeichen und Zeilenumbrüche zu entfernen.	Die `http.remove_trailing_linebreaks` Jitterbit-Zielvariable kann verwendet werden, um führende und nachgelagerte Leerzeichen und Zeilenumbrüche zu entfernen.	Die Unterstützung variiert je nach Connector.
Keep Alive-Einstellung	Die Einstellung Keep Alive in einer HTTP v2-Verbindung kann verwendet werden, um eine einzelne TCP-Verbindung für mehrere HTTP-Anfragen und -Antworten offen zu halten.	Nicht unterstützt.	Die Unterstützung variiert je nach Connector.
Unterstützung für Cookies	Nicht unterstützt.	Nur unterstützt, wenn ein privater Agent verwendet wird und die Einstellung `jitterbit.http.enable_cookies` in der Agent-Konfigurationsdatei (`jitterbit.conf`) auf `true` gesetzt ist.	Die Unterstützung variiert je nach Connector.
Unterstützung für benutzerdefinierte Zertifikate	Nicht unterstützt.	Ein Zertifikat zur Authentifizierung beim HTTP-Server kann mit dem Feld Zertifikat einer HTTP-Verbindung angegeben werden.	Die Unterstützung variiert je nach Connector.
Unterstützung für Expect: 100-continue	Nicht unterstützt.	Der Header „Expect: 100 continue" wird gesendet, wenn „Send `Expect 100-continue`" in einer HTTP-Verbindung ausgewählt ist.	Die Unterstützung variiert je nach Connector.
Unterstützung für schwache Verschlüsselungen	Die Einstellung Add Ciphers in einer HTTP v2-Verbindung kann verwendet werden, um schwache Verschlüsselungen manuell zu definieren.	HTTP-Server, die schwache Verschlüsselungen (DES/3DES und RC4) verwenden, können verwendet werden, wenn Allow Weak Ciphers in einer HTTP-Verbindung ausgewählt ist.	Die Unterstützung variiert je nach Connector.
Unterstützung für Jitterbit-Plugins	Nicht unterstützt.	Jitterbit-Plugins sind im letzten Schritt der HTTP-Aktivitätskonfiguration verfügbar (siehe Plugins, die zu einer Aktivität hinzugefügt wurden).	Nicht unterstützt.
Unterstützung für Protokollierung auf privaten Agenten	Der HTTP v2-Connector unterstützt Connector-Verbose-Protokollierung.	Der HTTP-Connector unterstützt Curl-Debug-Protokollierung.	Die Unterstützung variiert je nach Connector.

Hinweis für HTTP GET-Aktivitäten

Wenn eine HTTP GET-Aktivität als Target Activity 1 / Source Activity 2 im Two-target HTTP archive pattern verwendet wird, gibt die Aktivität eine Erfolgsmeldung {"success": true} oder eine Fehlermeldung {"success": false} zurück, anstatt die tatsächliche Antwort zu liefern.

Dateibasierte Jitterbit- und JavaScript-Funktionen

Dateibasierte Jitterbit- und JavaScript-Funktionen sind nachfolgend aufgelistet. 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 dann diese temporäre Datei in der Scripting-Funktion.

Jitterbit-Funktionen

JavaScript-Jitterbit-Funktionen