Wb-rules: различия между версиями

Материал из Wiren Board
Строка 18: Строка 18:
== Как создавать и редактировать правила == <!--T:3-->
== Как создавать и редактировать правила == <!--T:3-->


<!--T:4-->
Правила хранятся на контроллере в папке <code>/etc/wb-rules/</code>, поэтому вы можете [[Просмотр файлов контроллера с компьютера|редактировать и загружать напрямую с компьютера]] или использовать [[Wiren Board Web Interface | веб-интерфейс]], вкладка '''Rules'''.
*Список файлов с правилами находится на странице ''Rules'' веб-интерфейса. Они хранятся на контроллере текстовыми файлов в папке <code>/etc/wb-rules/</code>, поэтому [[Просмотр файлов контроллера с компьютера|их можно редактировать и загружать напрямую с компьютера]].


*Для редактирования правила нажмите на название файла.
Если в правиле нет ошибок, оно начинает работать сразу после сохранения файла.
*Для создания нового правила, нажмите на ''New...'', вверху введите название (латинские буквы и цифры, в качестве расширения укажите ''.js''), в основное поле введите текст скрипта, и нажмите ''Save'' вверху.
 
*Правило начинает сразу работать после сохранения, если в нём нет ошибок.
Подробнее о создании правил и возможностях wb-rules, читайте в [https://github.com/wirenboard/wb-rules документации на Github].
*В одном файле можно хранить неограниченное количество правил. Но обычно в одном файле хранятся правила с близкими функциями.


== Как писать правила ==
== Как писать правила ==

Версия 13:43, 19 января 2022

Редактирование правил в веб-интерфейсе

Описание

Wb-rules это возможность писать правила на языке JS. В первую очередь нужно понимать что такое JS. Знать синтаксис, как происходит работа с функциями, переменными и основными языковыми конструкциями. Подробнее про язык можно узнать в официальном учебнике https://learn.javascript.ru/

Однако, если вы не готовы программировать, возможно вам стоит попробовать создавать правила в среде Node-RED.

Если ваше правило не работает или показывает красным строку и вы не понимаете причину, то возможно вы можете получить дополнительную информацию в Системном журнале, который можно отфильтровать по имени сервиса — wb-rules.

Версии wb-rules и совместимость скриптов

Существует две версии движка:

  • wb-rules 1.7 — устаревшая версия, поддерживаются контроллеры Wiren Board 5 и 6.
  • wb-rules 2.0 — актуальная версия, поддерживаются контроллеры Wiren Board 6 и 7.

Если у вас контроллер Wiren Board 6 из первых партий и вы переходите с версии 1.7 на 2.0, то прочитайте статью Совместимость скриптов — в ней мы описали возможные проблемы и пути решения.

Как создавать и редактировать правила

Правила хранятся на контроллере в папке /etc/wb-rules/, поэтому вы можете редактировать и загружать напрямую с компьютера или использовать веб-интерфейс, вкладка Rules.

Если в правиле нет ошибок, оно начинает работать сразу после сохранения файла.

Подробнее о создании правил и возможностях wb-rules, читайте в документации на Github.

Как писать правила

Описание смотрите в статье Как писать правила.

Так же вам поможет статья Написание скриптов для начинающих.

Для для полного понимания стоит прочитать Полное описание движка правил.

Примеры правил

Примеры правил смотрите:

API сценариев wb-rules

API_сценариев_wb-rules