GraphQL-Connector in Jitterbit Studio

Zusammenfassung

Der GraphQL-Connector stellt Zugriff auf GraphQL bereit.

Wichtig

Wir empfehlen die Verwendung des GraphQL v2-Connectors, um sich mit GraphQL zu verbinden, da dieser zusätzliche Konfigurationseigenschaften ermöglicht.

Der GraphQL-Connector bietet eine Schnittstelle zum Erstellen einer GraphQL-Verbindung, die Grundlage für die Generierung von GraphQL-Aktivitätsinstanzen. Diese Aktivitäten interagieren nach der Konfiguration mit GraphQL über die Verbindung.

Der GraphQL-Connector wird über die Registerkarte Projektendpunkte und Connectors der Designkomponentenpalette aufgerufen (siehe Designkomponentenpalette).

Mit diesem Connector erstellte Endpunkte sind in der Endpunkt-Nutzungsberichterstattung enthalten und werden auf Ihre Lizenz angerechnet.

Verbindungsdokumentation

Zusätzlich zur GraphQL-Verbindung siehe die umfassende Seite GraphQL-Verbindungsdetails. Konfigurationsdetails wie diese sind auf dieser Seite enthalten:

Erste Schritte: Erste Schritte zum Herstellen einer Verbindung.
Erweiterte Funktionen: Benutzerdefinierte Ansichten und SSL-Konfiguration.
Datenmodell: Das Datenmodell, das der Connector zur Darstellung des Endpunkts verwendet.
Erweiterte Konfigurationseigenschaften: Eigenschaften, die definiert werden können, um eine Verbindung für grundlegende und erweiterte Konfigurationen zu konfigurieren.

Aktivitätsdokumentation

Eine bestimmte GraphQL-Verbindung und ihre Aktivitäten werden zusammen als GraphQL-Endpunkt bezeichnet:

GraphQL-Aktivitätstypen

Abfrage: Ruft Datensätze aus einer Tabelle in GraphQL ab und ist für die Verwendung als Quelle in einem Vorgang vorgesehen.
Ausführen: Führt eine Prozedur in GraphQL aus und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

Voraussetzungen und unterstützte API-Versionen

Dieser Connector kann nur mit privaten Agenten verwendet werden.

Agenten laden automatisch die neueste Version dieses Connectors herunter, wenn erforderlich. Auf privaten Agenten können Sie diese Updates mit der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren organization policy aussetzen.

Informationen zu den Schemaknoten und Feldern finden Sie in der Dokumentation.

Der GraphQL-Connector erfordert zusätzlichen virtuellen Speicher-Heapsize, um erfolgreich ausgeführt zu werden. Siehe diese Anweisungen zum Erhöhen der Jitterbit Tomcat-Heapgröße, um die Heap nach Bedarf anzupassen.

OAuth-Authentifizierung

OAuth-Authentifizierung wird wie in OAuth-Verbindungen konfigurieren beschrieben unterstützt.

Fehlerbehebung

Wenn Probleme mit dem GraphQL-Connector auftreten, werden diese Fehlerbehebungsschritte empfohlen:

Klicken Sie auf die Schaltfläche Test in der Verbindungskonfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agent heruntergeladen wird (sofern nicht die Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren organization policy verwendet wird).
Überprüfen Sie die Vorgangsprotokolle auf alle Informationen, die während der Ausführung des Vorgangs geschrieben wurden.
Aktivieren Sie Operation Debug Logging für private Agents, um zusätzliche Protokolldateien und Daten zu generieren.
Aktivieren Sie Connector Verbose Logging für diesen Connector, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agents einfügen:
```
<logger name="org.jitterbit.connector.verbose.logging.GraphQL" level="TRACE"/>
```
Weitere Informationen zum Connector Verbose Logging finden Sie unter Verbose Logging für Connectors mit Jitterbit Private Agents.
Überprüfen Sie die Agent-Protokolle für weitere Informationen.
Weitere Überlegungen zur Fehlerbehebung finden Sie unter Operation Troubleshooting.