Создание сценария
Откройте раздел Логика и нажмите Создать над списком сценариев. В более ранних версиях платформы этот раздел называется Сценарии.
💡
Версия редактора. Работа с карточками и линиями ниже описана для RIC Web 3.13.4, доступной на dev.rightech.io. На установках с более ранней версией расположение кнопок и набор настроек могут отличаться.
Если вы впервые создаёте сценарий, начните с последовательности от создания до запуска. Настройка сетки и перестроение линий описаны отдельно в разделе «Сетка и линии переходов».
Заполните следующие поля:
- Имя — наименование сценария;
- Описание — подробная характеристика сценария, заполняется при необходимости.
Выберите тип:
- По кросс-элементам – в таком сценарии автоматизации используются кросс-элементы – абстрактные параметры, которые можно создать непосредственно в сценарии, не привязываясь к какой-то определенной модели. Сценарий, построенный на кросс-элементах, является переиспользуемым компонентом, который можно применить к объектам с разными моделями, предварительно сопоставив кросс-элементы и параметры из модели объекта, на котором необходимо запустить сценарий;
- По параметрам из модели – такой сценарий автоматизации формируется на базе конкретной выбранной модели. Если сценарий будет включать в себя взаимодействие между несколькими объектами, выберите те модели, которые соответствуют этим объектам.
💡
Ранее все сценарии автоматизации строились на жесткой связи сценария автоматизации и модели. Такой подход себя исчерпал,
так как приводил к размножению однотипных решений и усложнял развитие проектов. Теперь основным механизмом построения
сценариев автоматизации являются кросс-элементы. Создание сценариев автоматизации с типом данных По параметрам из
модели официально считается устаревшим, но продолжает временно поддерживаться в рамках обратной совместимости.
Также вы можете импортировать готовый сценарий в виде файла или по ссылке.
Нажмите кнопку Создать. Перед вами откроется новый сценарий с минимальным набором элементов в рабочей области.
Рабочая область
На схеме состояния обозначены серыми карточками, а события переходов — голубыми блоками на соединяющих линиях. Стрелка указывает состояние, в которое ведёт переход.
| Элемент | Для чего нужен |
|---|---|
| Добавить состояние, кнопка «+» слева | Добавить состояние на схему |
| Сохранить | Записать изменения сценария на сервер |
| Показать / скрыть сетку | Изменить видимость сетки, сохранив привязку к ней |
| Подвижные связи | Разрешить перестроение соседних линий при перемещении блока перехода; по умолчанию выключено |
| Автотрассировка сценария | Заново рассчитать линии и расположение блоков переходов после подтверждения |
| Экспорт | Скачать сценарий в JSON |
| На весь экран | Развернуть редактор |
| Миникарта и масштаб | Перемещаться по большой схеме и менять её масштаб |
Для перемещения по холсту нажмите и удерживайте колесо мыши. Миникарту можно свернуть кнопкой в её правом верхнем углу.
Начало и завершение
Зелёный круг обозначает начальное состояние. Из него выходит только один переход — Инициализация логики. Он срабатывает при запуске сценария. Если нужно изменить первое рабочее состояние, перетащите точку существующей связи к нужному состоянию: начальный круг останется её источником.
Красный круг внутри кольца обозначает конечное состояние. Попадание в него завершает выполнение сценария. Исходящие переходы из конечного состояния недоступны. В циклическом сценарии конечное состояние можно не использовать.
Сохранение и изменения в другой вкладке
Сохраняйте схему кнопкой Сохранить или сочетанием Ctrl+S. Изменения на холсте, включая перемещение блоков и линий, нужно сохранить перед закрытием или перезагрузкой страницы.
💡
Запущенный сценарий продолжает работать в прежней версии. После сохранения изменений перезапустите его на нужных объектах. Сохранение схемы само по себе не перезапускает выполнение.
Если сценарий изменён в другой вкладке или другим пользователем, появится уведомление с предложением загрузить обновления. Сохранение текущего черновика блокируется. Загрузка заменит открытый вариант серверным; при наличии несохранённых изменений редактор запросит подтверждение. До подтверждения проверьте, какие изменения вам нужно сохранить отдельно.
Добавление состояния
- Нажмите Добавить состояние — кнопку «+» в левом верхнем углу холста.
- Щёлкните по карточке или нажмите кнопку редактирования в её всплывающей панели.
- Укажите имя и при необходимости описание. У новых состояний показ описания включён по умолчанию.
Карточку можно перемещать, а её размер — менять за нижний правый угол. Название находится вверху. Описание занимает доступное место: длинный текст обрезается с многоточием, без полосы прокрутки. Полный текст можно прочитать в настройках состояния.
В пустом состоянии нет строк действий. Они появляются после добавления первого действия на входе или выходе. Кнопка удаления состояния находится во всплывающей панели; вместе с состоянием удаляются его действия и все входящие и исходящие переходы. Редактор предупреждает об этом перед удалением.
Действия в состояниях
- Наведите указатель на карточку состояния, чтобы открыть панель кнопок над её правым краем.
- Нажмите зелёную кнопку действий при входе или оранжевую кнопку действий при выходе. Подсказка при наведении помогает выбрать нужную кнопку.
- Найдите действие в списке и выберите его. Длинный список прокручивается внутри окна выбора.
- Окно выбора закроется, а справа останется панель настройки выбранного действия. Заполните необходимые поля.
- Для следующего действия снова откройте список соответствующей кнопкой. Если группа При входе или При выходе уже видна на карточке, можно нажать её заголовок: при наведении рядом появляется «+».
Действия при входе выполняются при переходе в состояние, действия при выходе — при выходе из него. Уже добавленное действие можно выбрать для редактирования, удалить или переместить в списке, чтобы изменить порядок выполнения.
Действия разделены на группы:
- Действия сценария: изменение значения, генерация события, изменение статуса, управление таймерами и планировщиками.
- Регистрация событий: сообщения, HTTP-запросы, e-mail, SMS, Discord и Телеграм.
- Действия объекта: команды, добавленные через кросс-элементы или выбранные из модели.
💡
Повторное выполнение действия. Одно и то же действие можно добавить только один раз в каждую группу одного состояния. Если его нужно выполнить повторно, используйте другое состояние. При соединении состояний мгновенными переходами учитывайте защиту от слишком частых переходов.
Изменить значение
Если в ходе выполнения сценария необходимо изменять или заполнять значение каких-то параметров состояния, конфигурации
или статуса, созданных в кросс-элементах, воспользуйтесь действием Изменить значение.
Эта команда предусматривает следующие функции:
- прочитать параметр из конфигурации/состояния/статуса и записать его в исходном виде в другой параметр из
конфигурации/состояния/статуса. Прочитанное значение записывается в виде переменной
$value;
💡
При изменении значения параметра в состоянии объекта меняется только визуальная информация по этому параметру в
интерфейсе объекта. На подключенном к этому объекту устройстве в этот момент никаких изменений не происходит.
- прочитать параметр из конфигурации/состояния/статуса, выполнить над ним некоторое выражение и записать полученное
значение в параметр из конфигурации/состояния/статуса. Доступны простые арифметические операции:
+,-,*,/;
- задать какое-то значение в выражении и записать его в параметр из конфигурации/состояния/статуса.
В случае изменения значения статуса в поле Выполнить выражение укажите название статуса из списка возможных
статусов, заданных для модели объекта.
Сгенерировать событие
Для того чтобы сгенерировать в сценарии событие, созданное в кросс-элементах, добавьте действие Сгенерировать событие.
Заполните следующие поля:
- Событие – выберите одно из созданных в кросс-элементах событий;
- Payload (Данные) – дополнительно можно указать какие-то сведения о событии и обрабатывать их, если предполагается, что события также получает внешняя система, подключенная по WebSocket.
Изменить статус
Действие Изменить статус является частным случаем действия Изменить значение и позволяет изменить статус объекта, на
котором будет выполняться сценарий автоматизации. Для этого в поле Изменить значение укажите идентификатор статуса из
списка возможных статусов, заданных для модели объекта.
Запустить/остановить таймер №...
Запуск таймера позволяет настроить срабатывание события по истечении определенного времени. Для того чтобы задать время,
добавьте в состояние действие Запустить таймер. Справа появится форма, в которой можно задать значение таймера
следующими типами:
- Число – впишите в поле Значение число, соответствующее количеству секунд, минут, часов или суток, через которое таймер должен сработать;
- Параметр – выберите параметр, созданный в кросс-элементах, значение которого будет использовано для таймера;
- Конфигурация – выберите параметр конфигурации, созданный в кросс-элементах, значение которого будет использовано для таймера.
Когда истечет время, указанное в таймере, будет сгенерировано событие Сработал
таймер, которое можно использовать в переходах.
Работа таймера, как и работа планировщика, распространяется на весь сценарий автоматизации, а не только на состояние в
котором он был запущен. Это значит, что он сработает независимо от того, находится ли сейчас сценарий в состоянии, где
вы запустили таймер, или в любом другом.
Действие Остановить таймер останавливает работу таймера.
Запустить/остановить планировщик №...
Запуск планировщика позволяет настроить срабатывание события в определенное время. Для того чтобы задать дату и время,
добавьте в состояние действие Запустить планировщик. Справа появится боковая панель, на которой заполните следующие
поля:
-
Часовой пояс – заполнен по умолчанию часовым поясом, настроенным в личном кабинете платформы, может быть изменен;
-
Тип:
-
Простой – выбирается только день недели;
-
Расширенный – выбирается месяц, день недели, день;
-
-
Месяц (для расширенного);
-
День недели;
-
День (для расширенного).
| Простой | Расширенный |
|---|---|
Далее выберите время срабатывания. Точное и интервальное время настраиваются
независимо друг от друга и работают параллельно:
-
Точное время – планировщик сработает в определенное время. Например, если вы укажете 13:15, то событие Сработал планировщик произойдет ровно в 13:15:00;
-
Интервальное время – позволяет выбрать промежуток времени и периодичность срабатывания в рамках этого интервала. Например, если вы выберете промежуток с 13:00 до 14:00 и интервал Каждые 2 минуты, то планировщик сработает в 13:00:00, 13:02:00, 13:04:00, …
Для проверки ближайшего времени срабатывания планировщика нажмите кнопку
Узнать. Это поможет вам проверить корректность составления сложного
планировщика.
Каждый раз при наступлении времени, которое подходит под шаблон, заданный в
планировщике, будет генерироваться событие Сработал планировщик, которое
можно использовать в переходах.
Работа планировщика, как и работа таймера, распространяется на весь сценарий автоматизации, а не только на состояние в
котором он был запущен. Это значит, что он сработает независимо от того, находится ли сейчас сценарий в состоянии, где
вы запустили планировщик, или в любом другом.
Действие Остановить планировщик останавливает работу планировщика.
Показать сообщение
Отправка сообщений позволяет следить за текущими изменениями, происходящими при исполнении сценария автоматизации. Если
добавить данную команду на вход в какое-либо состояние, то при переходе объекта в данное состояние система отправит
сформированное уведомление. Оно проинформирует о том, что совершилось определенное событие, вследствие которого объект
теперь находится в данном состоянии.
Формирование сообщений
Для формирования сообщения добавьте в состояние действие Показать сообщение. Справа появится боковая панель, на которой
выберите степень важности сообщения:
- Информационное;
- Важное;
- Критическое.
Если необходимо проинформировать о совершении какого-либо перехода или события, то тогда достаточно указать сообщение
как информационное. Если же уведомление играет более значительную роль, например, зарегистрировано какое-то отклонение
от нормы или нарушение, то имеет смысл повысить важность сообщения.
💡
Для работы с сообщениями уровня Критическое предусмотрена возможность включения дополнительных оповещений в
разделе Профиль.
Далее заполните содержимое сообщения. Текст сообщения формируется в произвольном виде, его формат строго не
регламентирован. Однако желательно, чтобы он был коротким и информативным для удобного отображения на платформе.
Помимо описательной информации о произошедшем событии, в сообщении можно передать дополнительные параметры. Для этого
нажмите кнопку Добавить параметр и выберите параметры, значения которых необходимо добавить в сообщение.
В зависимости от уровня вложенности параметра будут появляться дополнительные выпадающие списки. При выборе параметра из
большого списка кросс-элементов удобно пользоваться поиском.
После выбора необходимой информации нажмите кнопку Применить. После этого вы увидите, что в тексте сообщения появится
конструкция в фигурных скобках. Например,
{{object.state["humidity"]}}, {{object.name}} и т.д.Тогда содержимое уведомления может быть сформировано, например, следующим образом:
{
"event": "Good conditions",
"temperature": {{object.state["temperature"]}}
}В тексте сообщения вместо
{{object.state["temperature"]}} будет подставлено текущее значение параметра, соответствующего
кросс-элементу с идентификатором temperature.Отображение и просмотр сообщений
Отправленные сообщения показываются в правой боковой панели сообщений.
1 – Кнопка для открытия/закрытия панели сообщений. При наличии непрочитанных сообщений выглядит так
2 – Фильтр по времени получения: можно отобразить сообщения, которые были получены в следующие периоды: 1 час назад,
Сегодня, Вчера, 1 неделя назад. Также можно задать свой интервал времени получения, нажав кнопку Выбрать период.
Обратите внимание, что между началом и концом периода может быть интервал не более 30 дней
3 – Фильтр по степени важности: можно отобразить сообщения с уровнем Критические, Важные и Информационные. При этом каждый уровень идентифицируется своим цветом: красным, желтым или зеленым соответственно
4 – Группировка сообщений по имени объекта или тексту сообщения
5 – Строка поиска сообщения по имени объекта или по тексту сообщения
6 – Количество непрочитанных сообщений и общее количество сообщений, полученных за выбранный период с учетом установленных фильтров
7 – Дата и время получения сообщения
8 – Имя объекта, к которому относится данное сообщение
9 – Содержимое сообщения
10 – Если кликнуть на сообщение, то оно полностью отобразится чуть левее боковой панели, будет помечено как прочитанное и исчезнет из списка сообщений
11 – Время получения сообщения. Нажмите на него, чтобы перейти в истории объекта к пакету данных, полученному в этот момент времени. Если в это время не было получено данных, откроется первый пакет данных в истории объекта за период Сегодня
12 – Очистка списка непрочитанных сообщений с учетом установленных фильтров
3 – Фильтр по степени важности: можно отобразить сообщения с уровнем Критические, Важные и Информационные. При этом каждый уровень идентифицируется своим цветом: красным, желтым или зеленым соответственно
4 – Группировка сообщений по имени объекта или тексту сообщения
5 – Строка поиска сообщения по имени объекта или по тексту сообщения
6 – Количество непрочитанных сообщений и общее количество сообщений, полученных за выбранный период с учетом установленных фильтров
7 – Дата и время получения сообщения
8 – Имя объекта, к которому относится данное сообщение
9 – Содержимое сообщения
10 – Если кликнуть на сообщение, то оно полностью отобразится чуть левее боковой панели, будет помечено как прочитанное и исчезнет из списка сообщений
11 – Время получения сообщения. Нажмите на него, чтобы перейти в истории объекта к пакету данных, полученному в этот момент времени. Если в это время не было получено данных, откроется первый пакет данных в истории объекта за период Сегодня
12 – Очистка списка непрочитанных сообщений с учетом установленных фильтров
💡
При появлении новых сообщений, которые не проходят по выставленному фильтру или критерию поиска, настраиваемая часть
боковой панели на короткое время выделяется красным цветом.
Варианты группировок сообщений:
- Не группировать – отсутствие группировки, сообщения отображаются полным списком;
- По объекту – для каждого объекта все оповещения будут собраны в единую группу. Слева внизу в карточке группы отображается количество сообщений для этого объекта;
- По тексту сообщения – уведомления с одинаковым текстом сообщения будут собраны в единую группу. Слева внизу в карточке группы отображается количество сообщений с одинаковым текстом.
💡
Если вы удалите объект, то сообщения, полученные для него, все еще будут отображаться в списке сообщений, но вместо
имени объекта будет знак вопроса. Раскройте содержимое сообщение, кликнув по нему. Так вы увидите идентификатор
удаленного объекта и при необходимости сможете загрузить их по API.
Отправить HTTP-запрос
Если в ходе выполнения сценария автоматизации необходимо передавать или, наоборот, загружать данные из стороннего
сервиса (мобильные и веб-приложения, CRM и ERP-системы и т.д.), воспользуйтесь отправкой HTTP-запросов. Такой запрос
подразумевает под собой отправку информации во внешний сервис посредством использования технологий протокола HTTP.
💡
На отправку HTTP-запросов есть ограничение: один запрос в секунду с одного объекта.
Для формирования запроса добавьте в состояние команду Отправить HTTP-запрос.
Справа появится боковая панель, на которой заполните следующие поля:
-
Метод запроса:
-
GET – получение данных из указанного ресурса;
-
POST – отправка данных ресурсу;
-
PUT – размещение данных на ресурсе целиком;
-
PATCH – аналогичен PUT, но применяется только к некоторому фрагменту данных;
-
DELETE – удаление данных из ресурса;
-
-
URL – адрес, на который будет отправлен запрос;
-
Заголовки – позволяют учесть особенности представления и передачи данных серверу. Здесь могут быть заданы параметры авторизации, язык содержимого сообщения, форматы сообщения, требуемые на стороне клиента или сервера, сведения о проведении соединения и т.д.;
-
Тело сообщения – непосредственно данные. Данное поле является необязательным.
Например, вы можете отправлять HTTP запросы из сценария автоматизации в Telegram, используя Telegram API.
Отправить e-mail
Если в ходе выполнения сценария автоматизации необходимо отправлять электронные письма по определенным адресам,
воспользуйтесь отправкой e-mail. Для того чтобы настроить параметры отправки, добавьте в состояние действие Отправить
e-mail. Справа появится боковая панель, на которой заполните следующие поля:
-
SMTP сервер (обязательное поле) – сервер исходящей почты, с которого будет отправлено электронное письмо по протоколу SMTP. Подробнее о создании SMTP сервера >>>
-
Отправитель (обязательное поле) – адрес, с которого будет отправлено письмо;
-
Получатели (обязательное поле) – адрес, на который будет отправлено письмо, можно указать несколько адресов через запятую;
-
Тема (обязательное поле) – тема письма;
-
Содержимое (текст) – текст сообщения;
-
Содержимое (html) – текст сообщения в HTML-разметке. Если данное поле заполнено, то поле Содержимое (текст) игнорируется.
Отправить SMS
Если в ходе выполнения сценария автоматизации необходимо отправлять SMS-сообщения по определенным номерам,
воспользуйтесь отправкой SMS. Для того чтобы настроить параметры отправки, добавьте в состояние действие Отправить SMS.
Справа появится боковая панель, на которой заполните следующие поля:
-
SMPP сервер (обязательное поле) – сервер для отправки SMS-сообщения по протоколу SMPP;
-
Получатели (обязательное поле) – номер, на который будет отправлено письмо, можно указать несколько номеров через запятую;
-
Текст – текст сообщения.
Отправить сообщение в Discord
Если в ходе выполнения сценария автоматизации необходимо отправлять сообщения в определенный канал Discord посредством
вебхука, воспользуйтесь действием Отправить сообщение в Discord. Добавьте действие в состояние – справа появится
боковая панель, на которой заполните следующие поля:
- Интеграция (обязательное поле) – вебхук, созданный в Discord; Подробнее о создании интеграции с Discord >>>
- Сообщение – текст сообщения.
Отправить сообщение в Телеграм
Если в ходе выполнения сценария автоматизации необходимо отправлять сообщения в Telegram в группу, канал или личные
сообщения пользователю, воспользуйтесь действием Отправить сообщение в Телеграм.
Кросс-элементы с типом Действие
Любую команду, созданную в модели объекта, вы можете отправить из сценария автоматизации. Для этого в списке возможных
действий для состояния нажмите на плюсик в группе Действия объекта.
Справа появится боковая панель, на которой заполните следующие поля:
- Тип – автоматически подставится Действие без возможности изменения;
- Идентификатор – необходим для распознавания кросс-элемента в системе, должен быть уникален для текущего сценария автоматизации;
- Имя – название действия, отображаемое в интерфейсе сценария автоматизации;
- Описание – дает более полное представление о действии.
Нажмите Сохранить. Новое действие появится в списке.
Если необходимо внести изменения в данное действие, перейдите на вкладку Кросс-элементы. Вы увидите все созданные в этом
сценарии автоматизации кросс-элементы. Вы можете отредактировать любой кросс-элемент, удалить или создать новый.
💡
Так как кросс-элемент создается в общем, абстрактном виде, он не учитывает, что внутри действия из модели, с которым он
будет сопоставляться, могут быть включены дополнительные настройки подтверждения перед отправкой или указаны
дополнительные параметры. Такие команды отправляться из сценария автоматизация, построенного на кросс-элементах, не
будут. Чтобы отправить команду с функцией подтверждения или с дополнительными параметрами, воспользуйтесь действиями в
сценарии автоматизации с типом По параметрам из модели.
Команды из модели
Любую команду, созданную в модели, вы можете отправить из сценария автоматизации с типом По параметрам из модели. Для
этого в списке возможных действий для состояния найдите необходимую команду и добавьте ее в состояние. Появится боковая
панель, в которой можно увидеть полную информацию по этому действию. Справа от названия команды находится ссылка для
быстрого перехода к ней в дереве модели. Нажмите на нее, если необходимо что-то изменить в выбранной команде.
Если в команде включена настройка Требует подтверждения, то в информации о команде вы увидите соответствующее
предупреждение и переключатель Разрешить отправку с подтверждением из сценария. Включите его, если хотите, чтобы команда
отправлялась из сценария автоматизации.
В этом случае команда из сценария будет выполнена без дополнительного подтверждения.
Если переключатель останется выключенным, в редакторе данное действие будет помечено красной обводкой.
При работе сценария автоматизация такая команда не будет отправлена.
Также из сценария автоматизации, построенного по модели, можно отправлять команды с параметрами, которые задаются
непосредственно перед отправкой.
При выборе такой команды заполните эти параметры в форме редактирования действия.
Вы можете использовать эту же команду в других состояниях как с такими же, так и с другими параметрами.
Добавление перехода
- Наведите указатель на границу исходного состояния и потяните за точку выхода.
- Ведите линию к целевому состоянию. Линия отрисовывается во время движения, а выбранная точка стыковки подсвечивается.
- Отпустите кнопку мыши, когда точка пристыкована. Если подсветка стыковки сохраняется, связь завершится и при отпускании над карточкой или рядом с ней на холсте.
- В появившемся блоке нажмите Добавить событие и выберите событие-триггер.
Для изменения геометрии можно перемещать блок перехода или отдельные участки линии. Подробнее — «Сетка и линии переходов».
Имя и описание перехода
Откройте настройки щелчком по блоку или кнопкой редактирования в его всплывающей панели.
- Имя перехода — необязательное название. Если оно заполнено, на блоке показывается это имя; если поле пустое — название события. Имя не меняет событие, которое запускает переход.
- Описание — пояснение назначения перехода. У новых блоков показ описания включён. Текст переносится на строки и занимает доступную высоту; остаток обрезается с многоточием. Для полного текста откройте настройки.
- Показывать условие — управляет подписью под блоком, по умолчанию включено. Настройка доступна у обычных переходов, кроме инициализации.
- Событие перехода — событие-триггер. Через это поле можно выбрать другое событие.
💡
Скрытое условие продолжает проверяться. Переключатель «Показывать условие» меняет только вид схемы. Чтобы изменить логику перехода, отредактируйте само условие.
Редактирование условия
После выбора события нажмите кнопку условий в панели перехода. Если под блоком уже показан текст условия, его также можно нажать для редактирования.
В конструкторе выберите параметр, операцию сравнения и значение, с которым он сравнивается. При необходимости добавьте другие условия, выберите И или ИЛИ и нажмите Сохранить. Подробности и доступные типы сравнения — в разделе «Условия».
События
В переходе укажите событие, которое должно произойти для совершения перехода.
Базовые события
События, которые всегда есть в сценарии независимо от наличия кросс-элементов, поделены на две смысловые группы:
- События сценария:
-
Мгновенный переход – переход происходит сразу же при попадании в состояние, из которого он ведет;
-
Таймер №... – события в таймерах:
- Сработал таймер №… – переход происходит при срабатывании запущенного таймера;
-
Планировщик №... – события в планировщиках:
- Сработал планировщик №… – переход происходит при срабатывании запущенного планировщика.
- События объекта:
- Получены данные – переход происходит при получении пакета с данными;
- Редактирование объекта – переход происходит при сохранении изменений на вкладке объекта Редактирование;
- Смена статуса – переход происходит при смене статуса объекта;
- Геозоны – события в геозонах:
- Вход в геозону – переход происходит при входе в отслеживаемую геозоны;
- Выход из геозоны – переход происходит при выходе из отслеживаемой геозоны;
- Вход в комнату – переход происходит при входе в отслеживаемую комнату на схеме;
- Выход из комнаты – переход происходит при выходе из отслеживаемой комнаты на схеме;
- Постановка на маршрут – переход происходит при приближении к заданному маршруту следования на расстояние менее 50 метров;
- Отклонение от маршрута – переход происходит при отдалении от заданного маршрута следования более чем на 50 метров;
- Вход в контрольную точку – переход происходит при приближении к контрольной точке на маршруте на расстояние менее 50 метров;
- Выход из контрольной точки – переход происходит при отдалении от контрольной точки на маршруте более чем на 50 метров.
- Команды – события после отправки команды на объект:
- Команда выполнена – переход происходит, если выбранная в условии перехода команда завершится успешно;
- Команда не выполнена – переход происходит, если выбранная в условии перехода команда завершится с ошибкой. Например, такое событие может произойти, если устройство не ответило на команду согласно протоколу передачи данных или потеряло соединение с платформой.
При необходимости добавленное событие можно изменить. Для этого кликните на переход и нажмите на кнопку изменения
события. Появится выпадающий список для выбора необходимого варианта.
💡
Мгновенный цикл может привести к аварийной остановке. Если состояния без ожидания события снова и снова переходят друг в друга, срабатывает защита от слишком частых переходов. Как работает ограничение и как исправить сценарий.
Кросс-элементы с типом Событие
Любое событие, созданное в модели объекта, вы можете указать в переходе в сценарии автоматизации. Для этого в списке
возможных событий для перехода нажмите на плюсик в группе События объекта.
Справа появится боковая панель, на которой заполните следующие поля:
- Тип – автоматически подставится Событие без возможности изменения;
- Идентификатор – необходим для распознавания кросс-элемента в системе, должен быть уникален для текущего сценария автоматизации;
- Имя – название события, отображаемое в интерфейсе сценария автоматизации;
- Описание – дает более полное представление о событии.
Нажмите Сохранить. Новое событие появится в списке.
Если необходимо внести изменения в данное событие, перейдите на вкладку Кросс-элементы. Вы увидите все созданные в этом
сценарии автоматизации кросс-элементы. Вы можете отредактировать любой кросс-элемент, удалить или создать новый.
💡
При создании в модели своего события можно задать параметры, чтобы впоследствии, при получении такого события по API или
из другого сценария, вывести значения этих параметров в действиях регистрации событий. Но так как кросс-элемент
создается в общем, абстрактном виде, он не учитывает, что в событии в модели, с которым он будет сопоставляться, могут
быть указаны дополнительные параметры. Поэтому в сценарии автоматизации, построенном на кросс-элементах, не получится
использовать параметры из полученного события. Чтобы обработать параметры из события, воспользуйтесь событиями в
сценарии автоматизации с типом По параметрам из модели.
События из модели
Создайте собственное событие в модели, при необходимости указав дополнительные параметры.
Оно отобразится в списке событий для перехода.
Такие события можно получать из внешних систем по API или из других сценариев автоматизации, используя действие
Сгенерировать событие. Значения параметров события задавайте в формате JSON.
Если переход в какое-то состояние в вашем сценарии происходит по данному событию, вы можете использовать переданные в
нем значения параметров в действиях регистрации событий в этом состоянии. Для этого в соответствующем действии нажмите
кнопку Добавить параметр, затем задайте категорию параметров Событие последнего перехода и выберите нужные параметры
события, значения которых вы хотите передать в тексте сообщения.
💡
Чтобы событие появилось в списке событий последнего перехода, недостаточно просто создать его в модели. Нужно, чтобы по
этому событию был выполнен переход в состояние, где вы хотите вывести информацию о событии.
В тексте полученного сообщения будут подставлены переданные в событии параметры.
Условия
После выбора события дополнительно можно указать условие, при выполнении которого происходит переход.
Для формирования условия выберите параметр, значение которого необходимо проверить, из выпадающего списка.
💡
При выборе параметра из большого списка удобно пользоваться поиском.
Сравнивать параметры можно с
- точным значением – указывается числовое, строковое или логическое значение в соответствии с типом данных параметра;
- другим параметром – выбирается параметр для сравнения;
- уровнем – выбирается один из уровней, заданных в модели для параметра;
- конфигурационным значением – выбирается параметр с типом Конфигурация. Сравнивать с конфигурационными параметрами удобно в случаях, если логика работы сценария одинакова для разных объектов, но критерии срабатывания условий отличаются. Например, для спальной комнаты нормальными считаются одни показатели температуры, для кухни – другие. В этом случае не нужно создавать разные сценарии климат-контроля для этих помещений. Достаточно в конфигурации объектов создать параметры, обозначающие диапазоны нормальной температуры, задать соответствующие помещениям значения, а в сценарии сравнивать текущую температуру не с конкретными величинами, а с этими конфигурационными параметрами.
💡
Раздел Уровень появляется только в том случае, если сценарий автоматизации имеет тип По параметрам из модели и для
параметра, выбранного слева, в модели заданы уровни.
Раздел Конфигурация появляется только при наличии кросс-элементов с типом Конфигурация в сценарии автоматизации По
кросс-элементам или при наличии в модели узлов с типом Конфигурация в сценарии автоматизации По параметрам из модели.
Выберите операцию сравнения и после формирования условия нажмите кнопку Сохранить.
💡
Операция in работает для поиска вхождения значения параметра в массив чисел, а также для поиска подстроки в строке.
Операция not in
проверяет, что значение выбранного параметра не входит в массив или не
является подстрокой в строке.
В визуальном конструкторе одного перехода можно задать до четырёх условий. Переход может быть и без условия: тогда достаточно события-триггера. Их взаимодействие между собой сконфигурируйте с помощью
кнопок И и ИЛИ. При выборе И для выполнения перехода должны быть выполнены все условия, при выборе ИЛИ – любое из
указанных.
Если в списке возможных параметров еще нет необходимого кросс-элемента, вы можете создать его прямо из окна формирования
условий перехода. Для этого нажмите на кнопку Создать кросс-элемент.
Справа появится боковая панель, на которой заполните следующие поля:
- Тип – автоматически подставится Параметр без возможности изменения;
- Идентификатор – необходим для распознавания кросс-элемента в системе, должен быть уникален для текущего сценария автоматизации;
- Имя — название параметра, отображаемое в интерфейсе сценария;
- Описание — пояснение назначения параметра;
- Тип данных – в зависимости от типа данных параметра формируется список возможных операций сравнения.
Нажмите Сохранить. Новый параметр появится в списке.
Если необходимо внести изменения в данный параметр, перейдите на вкладку Кросс-элементы. Вы увидите все созданные в этом
сценарии автоматизации кросс-элементы. Вы можете отредактировать любой кросс-элемент, удалить или создать новый.
💡
Также вы можете создавать кросс-элементы с типом Параметр или Конфигурация при выборе аргумента для сравнения справа.
Для удаления одного из условий нажмите крестик справа от него.
Сформированное описание условия отображается под блоком перехода и переносится на несколько строк. Увеличивать высоту блока для его просмотра не требуется. Видимость подписи меняется переключателем Показывать условие в настройках перехода.