Попробовать

Создание сценария

Откройте раздел Логика и нажмите Создать над списком сценариев. В более ранних версиях платформы этот раздел называется Сценарии.
💡
Версия редактора. Работа с карточками и линиями ниже описана для RIC Web 3.13.4, доступной на dev.rightech.io. На установках с более ранней версией расположение кнопок и набор настроек могут отличаться.
Если вы впервые создаёте сценарий, начните с последовательности от создания до запуска. Настройка сетки и перестроение линий описаны отдельно в разделе «Сетка и линии переходов».
Заполните следующие поля:
  • Имя — наименование сценария;
  • Описание — подробная характеристика сценария, заполняется при необходимости.
Выберите тип:
  • По кросс-элементам – в таком сценарии автоматизации используются кросс-элементы – абстрактные параметры, которые можно создать непосредственно в сценарии, не привязываясь к какой-то определенной модели. Сценарий, построенный на кросс-элементах, является переиспользуемым компонентом, который можно применить к объектам с разными моделями, предварительно сопоставив кросс-элементы и параметры из модели объекта, на котором необходимо запустить сценарий;
  • По параметрам из модели – такой сценарий автоматизации формируется на базе конкретной выбранной модели. Если сценарий будет включать в себя взаимодействие между несколькими объектами, выберите те модели, которые соответствуют этим объектам.
💡
Ранее все сценарии автоматизации строились на жесткой связи сценария автоматизации и модели. Такой подход себя исчерпал, так как приводил к размножению однотипных решений и усложнял развитие проектов. Теперь основным механизмом построения сценариев автоматизации являются кросс-элементы. Создание сценариев автоматизации с типом данных По параметрам из модели официально считается устаревшим, но продолжает временно поддерживаться в рамках обратной совместимости.
Также вы можете импортировать готовый сценарий в виде файла или по ссылке.
Нажмите кнопку Создать. Перед вами откроется новый сценарий с минимальным набором элементов в рабочей области.

Рабочая область

На схеме состояния обозначены серыми карточками, а события переходов — голубыми блоками на соединяющих линиях. Стрелка указывает состояние, в которое ведёт переход.
ЭлементДля чего нужен
Добавить состояние, кнопка «+» слеваДобавить состояние на схему
СохранитьЗаписать изменения сценария на сервер
Показать / скрыть сеткуИзменить видимость сетки, сохранив привязку к ней
Подвижные связиРазрешить перестроение соседних линий при перемещении блока перехода; по умолчанию выключено
Автотрассировка сценарияЗаново рассчитать линии и расположение блоков переходов после подтверждения
ЭкспортСкачать сценарий в JSON
На весь экранРазвернуть редактор
Миникарта и масштабПеремещаться по большой схеме и менять её масштаб
Для перемещения по холсту нажмите и удерживайте колесо мыши. Миникарту можно свернуть кнопкой в её правом верхнем углу.

Начало и завершение

Зелёный круг обозначает начальное состояние. Из него выходит только один переход — Инициализация логики. Он срабатывает при запуске сценария. Если нужно изменить первое рабочее состояние, перетащите точку существующей связи к нужному состоянию: начальный круг останется её источником.
Красный круг внутри кольца обозначает конечное состояние. Попадание в него завершает выполнение сценария. Исходящие переходы из конечного состояния недоступны. В циклическом сценарии конечное состояние можно не использовать.

Сохранение и изменения в другой вкладке

Сохраняйте схему кнопкой Сохранить или сочетанием Ctrl+S. Изменения на холсте, включая перемещение блоков и линий, нужно сохранить перед закрытием или перезагрузкой страницы.
💡
Запущенный сценарий продолжает работать в прежней версии. После сохранения изменений перезапустите его на нужных объектах. Сохранение схемы само по себе не перезапускает выполнение.
Если сценарий изменён в другой вкладке или другим пользователем, появится уведомление с предложением загрузить обновления. Сохранение текущего черновика блокируется. Загрузка заменит открытый вариант серверным; при наличии несохранённых изменений редактор запросит подтверждение. До подтверждения проверьте, какие изменения вам нужно сохранить отдельно.

Добавление состояния

  1. Нажмите Добавить состояние — кнопку «+» в левом верхнем углу холста.
  2. Щёлкните по карточке или нажмите кнопку редактирования в её всплывающей панели.
  3. Укажите имя и при необходимости описание. У новых состояний показ описания включён по умолчанию.
Карточку можно перемещать, а её размер — менять за нижний правый угол. Название находится вверху. Описание занимает доступное место: длинный текст обрезается с многоточием, без полосы прокрутки. Полный текст можно прочитать в настройках состояния.
В пустом состоянии нет строк действий. Они появляются после добавления первого действия на входе или выходе. Кнопка удаления состояния находится во всплывающей панели; вместе с состоянием удаляются его действия и все входящие и исходящие переходы. Редактор предупреждает об этом перед удалением.

Действия в состояниях

  1. Наведите указатель на карточку состояния, чтобы открыть панель кнопок над её правым краем.
  2. Нажмите зелёную кнопку действий при входе или оранжевую кнопку действий при выходе. Подсказка при наведении помогает выбрать нужную кнопку.
  3. Найдите действие в списке и выберите его. Длинный список прокручивается внутри окна выбора.
  4. Окно выбора закроется, а справа останется панель настройки выбранного действия. Заполните необходимые поля.
  5. Для следующего действия снова откройте список соответствующей кнопкой. Если группа При входе или При выходе уже видна на карточке, можно нажать её заголовок: при наведении рядом появляется «+».
Действия при входе выполняются при переходе в состояние, действия при выходе — при выходе из него. Уже добавленное действие можно выбрать для редактирования, удалить или переместить в списке, чтобы изменить порядок выполнения.
Действия разделены на группы:
💡
Повторное выполнение действия. Одно и то же действие можно добавить только один раз в каждую группу одного состояния. Если его нужно выполнить повторно, используйте другое состояние. При соединении состояний мгновенными переходами учитывайте защиту от слишком частых переходов.

Изменить значение

Если в ходе выполнения сценария необходимо изменять или заполнять значение каких-то параметров состояния, конфигурации или статуса, созданных в кросс-элементах, воспользуйтесь действием Изменить значение.
Эта команда предусматривает следующие функции:
  • прочитать параметр из конфигурации/состояния/статуса и записать его в исходном виде в другой параметр из конфигурации/состояния/статуса. Прочитанное значение записывается в виде переменной $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 – Очистка списка непрочитанных сообщений с учетом установленных фильтров
💡
При появлении новых сообщений, которые не проходят по выставленному фильтру или критерию поиска, настраиваемая часть боковой панели на короткое время выделяется красным цветом.
Варианты группировок сообщений:
  • Не группировать – отсутствие группировки, сообщения отображаются полным списком;
  • По объекту – для каждого объекта все оповещения будут собраны в единую группу. Слева внизу в карточке группы отображается количество сообщений для этого объекта;
  • По тексту сообщения – уведомления с одинаковым текстом сообщения будут собраны в единую группу. Слева внизу в карточке группы отображается количество сообщений с одинаковым текстом.
💡
Если вы удалите объект, то сообщения, полученные для него, все еще будут отображаться в списке сообщений, но вместо имени объекта будет знак вопроса. Раскройте содержимое сообщение, кликнув по нему. Так вы увидите идентификатор удаленного объекта и при необходимости сможете загрузить их по 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. Добавьте действие в состояние – справа появится боковая панель, на которой заполните следующие поля:

Отправить сообщение в Телеграм

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

Кросс-элементы с типом Действие

Любую команду, созданную в модели объекта, вы можете отправить из сценария автоматизации. Для этого в списке возможных действий для состояния нажмите на плюсик в группе Действия объекта.
Справа появится боковая панель, на которой заполните следующие поля:
  • Тип – автоматически подставится Действие без возможности изменения;
  • Идентификатор – необходим для распознавания кросс-элемента в системе, должен быть уникален для текущего сценария автоматизации;
  • Имя – название действия, отображаемое в интерфейсе сценария автоматизации;
  • Описание – дает более полное представление о действии.

Нажмите Сохранить. Новое действие появится в списке.

Если необходимо внести изменения в данное действие, перейдите на вкладку Кросс-элементы. Вы увидите все созданные в этом сценарии автоматизации кросс-элементы. Вы можете отредактировать любой кросс-элемент, удалить или создать новый.
💡
Так как кросс-элемент создается в общем, абстрактном виде, он не учитывает, что внутри действия из модели, с которым он будет сопоставляться, могут быть включены дополнительные настройки подтверждения перед отправкой или указаны дополнительные параметры. Такие команды отправляться из сценария автоматизация, построенного на кросс-элементах, не будут. Чтобы отправить команду с функцией подтверждения или с дополнительными параметрами, воспользуйтесь действиями в сценарии автоматизации с типом По параметрам из модели.

Команды из модели

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

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

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

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

Также из сценария автоматизации, построенного по модели, можно отправлять команды с параметрами, которые задаются непосредственно перед отправкой.

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

Добавление перехода

  1. Наведите указатель на границу исходного состояния и потяните за точку выхода.
  2. Ведите линию к целевому состоянию. Линия отрисовывается во время движения, а выбранная точка стыковки подсвечивается.
  3. Отпустите кнопку мыши, когда точка пристыкована. Если подсветка стыковки сохраняется, связь завершится и при отпускании над карточкой или рядом с ней на холсте.
  4. В появившемся блоке нажмите Добавить событие и выберите событие-триггер.
Для изменения геометрии можно перемещать блок перехода или отдельные участки линии. Подробнее — «Сетка и линии переходов».

Имя и описание перехода

Откройте настройки щелчком по блоку или кнопкой редактирования в его всплывающей панели.
  • Имя перехода — необязательное название. Если оно заполнено, на блоке показывается это имя; если поле пустое — название события. Имя не меняет событие, которое запускает переход.
  • Описание — пояснение назначения перехода. У новых блоков показ описания включён. Текст переносится на строки и занимает доступную высоту; остаток обрезается с многоточием. Для полного текста откройте настройки.
  • Показывать условие — управляет подписью под блоком, по умолчанию включено. Настройка доступна у обычных переходов, кроме инициализации.
  • Событие перехода — событие-триггер. Через это поле можно выбрать другое событие.
💡
Скрытое условие продолжает проверяться. Переключатель «Показывать условие» меняет только вид схемы. Чтобы изменить логику перехода, отредактируйте само условие.

Редактирование условия

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

События

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

Базовые события

События, которые всегда есть в сценарии независимо от наличия кросс-элементов, поделены на две смысловые группы:
  1. События сценария:
  • Мгновенный переход – переход происходит сразу же при попадании в состояние, из которого он ведет;
  • Таймер №... – события в таймерах:
  • Планировщик №... – события в планировщиках:
  1. События объекта:
  • Получены данные – переход происходит при получении пакета с данными;
  • Редактирование объекта – переход происходит при сохранении изменений на вкладке объекта Редактирование;
  • Смена статуса – переход происходит при смене статуса объекта;
  • Геозоны – события в геозонах:
    • Вход в геозону – переход происходит при входе в отслеживаемую геозоны;
    • Выход из геозоны – переход происходит при выходе из отслеживаемой геозоны;
    • Вход в комнату – переход происходит при входе в отслеживаемую комнату на схеме;
    • Выход из комнаты – переход происходит при выходе из отслеживаемой комнаты на схеме;
    • Постановка на маршрут – переход происходит при приближении к заданному маршруту следования на расстояние менее 50 метров;
    • Отклонение от маршрута – переход происходит при отдалении от заданного маршрута следования более чем на 50 метров;
    • Вход в контрольную точку – переход происходит при приближении к контрольной точке на маршруте на расстояние менее 50 метров;
    • Выход из контрольной точки – переход происходит при отдалении от контрольной точки на маршруте более чем на 50 метров.
  • Команды – события после отправки команды на объект:
    • Команда выполнена – переход происходит, если выбранная в условии перехода команда завершится успешно;
    • Команда не выполнена – переход происходит, если выбранная в условии перехода команда завершится с ошибкой. Например, такое событие может произойти, если устройство не ответило на команду согласно протоколу передачи данных или потеряло соединение с платформой.

При необходимости добавленное событие можно изменить. Для этого кликните на переход и нажмите на кнопку изменения события. Появится выпадающий список для выбора необходимого варианта.
💡
Мгновенный цикл может привести к аварийной остановке. Если состояния без ожидания события снова и снова переходят друг в друга, срабатывает защита от слишком частых переходов. Как работает ограничение и как исправить сценарий.

Кросс-элементы с типом Событие

Любое событие, созданное в модели объекта, вы можете указать в переходе в сценарии автоматизации. Для этого в списке возможных событий для перехода нажмите на плюсик в группе События объекта.
Справа появится боковая панель, на которой заполните следующие поля:
  • Тип – автоматически подставится Событие без возможности изменения;
  • Идентификатор – необходим для распознавания кросс-элемента в системе, должен быть уникален для текущего сценария автоматизации;
  • Имя – название события, отображаемое в интерфейсе сценария автоматизации;
  • Описание – дает более полное представление о событии.

Нажмите Сохранить. Новое событие появится в списке.

Если необходимо внести изменения в данное событие, перейдите на вкладку Кросс-элементы. Вы увидите все созданные в этом сценарии автоматизации кросс-элементы. Вы можете отредактировать любой кросс-элемент, удалить или создать новый.
💡
При создании в модели своего события можно задать параметры, чтобы впоследствии, при получении такого события по API или из другого сценария, вывести значения этих параметров в действиях регистрации событий. Но так как кросс-элемент создается в общем, абстрактном виде, он не учитывает, что в событии в модели, с которым он будет сопоставляться, могут быть указаны дополнительные параметры. Поэтому в сценарии автоматизации, построенном на кросс-элементах, не получится использовать параметры из полученного события. Чтобы обработать параметры из события, воспользуйтесь событиями в сценарии автоматизации с типом По параметрам из модели.

События из модели

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

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

Условия

После выбора события дополнительно можно указать условие, при выполнении которого происходит переход.
Для формирования условия выберите параметр, значение которого необходимо проверить, из выпадающего списка.
💡
При выборе параметра из большого списка удобно пользоваться поиском.
Сравнивать параметры можно с
  • точным значением – указывается числовое, строковое или логическое значение в соответствии с типом данных параметра;
  • другим параметром – выбирается параметр для сравнения;
  • уровнем – выбирается один из уровней, заданных в модели для параметра;
  • конфигурационным значением – выбирается параметр с типом Конфигурация. Сравнивать с конфигурационными параметрами удобно в случаях, если логика работы сценария одинакова для разных объектов, но критерии срабатывания условий отличаются. Например, для спальной комнаты нормальными считаются одни показатели температуры, для кухни – другие. В этом случае не нужно создавать разные сценарии климат-контроля для этих помещений. Достаточно в конфигурации объектов создать параметры, обозначающие диапазоны нормальной температуры, задать соответствующие помещениям значения, а в сценарии сравнивать текущую температуру не с конкретными величинами, а с этими конфигурационными параметрами.
💡
Раздел Уровень появляется только в том случае, если сценарий автоматизации имеет тип По параметрам из модели и для параметра, выбранного слева, в модели заданы уровни.
Раздел Конфигурация появляется только при наличии кросс-элементов с типом Конфигурация в сценарии автоматизации По кросс-элементам или при наличии в модели узлов с типом Конфигурация в сценарии автоматизации По параметрам из модели.
Выберите операцию сравнения и после формирования условия нажмите кнопку Сохранить.
💡
Операция in работает для поиска вхождения значения параметра в массив чисел, а также для поиска подстроки в строке.
Операция not in
проверяет, что значение выбранного параметра не входит в массив или не является подстрокой в строке.
В визуальном конструкторе одного перехода можно задать до четырёх условий. Переход может быть и без условия: тогда достаточно события-триггера. Их взаимодействие между собой сконфигурируйте с помощью кнопок И и ИЛИ. При выборе И для выполнения перехода должны быть выполнены все условия, при выборе ИЛИ – любое из указанных.
Если в списке возможных параметров еще нет необходимого кросс-элемента, вы можете создать его прямо из окна формирования условий перехода. Для этого нажмите на кнопку Создать кросс-элемент.
Справа появится боковая панель, на которой заполните следующие поля:
  • Тип – автоматически подставится Параметр без возможности изменения;
  • Идентификатор – необходим для распознавания кросс-элемента в системе, должен быть уникален для текущего сценария автоматизации;
  • Имя — название параметра, отображаемое в интерфейсе сценария;
  • Описание — пояснение назначения параметра;
  • Тип данных – в зависимости от типа данных параметра формируется список возможных операций сравнения.

Нажмите Сохранить. Новый параметр появится в списке.
Если необходимо внести изменения в данный параметр, перейдите на вкладку Кросс-элементы. Вы увидите все созданные в этом сценарии автоматизации кросс-элементы. Вы можете отредактировать любой кросс-элемент, удалить или создать новый.
💡
Также вы можете создавать кросс-элементы с типом Параметр или Конфигурация при выборе аргумента для сравнения справа.
Для удаления одного из условий нажмите крестик справа от него.
Сформированное описание условия отображается под блоком перехода и переносится на несколько строк. Увеличивать высоту блока для его просмотра не требуется. Видимость подписи меняется переключателем Показывать условие в настройках перехода.