Problembehandlung und Debugging von ThingWorx Lösungen während dem Entwickeln und Bündeln
Im folgenden Abschnitt wird erläutert, wie einige Probleme während der Erweiterungsentwicklung und -bereitstellung behoben werden.
Dingvorlage ist nach erfolgreichem Import nicht vorhanden
Wenn beim Erstellen der Dingvorlage nach dem Importieren der Entitäten ein Problem auftritt, ist die Dingvorlage möglicherweise nicht in der Lösung verfügbar. Diese Ausnahme ist jedoch nicht schwerwiegend. Der häufigste Grund für diese Ausnahme ist eine fehlende JAR-Datei, die für die Dingvorlagenklasse erforderlich ist. Führen Sie bei diesem Problem die folgenden Prüfungen durch:
• Prüfen Sie in der Datei metadata.xml Ihrer Erweiterung die Deklaration für die erforderliche JAR-Datei.
• Prüfen Sie, ob die erforderliche JAR-Datei im Verzeichnis lib/common der Erweiterung verfügbar ist.
JAR-Dateikonflikt beim Import
Möglicherweise wird eine Ausnahme hinsichtlich eines Konflikts mit der JAR-Datei ausgegeben, wenn Ihre Anwendung eine JAR-Datei verwendet, die bereits auf der ThingWorx Platform geladen ist. Um das Problem zu beheben, können Sie die JAR-Datei aus der Datei metadata.xml entfernen. Das Entfernen der JAR-Datei aus der Metadatendatei kann jedoch riskant sein, wenn eine andere Version der JAR-Datei auf der ThingWorx Platform geladen ist. Unterschiedliche Versionen derselben JAR-Datei können zu Konflikten bei der Funktionalität führen. Dieser Konflikt kann sich auf Ihre Erweiterung oder die ThingWorx Platform selbst auswirken. Die beste Lösung besteht darin, zu vermeiden, die JAR-Datei zu verwenden (wenn möglich).
Protokolle prüfen, um Probleme beim Importieren einer Erweiterung zu debuggen
Eine ThingWorx Lösung protokolliert alle ihre Meldungen im Anwendungsprotokoll. Wenn Sie eine Erweiterung importieren, werden Klassen aus den JAR-Dateien geladen, Entitäten erstellt und mehrere Hintergrundprozesse gleichzeitig ausgeführt. Manchmal kann dies zu unerwarteten Fehlern führen. Der Import kann fehlschlagen oder erfolgreich sein, wobei aber einige ThingWorx Artefakte fehlen. Prüfen Sie bei derartigen Fehlern das Anwendungsprotokoll, in dem sich der Fehler mit einer Erläuterung befindet, was beim Import falsch gelaufen ist.
Um auf das Anwendungsprotokoll und andere Protokolle zuzugreifen, verwenden Sie das Menü Überwachung in Composer.
Debugging-Port mit Tomcat verbinden
Die beste Methode zum Debuggen Ihrer Lösung besteht darin, einen Debugging-Port mit Ihrer Tomcat-Instanz zu verbinden. Auf diese Weise können Sie über eine integrierte Entwicklungsumgebung (IDE, Integrated Development Environment) eine Verbindung zur ThingWorx Platform herstellen. Sie können dem Code, den Sie hochgeladen haben, Haltepunkte hinzufügen. Sie können einen Dienst auslösen, eine Eigenschaft festlegen oder ein Ding speichern und verfolgen, was im Code während der Ausführung geschieht. Sie müssen denselben Code wie den Code hochladen, in dem Haltepunkte vorhanden sind. Die hinzugefügten Haltepunkte werden verschiedenen Codezeilen zugeordnet und können unterschiedliche Werte und Funktionen aufweisen.
Um einen Debugging-Port zu Tomcat hinzuzufügen, müssen Sie beim Start eine Java-Option hinzufügen. Es gibt verschiedene Möglichkeiten, einen Debugging-Port hinzuzufügen. Dies hängt davon ab, wie Sie Tomcat starten. Sie müssen den Port je nach Tomcat- und IDE-Setup konfigurieren.