Узел Initiate Attribute

Технический обзор и возможности

В IoT Logic, Initiate Attribute узел преобразует показания устройства, создавая новые данные-атрибуты на основе входящей телеметрии. Этот узел позволяет манипулировать данными с помощью математических формул, переименовывать существующие параметры и выполнять побитовые операции с использованием Navixy Expression Language. Узел служит ключевым компонентом в потоке, позволяя обогащать данные перед отправкой в целевые системы.

Initiate Attribute узел настраивается для каждого потока в интерфейсе платформы Navixy. Для конкретных вариантов синтаксиса и подробной справки по языку выражений см. Navixy Expression Language в пользовательской документации.

Интеграция в архитектуру потока

Initiate Attribute узел функционирует в архитектуре потока, обеспечивая возможности трансформации данных и предоставляя:

• Обработку сырой телеметрии в значимые бизнес-показатели

• Создание вычисляемых полей на основе нескольких значений параметров

• Преобразование единиц измерения (например, километры в мили)

• Вычисление разниц между текущими и предыдущими показаниями

• Генерацию временных аналитик поведения устройства

Узел Initiate attribute требует как минимум один Data Source узел, подключенный к нему. Без входных подключений данных расчеты выполняться не будут.

Возможности узла

Узел Initiate Attribute сам по себе предлагает:

• Преобразование атрибутов данных: Создавайте полностью новые атрибуты, применяя математические операции к тем, что поступают из источников данных

• Преобразование единиц: Конвертируйте единицы измерения (например, скорость из km/h в mph, или температуру из °C в °F)

• Временные вычисления: Сравнивайте текущие показания с предыдущими значениями для определения изменений

• Манипуляции со временем: Настраивайте метки времени для момента создания атрибута на устройстве и момента получения его сервером, чтобы избежать несоответствий временной шкалы и унифицировать форматы времени

Параметры конфигурации

Initiate Attribute узел позволяет определить, как параметры устройства преобразуются в атрибуты, которые будут доступны для дальнейшей обработки в вашем потоке данных.

Рассмотрим, какие элементы использует этот узел и что вы можете настроить при работе с ним:

Шаги конфигурации

1

Укажите Имя узла

Введите описательное имя, чтобы подчеркнуть назначение узла. Используйте имя, которое поможет вам идентифицировать выполняемые в этом узле вычисления; оно будет отображаться в диаграмме потока для удобной идентификации.

2

Переключите Указать временные атрибуты

если вам нужно манипулировать метками времени событий, это включает две дополнительные опции:

• Время генерации: Когда данные были созданы (по умолчанию now())

• Время сервера: Когда данные были получены IoT Logic (по умолчанию now())

3

Определите Имя атрибута

Добавьте отличительный идентификатор атрибута.

• Это имя будет отображаться в Data Stream Analyzer,

• Вы также можете использовать это имя для создания пользовательских датчиков в модуле Tracking . Для этого узел, содержащий этот атрибут, должен быть подключен к Initiate Attribute По умолчанию выходной конечной точке Default Output Endpoint узлу.

4

Определите Формула

Добавьте математические выражения для вычисления значений атрибутов.

• Используйте value('parameter_name' 0, 'valid') формат для ссылки на существующие параметры устройства. Примечание. Нажмите внутри Формула поля, чтобы открыть список доступных атрибутов и выбрать нужный. Он будет автоматически добавлен в поле в готовом к использованию формате. Подробнее о автозаполнении имен атрибутов см. Автозаполнение имен атрибутов.

• Применяйте математические операции на основе Navixy IoT Logic Expression Language для преобразования значений.

• Используйте различные значения индекса глубины для доступа к историческим значениям (по умолчанию 0).

5

(необязательно) Нажмите Добавить атрибут

Откроется диалог конфигурации нового атрибута. Здесь вы можете создать новый атрибут данных, если требуется выполнить несколько вычислений в одном узле.

Рассмотрим практический пример настройки атрибутов:

В этом примере мы создаем атрибут, который преобразует скорость из километров в мили в час, разделив параметр скорости CAN на 1.609.

Для подробностей о вычислениях для новых атрибутов см. Примеры вычислений.

Также вы можете найти подробный пример использования вычисляемых атрибутов в потоке в разделе Пример конфигурации потока → шаги 3 и 4.

Параметры отображения

Новые атрибуты, вычисленные внутри Initiate Attribute узла, можно мониторить так же, как и реальные атрибуты данных, поступающие от устройств, в Data Stream Analyzer (DSA) и модуле Tracking module.

Для получения дополнительной информации о параметрах отображения см. Отображение новых вычисляемых атрибутов на платформе Navixy.

Особенности потока данных

После настройки вашего Initiate Attribute узла убедитесь, что вы:

1. Подключили узел хотя бы к одному Data Source узлу в качестве входа

2. Подключили выход к Выходной конечной точке узлу, чтобы отправлять преобразованные данные

Внутри Initiate Attribute узла значения параметров обрабатываются согласно вашим выражениям каждый раз, когда устройство передаёт данные. На выходе вы получите:

• Все исходные параметры устройства

• Все вычисленные атрибуты с их значениями

• Обновлённые значения времени генерации и времени сервера согласно настройкам

Если вы используете то же имя для вычисляемого атрибута, что и существующий параметр, атрибут заменит исходный параметр в выходном пакете данных.

Часто задаваемые вопросы

Могу ли я ссылаться на не-актуальные значения в своих вычислениях?

Да. Используйте параметр индекса в функции value, чтобы получить доступ к историческим значениям. Например, value('temperature', 1, 'valid') ссылается на предыдущие допустимое значение параметра temperature.

Как выполнять вычисления, связанные со временем?

Используйте функции genTime() и srvTime() для работы с временными метками. Вы можете вычислять разницы во времени, добавлять смещения времени или форматировать метки времени для отображения.

Что произойдет, если я удалю атрибут?

Атрибут больше не будет вычисляться для вновь получаемых данных, но исторические данные останутся без изменений. Атрибут не будет присутствовать в новых пакетах данных после удаления.

Могу ли я использовать атрибуты, созданные в одном узле Initiate attribute, в другом?

Да. Атрибуты, созданные ранее в потоке, можно ссылаться в последующих Initiate Attribute узлах, что позволяет выполнять многоступенчатые вычисления. Все созданные атрибуты также доступны с помощью функции автозаполнения чтобы обеспечить корректное именование.

Как избежать опечаток при ссылке на имена атрибутов в формулах?

Используйте функцию автозаполнения в поле Формула, чтобы выбирать из доступных атрибутов. Для подробных инструкций см. Автозаполнение имен атрибутов.