Вычисление атрибута

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

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

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

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

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

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

• обработку необработанных данных телеметрии в значимые бизнес-метрики

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

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

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

• формирование временных аналитических данных о поведении устройства

Узел «Вычисление атрибута» требует как минимум одного Источник данных узла, подключенного к нему. Без входных подключений данных вычисления не будут выполняться.

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

Вкладка Вычисление атрибута Сам по себе узел предлагает:

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

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

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

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

• Поиск зоны: Запишите имя зоны, в которой находится устройство, в атрибут с geofenceName(), платной опцией. См. Функции зон

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

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

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

Шаги настройки

1

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

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

2

Задайте имя атрибута

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

• Это имя будет отображаться в Анализ данных,

• Вы также можете использовать это имя для создания пользовательских датчиков в разделе «Мониторинг» модуле. Для этого Вычисление атрибута узел, содержащий этот атрибут, должен быть подключен к Узел передачи данных узлу, настроенному в режиме Узел передачи данных по умолчанию .

3

Задайте формулу

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

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

• Применяйте математические операции на основе язык выражений Navixy IoT Logic чтобы преобразовывать значения.

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

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

4

(необязательно) Добавьте еще атрибуты

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

5

Сохраните конфигурацию узла

Нажмите Примените изменения чтобы завершить создание узла.

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

Этот пример создает атрибут, который преобразует скорость из километров в мили в час, деля параметр скорости CAN на 1,609.

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

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

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

Новые атрибуты, вычисленные внутри Вычисление атрибута узла, можно отслеживать так же, как и фактические атрибуты данных, поступающие от устройств, в Анализ данных (DSA) и разделе «Мониторинг» модуль.

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

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

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

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

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

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

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

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

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

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

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

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

Могу ли я ссылаться в расчетах на не самые последние значения?

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

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

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

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

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

Могу ли я использовать атрибуты, созданные в одном узле «Вычисление атрибута», в другом?

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

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

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

Почему один из моих вычисляемых атрибутов иногда отсутствует?

Не удалось вычислить формулу для этих пакетов, чаще всего потому, что значение, которое она считывает, отсутствовало в пакете. Тогда у атрибута нет значения, и ошибка не сообщается. См. Отсутствующие значения в выражениях.