05 События

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

• Общие: такие как "Пользователь вошел в систему" или "Совершать, если условие выполнено"

• Элементы: такие как "Совершен клик по элементу" или "Изменилось значение поля ввода"

• Пользовательские: создайте свое событие, которое можно использовать много раз.

Страница загружена (Page is loaded)

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

Пользователь вошел в систему (User is logged in)

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

Пользователь вышел из системы (User is logged out)

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

Выполнять каждые X секунд (Do every X seconds)

Данное событие совершает действие каждые X секунд. Bubble обновляется в реальном времени, поэтому данное событие не будет срабатывать слишком часто.

Интервал (Interval)

Введите число, которое будет определять интервал в секундах.

Выполнять, если условие выполняется (Do when condition is true)

Данное событие срабатывает, если условие выполняется. Если для "Run this"/"Запустить это" установлено "Just once"/"Однократно", то оно будет срабатывать один раз на каждую загрузку страницы. Это будет происходить либо сразу после загрузки страницы, если условие уже выполнено, либо позже, когда условие выполнится. Если для "Run this"/"Запустить это" установлено "Every time"/"Каждый раз", то рабочий процесс будет запускаться каждый раз при выполнении условия.

Запустить это (Run this)

Выберите "Just once"/"Однократно" или "Every time"/"Каждый раз", чтобы задать, как должно запускаться событие: один раз на каждую загрузку страницы или каждый раз при выполнении условия.

Совершен клик по элементу (An element is clicked)

Данное событие срабатывает, если пользователь кликает по элементу. Большинство визуальных элементов может запускать данное событие, включая тексты, кнопки, изображения и иконки.

В элементе возникла ошибка во время запуска процесса (An element has an error running a workflow)

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

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

Используйте поле "Current workflow error"/"Ошибка текущего процесса", чтобы увидеть текст ошибки. У него есть 2 параметра "code"/"код" и "message"/"сообщение". "Code" - это короткая фраза, которая используется в условиях. "Message" - само сообщение об ошибке, которое отображается в том случае, если не заданы процессы-обработчики ошибок. Вы можете, например, использовать элемент Alert, чтобы отобразить параметр "message". Не используйте параметр "message", так как он зависит от языка и может изменяться. "Code" всегда будет оставаться неизменным независимо от языка приложения. Коды и сообщения об ошибках перечислены в разделе Languages вкладки Settings.

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

См. "An unhandled error occurs"/"Возникает ошибка, которую нельзя обработать", чтобы создать обработчики ошибок, не относящиеся к элементу.

Возникла ошибка, которую нельзя обработать (An unhandled error occurs)

Данное событие возникает при взаимодействии пользователя с элементом, например при клике на кнопку, если возникает ошибка в ходе данного взаимодействия. Данное событие возникает, если для конкретного элемента не назначено событие "An element has an error running a workflow"/"В элементе возникла ошибка во время запуска процесса". Это может происходить как при предусмотренных ошибках, таких как неудачная попытка входа в систему, так и при непредусмотренных ошибках, таких как баг платформы Bubble.

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

Используйте поле "Current workflow error"/"Ошибка текущего процесса", чтобы увидеть текст ошибки. У него есть 2 параметра "code"/"код" и "message"/"сообщение". "Code" - это короткая фраза, которая используется в условиях. "Message" - само сообщение об ошибке, которое отображается в том случае, если не заданы процессы-обработчики ошибок. Вы можете, например, использовать элемент Alert, чтобы отобразить параметр "message". Не используйте параметр "message", так как он зависит от языка и может изменяться. "Code" всегда будет оставаться неизменным независимо от языка приложения. Коды и сообщения об ошибках перечислены в разделе Languages вкладки Settings.

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

См. "An unhandled error occurs"/"Возникает ошибка, которую нельзя обработать", чтобы создать обработчики ошибок, не относящиеся к элементу.

Изменилось значение поля ввода (An input's value is changed)

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

Открылось всплывающее окно (A popup is opened)

Данное событие возникает при открытии всплывающего окна с помощью действия "Show element"/"Отобразить элемент".

Всплывающее окно закрылось (A popup is closed)

Данное событие срабатывает при закрытии всплывающего окна, либо с помощью действия "Hide element"/"Скрыть элемент", либо когда пользователь нажимает клавишу Esc.

Совершен клик по маркеру на карте (A map's marker is clicked)

Данное событие запускается, если пользователь кликает по маркеру на карте. Поле "This map's current marker"/"Текущий маркер карты" относится к тому маркеру, по которому кликнул пользователь.

Создать пользовательское событие (Create a custom event...)

Bubble позволяет использовать одну и ту же логику более чем в одном рабочем процессе с помощью "пользовательских рабочих процессов"/"custom workflows". Данное событие определяет такие рабочие процессы. Задайте имя рабочего процесса, затем используйте действие "Запустить пользовательское событие"/"Trigger a custom event" из другого рабочего процесса. Этот функционал в Bubble можно считать "функциями" применительно к классическим языкам программирования.

Имя события (Event name)

Введите имя рабочего процесса. Выберите пользовательский рабочий процесс по имени в действии "Запустить пользовательское событие"/"Trigger a custom event".

Тип сущности (Type of thing)

Если вам нужно, чтобы пользовательский рабочий процесс принимал в качестве аргумента какую-либо сущность, т.е. запись из базы данных приложения, то задайте её тип здесь. Если данное поле заполнено, то действие "Запустить пользовательское событие"/"Trigger a custom event" предложит вам задать сущность, которую нужно передать для запуска рабочего процесса.

Рекурсивное событие (Recurring event)

Данное событие определяется в разделе API вашего приложения и производит над сущностью повторяющиеся действия.

Имя события (Event name)

Введите имя рабочего процесса

Тип сущности (Type of thing)

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

Игнорировать правила конфиденциальности при запуске рабочего процесса (Ignore privacy rules when running the workflow)

Рекурсивный процесс запускается в контексте конкретного пользователя. Соответственно, применяются все правила конфиденциальности. В некоторых случаях вам нужно будет обойти данные правила, чтобы запустить рабочий процесс от имени администратора с полными правами доступа к данным, даже при запуске без аутентификации. Поставьте здесь галочку, чтобы обойти правила конфиденциальности, заданные в разделе "Конфиденциальность"/"Privacy" вкладки "Данные"/"Data".

Предупреждение: Так как это касается безопасности и конфиденциальности, пользоваться данной функцией стоит с осторожностью.