Узнайте, как использовать триггеры для построения логики в приложениях без написания кода.
This topic is featured in the Basic App Design and Logic course in Tulip University.
В этой статье вы узнаете:
- Команды триггеров, логику и поведение при выполнении
- Рекомендации по созданию и организации триггеров
- Распространенные сценарии использования
Триггеры позволяют добавлять логику в ваше приложение. С их помощью вы можете взаимодействовать с устройствами, отправлять уведомления, записывать данные, обмениваться информацией с бэкэнд-системами и многое другое — и всё это без написания ни одной строчки кода.
Распространенные сценарии использования триггеров включают:
- Навигация внутри приложения: используйте переход, чтобы перейти к другому шагу.
- Завершение работы приложения: регистрируйте метаданные приложения.
- Запуск функции коннектора для доступа к бэкэнд-системе: используйте коннекторы, чтобы Tulip мог взаимодействовать со сторонними системами и запускать функции коннекторов с помощью триггеров.
- Отправка уведомлений: отправляйте уведомления по электронной почте или SMS из приложения администратору. Эти сообщения могут содержать изображения, информацию о статусе процесса или другую актуальную информацию.
- Хранение данных: сохранение входных данных из приложения в переменных или таблицах.
- Использование устройства: для операторов, использующих обе руки во время процесса, добавьте триггер для события устройства, например педали, чтобы перейти к следующему шагу.
Как работают триггеры?
Логика
Триггеры используют логическую структуру «когда, если, то, иначе »:
- когда «событие регистрируется в Tulip»
- то «выполнить действие» или «осуществить переход».
Триггеры также могут содержать условную логику:
- когда «событие регистрируется в Tulip»
- if «условие выполняется»
- то «выполнить действие»
- иначе «выполнить другое действие»
Подробнее об условной логике триггеров читайте здесь.
Триггеры объединены в Trigger Event и состоят из действия и условий.
Триггеры могут быть простыми, как в примере ниже:

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

Когда сканер штрих-кода передает данные на текущей станции, API Call (вызываемый через функцию коннектора) извлекает детали заказа из внешней базы данных и сохраняет значение в переменной. Затем триггер также переходит к следующему шагу.
Типы команд
В триггере можно использовать два типа команд:
- Действие: изменение в приложении, не связанное со сменой шагов (например, отображение сообщения об ошибке, отправка электронного письма, создание снимка экрана приложения)
- Переход: событие навигации в самом приложении (например, переход к следующему шагу, завершение работы с приложением, отмена работы с приложением). Переходы могут приводить к срабатыванию других триггеров (т. е. запуску). Например, вы можете создать триггер на уровне приложения, который срабатывает каждый раз при завершении работы с приложением.
Очередь триггеров
Trigger Event (например, нажатие кнопки) добавляет триггеры в последовательную однопоточную Trigger Queue для выполнения в Tulip Player.

влияет на: 1. Функции: * Функции включаются в очередь триггеров 2. Пользовательские виджеты: * Выполнение логики в пользовательском виджете может повлиять на очередь триггеров
Automations run in the background, not in an app (even if the Automation is initiated by an action performed in the app), and therefore are not added to the trigger queue.
Порядок выполнения
Триггеры запускаются последовательно и в порядке, определяемом « Trigger Event » (т. е. нажатие кнопки, таймер, выбор строки в таблице).
Триггеры запускаются последовательно, то есть первый триггер в цепочке должен завершиться, прежде чем начнётся выполнение второго. Такой порядок выполнения триггеров называется очередью триггеров.
Очередь триггеров не связана с другими задачами в приложении, такими как взаимодействие с переменными (например, ввод текста, флажки), пользовательские виджеты и JavaScript пользовательских виджетов.
Как значения ввода используются в триггерах?
Значения ввода (т. е. переменные) передаются в триггеры по ссылке.
Триггеры ссылаются на значение ввода переменной на момент выполнения триггера. Если значение ввода изменится до выполнения триггера, триггер будет ссылаться на самое актуальное значение.
Переменные являются глобальными для приложения, что позволяет изменять их с помощью другой логики в приложении.
:
Когда триггеры отменяются?
Триггеры в очереди триггеров отменяются и, следовательно, не будут выполняться, если:
- Триггер помещается в очередь после перехода. Привыполнении перехода (например, «Далее», «Завершить приложение», «Перейти к шагу по имени» и т. д.) все триггеры, оставшиеся в очереди, отменяются.
- Принудительное закрытие Tulip Player. Еслиоператор принудительно закрывает плеер (например, если приложение не отвечает), все оставшиеся действия в запущенном триггере и все оставшиеся триггеры в очереди отменяются.
Обработка ошибок
Ошибки триггеров и последующая отмена происходят в следующих сценариях:
- Ошибка действия триггера
- Превышение времени ожидания триггера
Ошибка действия триггера
The Show Error action (show a message to the operator with a red background) does not count as a trigger error.
Если при выполнении действия в триггере происходит ошибка, остальные действия в этом триггере пропускаются/отменяются:
По умолчанию после ошибки все оставшиеся триггеры в очереди и в событии триггера не будут выполняться для следующих триггеров на уровне приложения и шага:* Запуск приложения* Завершение работы приложения* Отмена приложения* При входе в шаг* При выходе из шага

Для всех остальных типов триггеров (например, «При нажатии кнопки») переключатель «Остановить оставшиеся триггеры при ошибке» по умолчанию отключен.
Таймаут триггера
Если для триггера истек тайм-аут (см. «Тайм-ауты триггеров»), все оставшиеся триггеры в очереди будут отменены.
Техническое поведение
Время выполнения триггера
- Триггеры выполняются последовательно в рамках одного цикла выполнения триггера. Цикл выполнения триггера — это период, в течение которого триггер активно выполняется в Tulip.
- Триггеры никогда не выполняются параллельно или в фоновом режиме других триггеров. Новый триггер не может начать выполнение, пока не завершится текущий, запущенный триггер.
- Операторы по-прежнему могут взаимодействовать с приложением (например, нажимать кнопки, работать с таблицами) во время выполнения триггера. Эти нажатия кнопок и другие события, связанные с триггерами, будут добавлять новые триггеры в очередь триггеров.
Таймауты триггеров — обновлено в версии LTS15 / r332
По умолчанию таймаут триггера составляет 10 минут; по истечении этого времени триггер и все оставшиеся действия будут отменены, а все остальные триггеры в очереди будут отменены.
10-минутный таймаут применяется к Trigger Event. Например, если нажатие кнопки запускает 5 триггеров, все 5 триггеров в очереди триггеров и их соответствующие действия должны выполниться в течение 10 минут.
По истечении 30 секунд с момента запуска триггера приложение отображает оператору следующее сообщение:
По истечении 100 секунд с момента запуска триггера приложение отображает оператору следующее сообщение:
По истечении 10 минут триггер отменяется, и приложение отображает следующее сообщение об ошибке:
Дополнительные настройки таймаута
Измените настройки таймаута для экземпляра с помощью приведенных ниже методов:
-
Tulip может включить или отключить настройку, позволяющую операторам вручную отменять длительно выполняющийся триггер по истечении первых 100 секунд. Обратитесь в службу поддержки Tulip, чтобы включить эту функцию.
-
Служба поддержки Tulip может уменьшить или увеличить период таймаута. Обратите внимание, что Tulip рекомендует использовать 10-минутный период таймаута в качестве отправной точки, чтобы повысить вероятность завершения выполнения вашей логики. Если выполнение триггера постоянно занимает больше нескольких минут, рассмотрите следующие меры:
- Упростите логику триггера, чтобы улучшить удобство работы оператора и снизить вероятность сбоя триггера.
- По возможности запускайте автоматизацию в фоновом режиме, чтобы разгрузить выполнение логики и не препятствовать дальнейшей работе оператора.
- Проанализируйте и оптимизируйте любые зависимости от сторонних систем в логике триггера (например, медленные функции коннекторов, использование неоптимального API).
Действия с записями таблицы
Inconsistent sequencing of Trigger Actions will result in inconsistent user experience when reviewing audit trails in the Record History Widget.
Создание записи в таблице
Для создания новой записи в таблице рекомендуется сразу после действия «Запись в таблице / Создать запись» выполнять соответствующие действия по обработке данных, чтобы заполнить остальные столбцы вновь созданной записи.
Если между действием «Запись таблицы / Создать запись» и действиями по заполнению остальных столбцов находятся другие действия, создание этой записи таблицы будет отображаться в виде отдельных событий в виджете истории записей.
Создание записи таблицы — начиная с LTS15 / r332
Начиная с версии LTS15 последовательные действия с таблицами «Запись таблицы / Создать запись » и «Обработка данных / Сохранить» объединяются для одной и той же записи. Это означает, что действия «Создать» и «Обработка данных» в триггере выполняются в одной транзакции.
Действия «Создание записи » и «Обработка данных / Сохранение» не будут объединены в одну транзакцию, если между ними находятся какие-либо другие действия (например, операции с переменными или другими записями таблицы, функции коннектора и т. д.).
В приведенных ниже примерах триггеров действие «Создать запись» и действия «Обработка данных / Сохранить» будут объединены в одну транзакцию и либо все завершатся успешно, либо все завершатся с ошибкой. Если все действия завершатся с ошибкой, они будут повторены вместе с использованием отказоустойчивых повторных попыток.
Пример 1: Последовательное создание и манипуляции с данными одной и той же записи таблицы. В LTS15 все эти действия либо завершатся успешно, либо завершатся с ошибкой, но не в версиях до LTS12.
Пример 2: Последовательное создание и манипуляции с данными одной и той же записи таблицы, за которыми следует действие «Функция коннектора». Сами действия «Создание записи таблицы» и «Манипуляции с данными» будут объединены в LTS15. Действие «Функция коннектора» может завершиться сбоем, независимо от успешного выполнения действий с таблицей.
В следующем триггере действия «Обработка данных» и «Сохранение» выполняются для двух разных записей таблицы, поэтому эти действия не будут объединены в одну транзакцию.
Пример 3: «Запись таблицы / Создание» и «Обработка данных / Сохранение» для одной и той же записи таблицы, разделенные другим действием «Обработка данных». Этидействия не будут объединены в одну транзакцию.
В приведенном ниже триггере действия «Запись таблицы» и «Обработка данных / Сохранение» не будут объединены, поскольку метаданные из записи таблицы, созданной в предыдущем действии, используются в качестве входных данных для действия «Обработка данных / Сохранение».
Пример 4: Создание и обновление с чтением данных из самой записи. Эти действия не будут объединены в одну транзакцию.
При использовании агрегации в объединенном действии «Обновление записи таблицы» значение агрегации берется до того, как произойдет обновление. Значение агрегации не будет отражать объединенное обновление записи таблицы.
Пример 5: Создание и обновление с агрегациями. Эти действия будут объединены, а значение агрегации берется до выполнения действия «Создание».
Обновление записи таблицы
Последовательные действия по обработке данных, относящиеся к одной и той же записи таблицы, объединяются для выполнения в рамках одного сетевого запроса, поэтому все они происходят одновременно
Действия триггеров, связанные с записями таблицы, группируются в зависимости от их типа и порядка. Действия сохранения, имеющие одно и то же место хранения, группируются в один сетевой запрос. В то же время такие действия, как «Загрузить запись» или «Создать запись», рассматриваются как отдельные транзакции.
Для обеспечения максимальной производительности рекомендуется объединять последовательные обновления одной и той же записи — то есть не разбивать обновления одной и той же записи на отдельные действия, связанные с другими таблицами или данными.
**Пример 1: Последовательные обновления одной и той же записи.**Эти действия будут объединены в одну транзакцию:
Пример 2: Обновления одной и той же записи, разделенные другими действиями. Эти действия не будут объединены, поскольку обновления записей одной и той же таблицы не выполняются последовательно:
В следующем триггере действия по манипуляции данными / сохранению выполняются для двух разных записей таблицы, поэтому эти действия не будут объединены в одну транзакцию.
Пример 3: Обновления двух разных записей. Этидействия не будут объединены в одну транзакцию.
При использовании агрегации в объединенном действии обновления таблицы значение агрегации берется до того, как произойдет обновление. Значение агрегации не будет отражать обновление объединенной записи таблицы.
**Пример 4: Обновления, включающие агрегации.**Эти действия будут объединены, что означает, что значение агрегации вычисляется до того, как произойдет обновление.
Повторные попытки триггеров (табличных действий) — новое начиная с LTS15 / r332
Триггеры повторяют попытки только для действий с таблицами (например, запись данных в таблицу, обновление данных в таблице, взаимодействия с таблицами и т. д.).
В течение 10 минут с момента запуска триггера, если одно действие с таблицей завершилось сбоем, оно будет повторяться в течение максимум 2 минут. Если через 2 минуты действие так и не удалось выполнить, все оставшиеся действия и триггеры в очереди триггера будут отменены.
Для обеспечения отказоустойчивости триггера в сети убедитесь, что его действия включают только взаимодействия с таблицами и обновления данных. См. раздел «Действия с записями таблицы» для получения рекомендаций по отказоустойчивым действиям с таблицами.
Connector function calls, send emails, and machine monitoring would not be network resilient in LTS15.
Повторные попытки выполнения действий триггера не приведут к дублированию результата, если действие случайно запустится дважды. Это гарантирует, что действие над таблицей не запишет одни и те же данные несколько раз.
Ограничения и таймауты
| Ограничение | |
|---|---|
| Таймаут события триггера — по истечении этого времени все триггеры, связанные с данным событием, завершаются с ошибкой и удаляются из очереди триггеров. | - LTS15/r332: Таймаут Trigger Event составляет 10 минут. - (до LTS15/r332): Таймаут событий триггера составляет 100 секунд. |
| — по достижении этого предела новые события триггера будут отменены и не будут выполняться. | По умолчанию очередь триггеров может содержать до 100 событий триггера. |
| Количество последовательных триггеров, вызванных переходом — т. е. нажатие кнопки вызывает переход к шагу 1 → открытие шага запускает 2 триггера → переход к шагу 2 → закрытие шага запускает 3 триггера → открытие шага запускает 1 триггер и т. д. | Очередь триггеров выполнит до 100 последовательных триггеров, вызванных переходом Как только этот предел будет достигнут, новые триггеры перехода будут отменены. |
| Таймаут триггера перехода (таймаут событий перехода) — время ожидания завершения триггеров перехода, таких как «Перейти к шагу», «При входе в шаг», «При выходе из шага» | - LTS15/r332: 25 секунд (настраиваемо) |
Типы триггеров
Существует три типа триггеров:
Триггеры на уровне приложения
Триггеры на уровне приложения можно применять к следующим событиям:
- Запуск приложения
- Завершение работы приложения
- Отмена приложения
Доступ к триггерам на уровне приложения можно получить на вкладке «Приложение».
Подробнее о триггерах на уровне приложения читайте здесь.
Триггеры на уровне шага
Триггеры на уровне шага можно применять к следующим событиям:
- С регулярными интервалами времени («срабатывание по времени»)
- При поступлении входных данных от машины или устройства («машины и устройства»)
- При открытии шага
- При закрытии шага
Доступ к триггерам на уровне шага можно получить на вкладке «Шаг».
Подробнее о триггерах на уровне шага можно узнать здесь
Триггеры виджетов
Триггеры виджетов активируются при нажатии кнопки. На одном шаге может быть несколько триггеров кнопок, которые срабатывают, когда оператор нажимает соответствующую кнопку в Tulip Player.
Выберите нужный виджет, а затем перейдите к триггерам виджетов на вкладке «Виджет».

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

- Избегайте использования длительно выполняющихся триггеров на шаге с интерактивными виджетами. Виджеты визуально меняют состояние сразу же при взаимодействии. Хотя оператор видит, что действие происходит на виджете мгновенно, логика может выполняться с небольшой задержкой из-за медленной сети или длительно работающего коннектора.
- **Обучите операторов ждать после нажатия на переход (например, «Следующий шаг»).**На шаге триггеры, поставленные в очередь после перехода, не будут выполняться. Если оператор взаимодействует с виджетом, имеющим переход, он останется на шаге до тех пор, пока переход не будет выполнен. Например, если оператор нажмет «Следующий шаг», а затем, ожидая, запустит другой триггер, оставшийся после перехода триггер не будет выполнен.
- Выполняйте долгодействующие коннекторы и обновления данных на отдельных шагах. Взаимодействияс конфиденциальными данными не должны выполняться на том же шаге, что и логика долгодействующих коннекторов. В случае, если оператор взаимодействует с шагом после нажатия на долгодействующий триггер или переход, существует риск того, что критически важные данные не будут сохранены.
- Убедитесь, что переменные имеют по одному входу для каждого шага. Переменныене должны совместно использоваться с конкурирующей логикой ввода (т. е. несколькими кнопками в приложении, обновляющими одну и ту же переменную), чтобы избежать условий гонки. Например, триггер фиксирует текущее значение переменной. Если значение переменной изменится до того, как триггер его зафиксирует, данные будут некорректными.
Дополнительная информация
- Список действий триггеров и переходов
- Условная логика триггеров
- Рекомендации по созданию высокопроизводительных приложений
{{snippet.Нашли ли вы то, что искали?}}

