GraphQL-Connector für Jitterbit Studio

Zusammenfassung

Der GraphQL-Connector ermöglicht den Zugriff auf GraphQL.

Wichtig

Wir empfehlen die Verwendung des GraphQL v2-Connectors, um eine Verbindung zu GraphQL herzustellen, da er zusätzliche Konfigurationsoptionen bietet.

Der GraphQL-Connector bietet eine Schnittstelle zur Erstellung einer GraphQL-Verbindung, die als Grundlage für die Generierung von Instanzen von GraphQL-Aktivitäten dient. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit GraphQL.

Der GraphQL-Connector wird über die Registerkarte Projektendpunkte und -connectoren in der Design-Komponentenpalette aufgerufen (siehe Design-Komponentenpalette).

Hinweis

Dieser Connector kann nur mit privaten Agenten verwendet werden. Darüber hinaus handelt es sich um einen auf dem Connector SDK-basierenden Connector, auf den Jitterbit möglicherweise verweist, wenn Änderungen an mit dem Connector SDK erstellten Connectors kommuniziert werden.

Endpunkte, die mit diesem Connector erstellt wurden, sind in Endpunktnutzungsberichten enthalten und zählen zu Ihrer Lizenz.

Verbindungsdokumentation

Neben der GraphQL-Verbindung finden Sie die umfassende Seite mit den GraphQL-Verbindungsdetails. Konfigurationsdetails wie diese sind auf dieser Seite enthalten:

Erste Schritte: Erste Schritte zur Herstellung einer Verbindung.
Erweiterte Funktionen: Benutzerdefinierte Ansichten und SSL-Konfiguration.
Datenmodell: Das Datenmodell, das der Connector verwendet, um den Endpunkt darzustellen.
Erweiterte Konfigurationsoptionen: Eigenschaften, die definiert werden können, um eine Verbindung für grundlegende und erweiterte Konfigurationen zu konfigurieren.

Aktivitätsdokumentation

Zusammen werden eine spezifische GraphQL-Verbindung und ihre Aktivitäten als GraphQL-Endpunkt bezeichnet:

GraphQL-Aktivitätstypen

Abfrage: Ruft Datensätze aus einer Tabelle bei GraphQL ab und ist als Quelle in einem Vorgang vorgesehen.
Ausführen: Führt ein Verfahren bei GraphQL aus und ist als Ziel in einem Vorgang vorgesehen.

Voraussetzungen und unterstützte API-Versionen

Der GraphQL-Connector erfordert die Verwendung einer Agentenversion 10.1 oder höher. Diese Agentenversionen laden automatisch die neueste Version des Connectors herunter, wenn dies erforderlich ist.

Dieser Connector erfordert die Verwendung eines privaten Agents.

Siehe die Dokumentation für Informationen zu den Schema-Knoten und -Feldern.

Der GraphQL-Connector benötigt zusätzlichen virtuellen Speicherheap, um erfolgreich zu funktionieren. Siehe diese Anweisungen zur Erhöhung der Jitterbit Tomcat-Heap-Größe, um den Heap nach Bedarf anzupassen.

OAuth-Authentifizierung

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

Fehlersuche

Wenn Sie Probleme mit dem GraphQL-Connector haben, werden die folgenden Schritte zur Fehlersuche empfohlen:

Klicken Sie auf die Schaltfläche Test in der Verbindungs-Konfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agenten heruntergeladen wird (es sei denn, Sie verwenden die Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren).
Überprüfen Sie die Betriebsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.
Aktivieren Sie das Debug-Protokoll für private Agenten, um zusätzliche Protokolldateien und Daten zu generieren.
Aktivieren Sie das ausführliche Protokollieren des Connectors für diesen Connector, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agenten hinzufügen:
```
<logger name="org.jitterbit.connector.verbose.logging.GraphQL" level="TRACE"/>
```
Weitere Informationen zum ausführlichen Protokollieren von Connectors finden Sie unter Ausführliches Protokollieren für Connectors, die Jitterbit-private Agenten verwenden.
Überprüfen Sie die Agentenprotokolle für weitere Informationen.
Für zusätzliche Überlegungen zur Fehlersuche siehe Fehlerbehebung bei Operationen.