Zum Inhalt springen

GraphQL v2 Connector für Jitterbit Studio

Zusammenfassung

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

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

Der GraphQL v2 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

Zusätzlich zur GraphQL v2 Verbindung finden Sie auf der umfassenden Seite GraphQL v2 Verbindungsdetails Konfigurationsdetails wie diese:

  • 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 Konfigurationsparameter: Parameter, die definiert werden können, um eine Verbindung für grundlegende und erweiterte Konfigurationen zu konfigurieren.

Aktivitätsdokumentation

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

GraphQL v2 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 v2 Connector erfordert die Verwendung einer Agenten-Version 10.1 oder höher. Diese Agenten-Versionen 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 Speicher-Halbsatz, um erfolgreich ausgeführt zu werden. 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 Probleme mit dem GraphQL v2 Connector auftreten, werden die folgenden Schritte zur Fehlersuche empfohlen:

  1. 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, die Automatische Connector-Aktualisierung deaktivieren Organisationsrichtlinie wird verwendet).

  2. Überprüfen Sie die Betriebsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.

  3. Aktivieren Sie die Protokollierung des Betriebsdebuggings für private Agenten, um zusätzliche Protokolldateien und Daten zu generieren.

  4. Aktivieren Sie die ausführliche Protokollierung 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 zur ausführlichen Protokollierung von Connectors finden Sie unter Ausführliche Protokollierung für Connectors, die Jitterbit private Agenten verwenden.

  5. Überprüfen Sie die Agentenprotokolle für weitere Informationen.

  6. Für zusätzliche Überlegungen zur Fehlersuche siehe Fehlerbehebung bei Operationen.