Як вибрати подію й задати умову правила

7 хв

Elbuz виконує команди правила лише тоді, коли сталася вибрана подія і запис підходить під умову. Подія відповідає на питання «коли перевіряти», умова — «чи цей запис нас цікавить».

Коли це знадобиться:

  • Лист має йти тільки на замовлення покупця — умова за типом документа відсіє решту документів.
  • Потрібна реакція на зміну статусу, а не на кожне збереження — пункт «Початкове значення» ловить саме зміну.
  • Нагадувати про оплату через три дні після строку — підстановка дати в умові рахує строк сама.
  • Нагадування має повторюватися щодня — «Період перевірки» дозволяє повтор по тому самому запису.

З чого почати: «Автоматичні правила» → «Додати» → вибрати подію.

Що вміють подія й умова

Де це і хто має доступ

Пункту меню в правил немає: вікно відкривається зі списку документів чи контрагентів (усі входи).

Подія
«Автоматичні правила» → «Додати» → список подій
Умова
картка правила → секція «Умова»
Право доступу
вікно «Автоматичні правила» з правом редагування

Події, на які можна повісити правило

Подій дванадцять. Шість про контрагентів, пʼять про документи і одна про підтвердження заявки AI-агента.

Повний список подій
Подія у спискуКоли піднімається
Контрагент: додаваннястворення картки контрагента
Контрагент: збереженнязбереження картки контрагента
Контрагент: видаленнявидалення контрагента — картка при цьому переїжджає в кошик і лишається доступною правилу
Контрагент API: додаваннястворення контрагента зовнішньою системою через API
Контрагент API: збереженнязбереження контрагента через API
Контрагент API: видаленнявидалення контрагента через API
Документ: додаваннястворення документа, зокрема замовлення з сайту
Документ: оновленнязбереження документа; плюс раз на 32 хвилини системний розклад обходить непроведені документи за останні 30 днів
Документ: видаленнярядок у списку є, але правило на нього не працює: до моменту перевірки документа вже немає в базі
Документ: проводка (підпис)проведення документа і скасування проводки
Документ: прострочено оплатутільки від системного розкладу, раз на 32 хвилини
AI-агент: підтвердження виконанопісля того, як людина схвалила заявку AI-агента на зміну даних; ця подія пропонується тільки у вікні, відкритому з «Шаблонів повідомлень», — а звідти правило виходить без умови (чому)

Прострочена оплата — окремий випадок

Ця подія не приходить від дії людини: її раз на 32 хвилини створює системний розклад. Він бере документи, у яких «Оплатити до» вже минуло, але не більше ніж 90 днів тому, і в яких не проставлена дата оплати — до 300 документів за прогін, починаючи з найновіших.

Тим самим прогоном розклад обходить непроведені документи за останні 30 днів — теж до 300 найновіших — і піднімає для них «Документ: оновлення».

Це рядок системного розкладу акаунта, заводити його не потрібно — він уже є. Але якщо розклад в акаунті вимкнений, подія не прийде взагалі: ні про прострочену оплату, ні про непроведені документи.

Коли ви створюєте правило саме на прострочену оплату, програма одразу підставляє в нього умову-зразок: «Оплатити до» менше {current_date}. Її можна залишити як є або переписати під себе.

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

Умова: що саме перевіряється

Умова збирається конструктором: поле, оператор, значення — і так скільки завгодно рядків, зʼєднаних «і» або «або». Під конструктором програма розшифровує зібране звичайними словами, щоб можна було перечитати й переконатися, що вийшло саме те, що задумували.

Секція «Умова» з конструктором, розшифровкою та підказкою підстановок дати
1Конструктор умови
2Розшифровка умови
3Зберегти умову
  1. У конструкторі рядок за рядком збирається умова: поле, оператор, значення.
  2. Світла плашка одразу показує, у що склалась умова, звичайними словами.
  3. Умова зберігається окремою кнопкою — решта полів картки зберігається сама.

Список полів береться з вашої сітки документів або контрагентів. Це дає доступ до сотень полів, включно з вашими власними, але має зворотний бік: у співробітника, який ще жодного разу не відкривав відповідний список, конструктор буде порожнім. Лікується просто — відкрити список, налаштувати колонки й повернутися до правила.

Оператори залежать від типу поля:

  • число — дорівнює, не дорівнює, менше, менше або дорівнює, більше, більше або дорівнює, між;
  • дата і текст — усе перелічене плюс порожньо, не порожньо, містить, не містить;
  • статус документа, статус і вид оплати, статус і вид доставки, група контрагента, мова, валюта — дорівнює, не дорівнює, з указаних, не з указаних, зі списком готових значень;
  • склад і тип документа — дорівнює і порожньо;
  • так/ні — тільки дорівнює, зі списком «Так» і «Ні».

Залишки позицій документа умова бачить лише в події «Документ: проводка (підпис)»: там зʼявляється поле «Залишок товару на складі». В інших подіях такого поля немає.

Підстановки дат

У значенні умови замість конкретної дати можна написати підстановку, і програма підмінить її в момент перевірки. Їх три: {current_date}, {current_datetime} і {current_time}. До кожної дописується зсув: знак плюс або мінус, число і одиниця — minute, hour, day, week, month, year.

У самій програмі ці зразки лежать під написом «Підказка: підстановки дати в умовах», кліком по зразку він копіюється. Приклад із підказки: умова «Оплатити до» менше {current_date-3day} означає «прострочено більше трьох днів».

«Початкове значення» — реакція на зміну

У списках значень статусів документа, оплати й доставки, видів оплати й доставки, мови й валюти є окремий пункт «Початкове значення». Він працює тільки в парі з оператором «не дорівнює» і читається так: «поле стало не таким, яким було до збереження». Тобто правило спрацює саме на зміну, а не на кожне збереження картки.

У списках складу й компанії цей пункт теж видно, але скористатися ним там не вийде: оператора «не дорівнює» для цих полів немає — тільки «дорівнює» і «порожньо».

У цього пункту є другий, менш очевидний ефект: коли значення справді змінилося, програма чистить журнал спрацювань для цього запису. Тому правило зі «Початковим значенням» може спрацьовувати по одному й тому самому документу знову й знову — щоразу, коли поле змінюється.

Умова зберігається окремою кнопкою «Зберегти умову» під конструктором. Решта полів картки — назва, примітка, тумблер «Активність», «Період перевірки» — записуються самі, щойно ви пішли з поля, кнопки для них немає. Через це легко зібрати умову, закрити вікно й отримати правило зі старою умовою: назва збереглася, а умова ні.

Поруч стоїть «Очистити умову» — вона прибирає всі рядки з конструктора, але в базі умова лишається старою, поки ви не натиснули «Зберегти умову».

Один раз на запис — і більше ніколи

Це найчастіше джерело питання «правило ввімкнене, а листа немає». Програма веде окремий журнал спрацювань: для кожної пари «команда + запис» вона запамʼятовує, що вже відпрацювала. Другого разу по тому самому документу команда не виконається.

Поведінкою керує поле «Період перевірки» в першій секції картки й сусіднє поле «Одиниця виміру» зі значеннями: секунд, хвилин, годин, днів, тижень, місяців, кварталів, років.

  • 0 — значення, з яким правило створюється. Означає «жодного повтору»: одна команда, один запис, один раз за все життя правила.
  • Більше нуля — запис у журналі старший за вказаний строк видаляється, і команда може відпрацювати знову. «1 день» читається як «не частіше ніж раз на добу по одному запису».

Третій спосіб отримати повтор — умова з пунктом «Початкове значення»: коли поле справді змінилося, журнал для цього запису чиститься повністю.

Сценарії

  • Один лист на кожне нове замовлення — подія «Документ: додавання», умова «Тип документа» дорівнює «Замовлення покупця», «Період перевірки» 0. Повністю: лист-підтвердження.
  • Нагадування щодня, поки рахунок не оплачено — подія «Документ: прострочено оплату», «Період перевірки» 1 день. Повністю: нагадування про оплату.
  • SMS лише тоді, коли змінили статус — умова «Статус документа» не дорівнює «Початкове значення» і дорівнює потрібному статусу. Повністю: SMS за статусом.
  • Прохання про відгук через три дні після відвантаження — подія «Документ: оновлення», умова з підстановкою дати, «Період перевірки» 0: нагадування має піти один раз.

Що робити, коли правило не реагує

Симптом, причина і що робити
Що ви бачитеЧому такЩо зробити
Правило ввімкнене, подія сталася, у журналі нічого Найчастіше — команда вже відпрацювала по цьому запису раніше, а «Період перевірки» дорівнює нулю Поставити «Період перевірки» більше нуля або додати в умову пункт «Початкове значення» (про повтори)
У секції «Умова» немає жодного поля для вибору Список полів береться з вашої сітки документів чи контрагентів, а ви цей список ще не відкривали Відкрити відповідний список, налаштувати колонки, повернутися до правила (про умову)
Зібрали умову, закрили вікно — умова стара Умова зберігається окремою кнопкою, решта полів картки — сама Натиснути «Зберегти умову» під конструктором (про умову)
Умова про прострочену оплату стоїть, а правило мовчить Ця подія приходить тільки від системного розкладу, раз на 32 хвилини, і лише для документів, у яких «Оплатити до» минуло не більше ніж 90 днів тому, а дата оплати не заповнена. За прогін розклад бере до 300 таких документів, починаючи з найновіших Перевірити, що оплата справді не проставлена і строк минув не більше ніж 90 днів тому (про прострочену оплату)
«Умову не збережено: замість поля в ній вираз. Відкрийте умову заново й збережіть ще раз.» Повідомлення зʼявляється на будь-яку помилку розбору умови: у лівій колонці вираз замість поля зі списку; оператор, якого конструктор не знає; для «між» заповнене одне значення з двох; групи поєднані не через AND/OR; умова пошкоджена. Майже завжди це умова, збережена старішою версією програми Закрити картку, відкрити знову, видалити дивні рядки, зібрати їх наново полями зі списку, заповнити обидва значення «між» і натиснути «Зберегти умову». Дату порівнювати підстановкою у значенні: «Оплатити до» → менше → {current_date-3day}

Часті запитання

Чи можна змінити подію в готовому правилі?

Ні. Подія вибирається один раз при створенні, у картці правила її не змінити. Потрібна інша подія — заведіть нове правило.

Чому замовлення, додане вручну, не отримало листа за правилом на додавання?

Подія створення, яку піднімає ручне додавання зі списку документів, не несе номера документа, і правило такий запис пропускає. Лист за «Документ: додавання» йде на замовлення, завантажені з сайту.

Чому правило на «Документ: видалення» нічого не робить?

На момент перевірки документа в базі вже немає. Для контрагента ця подія працює: картка переїжджає в кошик і лишається доступною правилу.

Чи можна зловити зміну складу чи компанії через «Початкове значення»?

Ні. У цих списках пункт видно, але оператора «не дорівнює» для складу й компанії немає — тільки «дорівнює» і «порожньо» (про «Початкове значення»).

Чому немає нагадування про рахунок, прострочений пів року тому?

Системний розклад бере лише документи, у яких «Оплатити до» минуло не більше ніж 90 днів тому. Старіші з відбору випадають.

Суміжні теми

Чи була стаття корисною?