Zum Inhalt springen

Connector SDK Fehlersuche

Fehlersuche

Diese Seite bietet Tipps und Vorschläge zur Fehlersuche bei Problemen mit dem Jitterbit Connector SDK. Weitere Informationen finden Sie auf der Seite Bekannte Probleme.

F: Ich habe meinen Connector registriert, die Manifestdatei bearbeitet und den Connector erstellt; dennoch wird er nicht im Protokoll des Agents angezeigt. Was könnte falsch sein?

A: Wenn der Connector nicht geladen wird oder eine Fehlermeldung im Protokoll angezeigt wird, überprüfen Sie, ob der Build erfolgreich war. Entpacken Sie die erstellte JAR-Datei und überprüfen Sie die MANIFEST.MF-Datei darin, stellen Sie sicher, dass alle Dateien vorhanden sind und dass der Inhalt des Manifests dem entspricht, was Sie beabsichtigt haben. Wenn Sie auf Windows OS arbeiten, gibt es ein bekanntes Problem beim Erstellen von JAR-Dateien, bei dem der letzte Eintrag eines Manifests ignoriert wird, wenn kein abschließender Wagenrücklauf/Zeilenumbruch als letzter Eintrag vorhanden ist. Wenn Sie die Datei in einem Texteditor öffnen und keine Leerzeile am Ende sehen, fügen Sie eine hinzu und versuchen Sie, den Agenten neu zu erstellen und neu zu starten.

Überprüfen Sie, ob die Registrierung des Connectors korrekt durchgeführt wurde, indem Sie die Registrierungs-API verwenden, um die registrierten Connectoren für die von Ihnen verwendete Organisation abzurufen. Der Name, unter dem der Connector registriert ist, muss mit dem Namen übereinstimmen, der in der JSON-Datei zur Beschreibung der Studio-Benutzeroberfläche und in den Java-Quelldateien verwendet wird. Überprüfen Sie sowohl die Protokolle des Agents als auch des Tomcat-Servers auf Meldungen, die darauf hinweisen, dass der Connector korrekt erkannt und registriert wurde.

F: Mein Connector wird nicht in der Studio-Benutzeroberfläche angezeigt. Was könnte falsch sein?

A: Überprüfen Sie diese Punkte:

  • Stellen Sie sicher, dass die UI-Datei des Connectors (standardmäßig adapter.json) gültiges JSON ist; der Agent meldet Fehler im Protokoll, wenn es Probleme gibt.
  • Überprüfen Sie in den Protokollen des Agents, dass der Connector bei Harmony registriert wurde; die Protokolle sollten die Informationen enthalten, die in der MANIFEST.MF-Datei bereitgestellt werden, einschließlich des registrierten Connector-Namens, Autors, Connector-Schlüssels, Endpunkt-Entitätstyp-ID und Aktivitäts-IDs.
  • Verwenden Sie diese Postman-Sammlung, um zu sehen, welche Adapter (Connectoren) Harmony zurückgibt.
  • Überprüfen Sie, ob die Registrierung des Connectors korrekt durchgeführt wurde, indem Sie die Registrierungs-API verwenden, um die registrierten Connectoren für die von Ihnen verwendete Organisation abzurufen.
  • Der Name, unter dem der Connector registriert ist, muss mit dem Namen übereinstimmen, der in der JSON-Datei zur Beschreibung der Studio-Benutzeroberfläche und in den Java-Quelldateien verwendet wird. Überprüfen Sie sowohl die Protokolle des Agents als auch des Tomcat-Servers auf Meldungen, die darauf hinweisen, dass der Connector korrekt erkannt und registriert wurde.
  • Gelegentlich müssen Sie möglicherweise die Version in der MANIFEST.MF des Connectors erhöhen, neu erstellen und dann neu bereitstellen, damit die Änderungen propagiert werden.
  • Wenn Sie einen privaten Windows-Agenten verwenden, versuchen Sie, den Agenten neu zu starten.

Q: Wo finde ich die Protokolldateien, die ich zur Fehlersuche bei Verbindungsproblemen ansehen sollte?

A: Die Protokolldateien gehören zum Tomcat-Server des Jitterbit-Agenten. Sie befinden sich in einem Verzeichnis des Jitterbit-Agenten:

<JITTERBIT_HOME>/tomcat/logs

Unter Windows heißt die Protokolldatei catalina.<date_stamp>.out; unter Linux (und dem Docker-Agenten) heißt die aktuelle Protokolldatei catalina.out und wird, wenn sie größer wird, in catalina.<date_stamp>.out umbenannt.

Q: Wenn ich versuche, Operationen mit meinem Connector auszuführen, erhalte ich in den Betriebsprotokollen einen Fehler bei der selbstreferenziellen Typumwandlung. Wie kann ich das beheben?

A: Wenn der Typumwandlungsfehler ähnlich aussieht wie Caused by: java.lang.ClassCastException: org.jitterbit.connector.connectorName.ConnectorNameConnection kann nicht in org.jitterbit.connector.connectorName.ConnectorNameConnection umgewandelt werden, befolgen Sie dieses Verfahren:

  • Stoppen Sie den Agenten.
  • Entfernen Sie die Connector-JAR-Datei aus dem Verzeichnis der Agenten-Connectoren.
  • Starten Sie den Agenten neu.
  • Fügen Sie die Connector-JAR-Datei erneut hinzu.