Тригер: У певну дату

Мова: Українська
Цю статтю перекладено з англійської за допомогою ШІ, тому вона може містити помилки. Ваші відгуки допоможуть нам її покращити.

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

Тоді як тригери записів реагують на дії користувача, цей тригер реагує на календар: повторний візит, який має відбутися через три дні, грант, термін дії якого закінчується наприкінці місяця, реєстрація, якій сьогодні виповнився рік. Це тригер, який слід використовувати для нагадувань, кінцевих термінів та річниць.

Тригер «У певну дату» в редакторі автоматизації
Тригер «У певну дату» в редакторі автоматизації

Налаштування

| Налаштування | Опис ||---------|-------------|| Форма | Форма, записи якої перевіряються. Як і в інших тригерах, записи з підформ не враховуються; виберіть саму підформу, щоб запланувати дію на основі одного з її полів. | | Поле дати | Поле дати форми, яке встановлює розклад. Пропонуються лише поля дати: поля тижня, місяця та обчислювані поля використовувати не можна. Запис, у якому поле дати пусте, ніколи не запускає тригер. | | Часовий пояс | Часовий пояс, у якому інтерпретується час доби та сам календарний день. За замовчуванням використовується часовий пояс вашого браузера. | | Час доби | Година від 00:00 до 23:00, коли спрацьовує тригер. | | Коли починати | Перший день, коли тригер спрацьовує для запису, відносно дати в полі: У дату поля, за певну кількість днів до дати поля або за певну кількість днів після дати поля. Кількість днів може сягати 3650. | | Як довго повторювати | Протягом скількох послідовних днів, починаючи з першого дня, тригер продовжує спрацьовувати для того самого запису. Дивіться нижче. |

Як довго повторювати

| Вибір | Ефект ||--------|--------|| Один раз | Тригер спрацьовує для запису лише в перший день. | | Щодня до дати в полі | Тригер спрацьовує в перший день і кожного наступного дня аж до дати в полі включно. Цей вибір доступний, лише якщо тригер запускається за певну кількість днів до дати в полі. | | Протягом кількох днів | Тригер спрацьовує в перший день і в наступні дні протягом введеної вами кількості днів, до 366. |

Кілька прикладів для запису, у полі дати якого вказано 20 листопада:

| Коли починати | Кількість днів | Як довго повторювати | Спрацьовує ||---------------|----------------|--------------------|----------|| У дату поля | | Один раз | 20 листопада | | Днів до дати поля | 3 | Один раз | 17 листопада | | Днів до дати поля | 3 | Щодня до дати в полі | 17, 18, 19 та 20 листопада | | Днів після дати поля | 1 | Протягом кількох днів: 7 | 21-27 листопада |

Як спрацьовує тригер

ActivityInfo перевіряє кожну автоматизацію У певну дату раз на годину. Коли година в часовому поясі тригера збігається з часом доби тригера, система шукає записи форми, поле дати яких робить цей день днем спрацювання, і запускає по одному виконанню на запис. Виконання з'являються в Історії автоматизації, як і виконання будь-якого іншого тригера.

Варто знати про кілька наслідків такого розкладу:

  • Запис спрацьовує щонайбільше раз на день. Якщо кроки автоматизації не вдаються і повторюються, або якщо перевірка запускається двічі, запис не отримує другого виконання того ж дня.
  • Запис перевіряється раз на день у вибраний час. Запис, який додано або дату якого змінено пізніше протягом дня, не буде оброблено того ж дня. Він спрацює в наступний день спрацювання, якщо це передбачено налаштуваннями повторення.
  • Зміна запису в проміжку не має значення. Тригер дивиться лише на значення поля дати в день перевірки. Видалення запису зупиняє його спрацювання.
  • Призупинена автоматизація не спрацьовує. Відновлення автоматизації не надолужує дні, коли вона була призупинена.
  • Враховується лише обраний час доби. У день переходу на літній час пропущена година не настає; тригер, налаштований на спрацювання в цю годину, того дня не спрацює.
  • Автоматизація запускає щонайбільше 10 000 виконань на день. Якщо в один день підпадає більше записів, решта записів пропускається на цей день.

Кроки фільтрації

Коли крок фільтрації йде одразу після тригера, ActivityInfo застосовує його умову під час пошуку записів, а не запускає виконання для кожного запису і зупиняє більшість із них на фільтрі. Тому запис, відхилений фільтром, взагалі не з'являється в історії автоматизації. Фільтри, що йдуть після кроку дії, поводяться як зазвичай.

Умова може використовувати дані кроку тригера, включно з _trigger.date та _trigger.field. Під час пошуку записів ActivityInfo перевіряє умову за власними даними форми: вона зчитує _trigger.date з поля дати кожного запису, а _trigger.field є назвою поля. _trigger.time не має відповідника в даних форми, тому умову, яка його використовує, не можна перевірити під час пошуку записів. Натомість цей фільтр виконується як звичайний крок, після запуску виконання, і відхилені ним записи з'являються в історії.

Видалені поля та форми

Якщо поле дати або сама форма були видалені, автоматизацію більше не можна перевірити. Щодня в історії автоматизації записується одне невдале виконання, в якому вказується відсутнє поле або форма, і автоматизація показує помилку, доки тригер не буде відредаговано для використання іншого поля, або доки автоматизацію не буде призупинено чи видалено.

Дані кроку

Кожен тригер створює один рядок даних кроку: значень, на які можуть посилатися наступні кроки автоматизації (кроки фільтрації, емейлу та вебхука) у формулах та шаблонах.

Для цього тригера рядок описує запис, дата якого запустила тригер:

| Стовпець | Тип | Опис ||--------|------|-------------|| один стовпець на кожне поле форми | тип поля | Значення кожного поля запису. Див. Посилання на поля. | | _id | Текст | Ідентифікатор запису. | | _lastEditTime | Дата і час | Час останньої зміни запису. | | _trigger.type | Текст | Для цього тригера завжди DATE_FIELD. | | _trigger.time | Дата і час | Запланований час спрацювання: час доби тригера в день спрацювання, наприклад, 09:00 17 листопада. | | _trigger.date | Дата | Значення поля дати, яке запустило тригер, наприклад, 2026-11-20. | | _trigger.field | Текст | Назва поля дати, яке запустило тригер. |

Якщо форма є підформою, рядок також містить стовпець Parent, що посилається на батьківський запис.

Стовпця _user немає: ніхто не виконував жодних дій для запуску виконання. Формули та шаблони, що посилаються на _user, відхиляються редактором, коли тригер — «У певну дату». Так само немає стовпця _previous.

Вебхуки

Крок вебхука надсилає запис у форматі корисного навантаження Стандартний або Налаштування, як зазвичай. Формат, сумісний з ActivityInfo 4.0, не може описати заплановану подію, тому крок вебхука, налаштований з цим форматом, надсилає Стандартне корисне навантаження, коли його автоматизація використовує цей тригер.

Дивіться також

Наступний елемент
Крок «Фільтр»