02 Группа “Общие”. Описание узлов
Узел Запуск
Вбрасывает сообщение в поток вручную или через равные промежутки времени. Данные в сообщении могут быть различных типов, включая строку, объект JavaScript или метку текущего времени.
Выводит:
payloadразные – настроенные данные сообщения.topicстрока – необязательное свойство темы сообщения, которое можно настроить в узле.
Узел Запуск может инициировать выполнение потока с определенными данными (значение payload). Данные по умолчанию – это метка текущего времени в миллисекундах, прошедших с 1 января 1970 года.
Узел также поддерживает вывод строк, чисел, логических значений, объектов JavaScript или значений потоковых/глобальных контекстов.
По умолчанию узел запускается вручную при нажатии его кнопки в редакторе. Его также можно настроить на автоматический запуск через равные промежутки времени или по расписанию.
Он также может быть настроен однократный вброс сообщения при каждом (пере)запуске потоков.
Максимальный интервал, который можно указать, составляет около 596 часов / 24 дней. Однако если Вам нужны интервалы, превышающие один день, Вам следует рассмотреть возможность использования функций планировщика в узле, которые смогут корректно работать с перебоями электроэнергии и перезапусками.
В параметрах “с интервалом в промежутке” и “в определенное время” используется стандартная система “cron”. Это означает, что “20 минут” будут в следующем часу, 20 минут спустя и 40 минут спустя - а не через 20 минут. Если нужен вброс сообщений каждые 20 минут - используйте параметр “с интервалом”.
Чтобы включить многострочный текст в строковое значение, необходимо использовать узел Функция для формирования данных.
Узел Отладка
Отображает выбранные свойства получаемых узлом сообщений на боковой панели во вкладке отладки и, при необходимости, журнале среды выполнения. По умолчанию отображается содержимое msg.payload, но узел можно настроить на отображение любого свойства, всех свойств сообщения или результата выражения JSONata.
Вкладка отладки на боковой панели обеспечивает структурированное представление полученных узлом сообщений, что упрощает исследование их структуры.
Объекты и массивы JavaScript могут быть свернуты и развернуты по мере необходимости. Буферы могут отображаться в виде данных как есть или в виде строки, когда это возможно.
Рядом с каждым сообщением отладочная панель показывает информацию о времени получения сообщения, узле, который его отправил, и типе данных. Нажатие на идентификатор узла-источника покажет этот узел в рабочей области.
Кнопка на узле может использоваться для включения или отключения вывода информации о получаемых сообщениях. Рекомендуется отключать или удалять любые отладочные узлы, которые не используются.
Узел также может быть настроен на отправку всех сообщений в журнал выполнения или отправку короткого (32 символа) текста в статус под узлом.
Узел Завершение
Инициирует запуск потока, когда другой узел завершает обработку сообщения.
Если узел сообщает среде выполнения о завершении обработки сообщения, этот узел можно использовать для запуска второго потока.
Например, его можно использовать вместе с узлом, у которого нет выходного порта, таким как узел Email, для продолжения потока.
Этот узел должен быть настроен на отслеживание событий выбранных узлов в потоке. В отличие от узла Отлов ошибок, у него нет режима Обрабатывать все для автоматического применения ко всем узлам в потоке.
Не все узлы могут инициировать запуск потока по завершению обработки сообщения. все зависит от того, была ли в них реализована поддержка этой функции, добавленной в Luxms Data Boring, или нет.
Узел Отлов ошибок
Ловит ошибки, выбрасываемые узлами на той же вкладке.
Выводит:
error.messageстрока – сообщение об ошибке.error.source.idстрока – идентификатор узла, выдавшего ошибку.error.source.typeстрока – тип узла, выдавшего ошибку.error.source.nameстрока – имя узла, выдавшего ошибку, если было настроено.
Если узел выбрасывает ошибку во время обработки сообщения, поток обычно останавливается. Этот узел можно использовать для отлова и обработки таких ошибок с помощью отдельного потока.
По умолчанию узел будет отлавливать ошибки, генерируемые любым узлом на той же вкладке. По желанию он может быть нацелен на определенные узлы или настроен на перехват только тех ошибок, которые не были перехвачены ‘нацеленным’ Отлов ошибок узлом.
Когда выдается ошибка, все соответствующие Отлов ошибок узлы получат сообщение.
Если ошибка выбрасывается в подпотоке, она будет обработана любыми Отлов ошибок узлами внутри подпотока. Если таковых нет, ошибка будет распространена до вкладки, на которой находится экземпляр подпотока.
Если сообщение уже имеет свойство error, оно копируется в _error.
Узел Статус
Инициирует запуск потока при изменении статуса других узлов на той же вкладке.
Выводит:
status.textстрока – текст статуса.status.source.typeстрока – тип узла, сообщившего о статусе.status.source.idстрока – идентификатор узла, сообщившего о статусе.status.source.nameстрока – имя узла, сообщившего о статусе, если настроено.
Этот узел не создает payload данные.
По умолчанию узел сообщает о статусах всех узлов на той же вкладке в рабочей области. Его можно настроить на выборочное отслеживание статуса только отдельных узлов.
Узел Связь (вход)
Создает виртуальный провод между потоками.
Этот узел может быть подключен к любому Связь (выход) узлу на любой вкладке. После подключения они ведут себя так, как если бы они были соединены вместе обычным проводом.
Связи между Связь-узлами отображаются, только когда выбран один из соединенных Связь-узлов. Если есть какие-либо провода, ведущие на другие вкладки, они отображаются в виде виртуального узла, по которому можно кликнуть, чтобы перейти на соответствующую вкладку.
Провод не может вести внутрь подпотока или изнутри подпотока наружу.
Узел Задать связь
Вызывает поток, который начинается с узла Связь (вход) и передает ответ.
Этот узел может быть подключен к узлу Связь (вход), который существует в любом потоке. Поток, подключенный к этому узлу, должен заканчиваться узлом Связь (выход), настроенным в режиме Вернуть к вызывающему узлу.
Когда этот узел получает сообщение, оно передается к подключенному узлу Связь (вход). Затем он ждет ответа, который затем отправляет.
Если в течение настроенного тайм-аута (по умолчанию 30 секунд) ответ не получен, узел регистрирует ошибку, которую можно перехватить с помощью узла Отлов ошибок.
Узел Связь (выход)
Создает виртуальный провод между потоками.
Узел может быть подключен к любому Связь (вход) узлу на любой вкладке. После подключения они ведут себя так, как если бы они были соединены вместе обычным проводом.
Связи между Связь-узлами отображаются, только когда выбран один из соединенных Связь-узлов. Если есть какие-либо провода, ведущие на другие вкладки, они отображаются в виде виртуального узла, по которому можно кликнуть, чтобы перейти на соответствующую вкладку.
Провод не может вести внутрь подпотока или изнутри подпотока наружу.
Узел Комментарий
Узел, который можно использовать для добавления комментариев к вашим потокам.
Окно редактирования поддерживает синтаксис Markdown. Текст будет отображен на информационной вкладке боковой панели в секции Описание.