Устранение неисправностей и отладка решений ThingWorx во время разработки и упаковки
В следующем разделе поясняется, как устранять неисправности при разработке и развертывании расширений.
Шаблон вещи не существует после успешного импорта
Если при создании шаблона вещи после импорта сущностей возникла проблема, шаблон вещи может быть недоступен в решении. Однако это исключение не является критическим. Наиболее распространенной причиной этого исключения является отсутствующий JAR-файл, необходимый для класса шаблона вещи. В случае этой проблемы выполните следующие проверки:
• В файле metadata.xml расширения проверьте объявление для требуемого JAR-файла.
• Убедитесь, что требуемый JAR-файл доступен в папке lib/common расширения.
Конфликт JAR-файла при импорте
Если в решении используется JAR-файл, который уже загружен в ThingWorx Platform, можно получить исключение конфликта JAR-файла. Чтобы исправить проблему, можно удалить JAR из файла metadata.xml. Однако удаление JAR из файла метаданных может быть рискованным, если в ThingWorx Platform загружена другая версия JAR. Различные версии одного и того же JAR могут стать причиной конфликта функциональности. Этот конфликт может повлиять на расширение или непосредственно на ThingWorx Platform. Наилучшим решением является попытка по возможности не использовать JAR.
Проверяйте журналы для отладки проблем при импорте расширения
Решение ThingWorx регистрирует все сообщения в журнале приложений. При импорте расширения классы загружаются из JAR-файлов, создаются сущности и одновременно выполняются несколько фоновых процессов. Иногда это может привести к неожиданным ошибкам. Импорт может завершиться неудачно или успешно с отсутствием некоторых артефактов ThingWorx. Для таких ошибок следует проверить журнал приложения, в котором можно найти ошибку с объяснением, что пошло не так при импорте.
Чтобы получить доступ к журналу приложения и другим журналам, используйте меню Мониторинг в Composer.
Подключите порт отладки к Tomcat
Лучшим способом отладки решения является подключение порта отладки к экземпляру Tomcat. Это позволяет соединиться с ThingWorx Platform из интегрированной среды разработки (IDE). Можно добавить точки останова к выгруженному коду. Можно запускать сервис, задавать свойство или сохранять вещь и отслеживать, что происходит внутри кода при его выполнении. Необходимо выгрузить тот же код, что и код, в котором имеются точки останова. Добавляемые точки останова будут связаны с разными строками кода и могут иметь различные значения и функциональность.
Чтобы добавить порт отладки в Tomcat, необходимо добавить опцию Java при запуске. Существует несколько способов добавить порт отладки. Это зависит от способа запуска Tomcat. Необходимо сконфигурировать порт в зависимости от установки Tomcat и IDE.