Zum Inhalt springen

Connector SDK Fehlersuche

Fehlersuche

Diese Seite bietet Tipps und Vorschläge zur Fehlersuche bei Problemen mit dem Jitterbit Connector SDK. Siehe die Bekannten Probleme Seite für zusätzliche Informationen.

F: Ich habe meinen Connector registriert, die Manifestdatei bearbeitet und den Connector gebaut; 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 derselbe sein wie der Name, der in der JSON-Datei beschrieben ist, die die Benutzeroberfläche des Integration Studio beschreibt, und in den Java-Quelldateien. Ü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 Benutzeroberfläche des Integration Studio angezeigt. Was könnte falsch sein?

A: Überprüfen Sie diese Punkte:

  • Überprüfen Sie, ob die UI-Datei des Connectors (standardmäßig adapter.json) gültiges JSON ist; der Agent wird Fehler im Protokoll melden, wenn es Probleme gibt.
  • Überprüfen Sie in den Protokollen des Agents, ob der Connector bei Harmony registriert wurde; die Protokolle sollten die Informationen auflisten, die in der MANIFEST.MF-Datei bereitgestellt werden, einschließlich des registrierten Connector-Namens, des Autors, des Connector-Schlüssels, der Endpunkt-Entitätstyp-ID und der 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 derselbe sein wie der Name, der in der JSON-Datei beschrieben ist, die die Benutzeroberfläche des Integration Studio beschreibt, und in den Java-Quelldateien. Ü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 Agenten unter Windows 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 Connectoren des Agenten.
  • Starten Sie den Agenten neu.
  • Fügen Sie die Connector-JAR-Datei erneut hinzu.