Zum Inhalt springen

GitHub-Connector in Jitterbit Studio

Zusammenfassung

Der GitHub-Connector stellt Zugriff auf GitHub bereit.

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

Der GitHub-Connector wird über die Registerkarte Project endpoints and connectors (Projektendpunkte und Connectoren) der Designkomponentenpalette aufgerufen (siehe Design component palette).

Tipp

Integration recipes sind für diesen Connector über Jitterbit Marketplace verfügbar.

Connector-Übersicht

Dieser Connector wird zunächst zum Konfigurieren einer GitHub-Verbindung verwendet. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann zum Erstellen von Aktivitätsinstanzen verwendet, die als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder Ziele (zum Verarbeiten von Daten in einem Vorgang) dienen sollen.

Zusammen werden eine bestimmte GitHub-Verbindung und ihre Aktivitäten als GitHub-Endpunkt bezeichnet:

GitHub activity types

Folgende Aktivitätstypen werden derzeit unterstützt:

  • Search: Ruft Objektdaten in GitHub ab und ist für die Verwendung als Quelle in einem Vorgang vorgesehen.

  • Create: Erstellt Objektdaten in GitHub und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

  • Delete: Löscht Objektdaten aus GitHub und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

  • Issues: Erstellt, löscht, fragt ab oder aktualisiert Problemdaten in GitHub und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

  • Pull Request: Erstellt, löscht, fragt ab oder aktualisiert Pull-Request-Daten in GitHub und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

  • Update: Aktualisiert Objektdaten in GitHub und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

Diese Aktivitätstypen sind veraltet:

  • Query File: Fragt eine Datei in GitHub ab und ist für die Verwendung als Quelle in einem Vorgang vorgesehen.

  • Create File: Erstellt eine Datei in GitHub und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

  • Update File: Aktualisiert eine Datei in GitHub und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

  • Delete File: Löscht eine Datei aus GitHub und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

Mit diesem Connector erstellte Endpunkte sind in der Endpunktnutzungsberichterstellung enthalten und werden auf die Lizenz angerechnet.

Voraussetzungen und unterstützte API-Versionen

Dieser Connector kann mit Cloud-Agenten und privaten Agenten verwendet werden.

Agenten laden automatisch die neueste Version dieses Connectors herunter, wenn erforderlich. Bei privaten Agenten können diese Updates mit der Organisationsrichtlinie Disable Auto Connector Update (Automatische Connector-Aktualisierung deaktivieren) ausgesetzt werden.

Der GitHub-Connector verwendet die GitHub REST API. Informationen zu den Schemaknoten und Feldern finden Sie in der API-Dokumentation.

Fehlerbehebung

Bei Problemen mit dem GitHub-Connector werden folgende Schritte zur Fehlerbehebung empfohlen:

  1. 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 Disable Auto Connector Update (Automatische Connector-Aktualisierung deaktivieren) verwendet wird).

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

  3. Aktivieren Sie das Betriebsdebug-Logging (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Bei Verwendung von privaten Agenten können Sie das ausführliche Connector-Logging für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag zur logback.xml-Datei Ihres privaten Agenten hinzufügen:

    <logger name="org.jitterbit.connector.verbose.logging.github" level="DEBUG"/>
    

    Weitere Informationen zum ausführlichen Connector-Logging finden Sie unter Ausführliches Logging für Connectors mit Jitterbit-Privatagenten.

  5. Bei Verwendung von privaten Agenten können Sie die Agent-Protokolle auf weitere Informationen überprüfen.

  6. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Operationen.