Elbuz записує кожну виконану команду правила в «Журнал операцій» і сам позначає на схемі правила без умови, без дій або з можливою петлею. Так помилку видно до того, як правило напише сотні листів.
Коли це знадобиться:
- Правило ввімкнене, а листа немає — журнал покаже, чи дійшла команда до виконання і чому не вдалася.
- Нове правило збираєтеся ввімкнути на всі записи — спершу перевірка на одному документі з вузькою умовою.
- Пошта не приймає листи за правилом — після трьох невдач надсилання стає на паузу.
- Правило вже наробило зайвого — проводку скасовують, зайві картки контрагентів прибирають у кошик.
З чого почати: «Автоматичні правила» → кнопка «Схема правил» у шапці.
Що допоможе перевірити правило
- «Схема правил» — граф усіх правил з попередженнями про порожню умову, вимкнені дії й можливу петлю.
- «Журнал операцій» — рядок на кожну виконану команду, «Не виконано!» і причина поруч.
- Пауза листів — після трьох невдач поспіль лист по запису не надсилається, поки ви не виправите шаблон чи скриньку.
- Небезпечні місця — петля, масове спрацювання при імпорті, кілька правил на одній події.
- Обрив виконання — що лишилося виконаним і що станеться при повторному збереженні.
- Прибирання наслідків — скасування проводки, зайві контрагенти й організації.
Де це і хто має доступ
- Меню
- Кабінет → Журнал операцій
- Схема правил
- кнопка «Схема правил» у шапці вікна «Автоматичні правила»
- Право доступу
- вікно «Автоматичні правила»; у схеми окремого права немає
Схема правил: три попередження
У шапці вікна є кнопка «Схема правил». Вона малює граф усього, що налаштовано: подія → правило з умовою → команди по порядку. Схема тільки для перегляду; правило відкривається на редагування кліком по олівцю в кутку блока.
Зверху — фільтр «Розділ» зі значеннями «Усі правила», «Документи», «Контрагенти» і «Компанії» (останній завжди порожній: правил цього розділу з інтерфейсу не завести), галочка «Лише увімкнені» і лічильник «Правил: … · увімкнено: … · дій: …».
1
Подія2
Правило3
Команда- Блок події — від нього йдуть усі правила, налаштовані на цю подію.
- Блок правила: під назвою підписано умову звичайними словами.
- Блок команди: команди намальовані ланцюжком у порядку виконання.
Головне в ній — три попередження, які програма ставить сама. Це готова самоперевірка: швидше, ніж відкривати кожне правило окремо.
| Напис на блоці | Що це означає |
|---|---|
| «Умови немає — спрацює на кожній події» | правило ввімкнене, а умова порожня: команди підуть по кожному документу чи контрагенту без розбору |
| «Усі дії вимкнено — правило нічого не робить» | правило ввімкнене, але жодної ввімкненої команди в ньому немає |
| «Змінює той самий запис, який слухає — можлива петля» | правило підписане на подію документа й саме змінює документ (або те саме з контрагентом) |
Там же видно й дрібніші речі: у блоці правила підписано умову звичайними словами або «Без умови — на кожну подію», а в блоці команди — назву шаблону листа чи «Шаблон листа не задано», назву процесу чи «Процес не обрано».
Якщо на одній події висить кілька правил, під нею стоїть підпис «Правил на цій події: N» — нагадування, що спрацюють вони всі, одне за одним.
Де видно, що правило спрацювало
Кожна виконана команда лишає рядок у «Журналі операцій» — це вікно відкривається з меню «Кабінет» → «Журнал операцій». Рядок виглядає так:
«Трігер #7 заказ - статус - в обработке Виконання команди: #8 Надіслати листа»
Тобто: номер правила, його назва, номер команди, назва команди. Якщо команда не вдалася, попереду дописується «Не виконано!», а сам рядок фарбується як помилка:
«Не виконано! Трігер #7 заказ - статус - в обработке Виконання команди: #8 Надіслати листа»
Причину невдачі шукайте в сусідніх рядках журналу за той самий момент. Для листа це буде окремий запис «Лист не надіслано!» з адресою, темою й текстом помилки поштового сервера, або «Не вказано E-mail!», якщо отримувач у шаблоні не заповнений.
Порожньо в журналі означає інше: команда взагалі не дійшла до виконання. Або умова не виконалася, або ця команда вже відпрацювала по цьому запису раніше.
Лист не надсилається тричі — пауза
Якщо лист за тригером не вдалося надіслати по одному й тому самому запису тричі, програма перестає пробувати: до рядка «Не виконано!» дописується «Лист не надіслано 3 рази поспіль — надсилання для цього запису призупинено до зміни шаблону листа або поштової скриньки.». Так непрацююча скринька не засипає журнал сотнями однакових помилок.
Пауза знімається сама, щойно ви збережете шаблон листа цієї команди або будь-яку поштову скриньку: наступного разу лист спробує піти знову.
Про таку проблему нагадує й «Мій день» на робочому столі — сигнал «Листи за тригером не надсилаються» з назвою правила й останньою помилкою (його бачать ті, кому відкрите вікно тригерів). Клік веде туди, де виправляти: у «Шаблони листів», якщо помилка в шаблоні, або в «Підключення пошти», якщо не так із сервером, логіном, паролем чи адресою відправника.
Небезпечні місця
Петля
Правило слухає «Документ: оновлення» і командою «Змінити дані документа» правит той самий документ. Нової події від цього не буде: кожна команда, яка щось міняє або створює, позначає власну правку службовою ознакою, і програма її ігнорує. Проводки це теж стосується — команда, яка проводить документ, події «Документ: проводка (підпис)» не піднімає.
Один шлях по колу все ж лишається — команда «Запустити процес (Flow)». Процес працює у фоні й зберігає записи як звичайний користувач, тому його правки події піднімають на повну. Саме проти цього і зроблено обмеження «не частіше ніж 3 рази за 10 хвилин».
Журнал спрацювань тут не рятує: він гасить лише повтор того самого правила по тому самому запису, а два різні правила для нього не пов’язані.
Масове спрацювання при імпорті
Подія піднімається на кожен збережений запис, а не на кожне натискання кнопки. Завантаження файлу із замовленнями, синхронізація з сайтом, інтеграція по API — усе це створює документи по одному, і правило відпрацює по кожному. Тисяча рядків імпорту з увімкненим правилом «Надіслати листа» без умови означає тисячу листів, надісланих синхронно, прямо всередині імпорту.
Перед першим увімкненням правила з командою, яка надсилає щось назовні — лист, SMS, HTTP-запит, — перевірте його на одному записі. Порядок такий: залиште тумблер «Активність» знятим, зберіть умову якнайвужче (наприклад, номер конкретного документа), увімкніть, збережіть той документ руками, подивіться «Журнал операцій». І тільки потім розширюйте умову. Скасувати надісланий лист неможливо.
Кілька правил на одній події
Спрацюють усі, які підходять під свою умову, — по черзі, у порядку поля «Порядок виконання», а при однаковому порядку — за назвою. Зупинити наступні правила перше не може: механізму «далі не йти» немає. Тому дві команди «Змінити дані документа» з різних правил на одну подію просто перезапишуть одна одну, і виграє та, що виконалася останньою.
Якщо виконання обірвалося посередині
Команди правила виконуються по черзі, і кожна успішна команда записується в журнал спрацювань окремо, слідом за своїм виконанням. Спільного «все або нічого» для команд немає. Тому, якщо запит обірвався посеред правила, стан такий:
- команди, що встигли виконатися, лишаються виконаними й мають запис у журналі спрацювань. Надісланий лист, SMS чи HTTP-запит не відкликаються;
- команди, до яких черга не дійшла, не виконувались і запису не мають;
- правила, які стояли на цій події далі за списком, теж не виконувались.
Зберегти запис ще раз можна. Якщо умова знову виконується, програма пройде всі команди заново: ті, що мають запис у журналі, пропустить (при «Періоді перевірки» 0 або поки строк періоду не минув), а ті, що не дійшли, виконає. Повторне збереження не задвоює вже надісланого.
Три винятки, про які варто знати:
- якщо обрив стався між виконанням команди і записом у журнал, при повторі ця команда виконається ще раз — наприклад, лист піде вдруге;
- команди з позначкою «Не виконано!» запису в журналі не отримують, і повторне збереження спробує їх знову;
- якщо умова побудована на пункті «Початкове значення», повторне збереження без зміни поля умову не виконає — решта команд не спрацює, поки поле не зміниться знову.
Як прибрати наслідки помилкового правила
Спершу вимкніть правило тумблером «Активність» — інакше воно продовжить працювати, поки ви прибираєте. Далі все залежить від того, що саме правило встигло зробити.
Проведені документи і залишки
Проведений правилом документ скасовують вручну або правилом — значенням 0 у полі проводки команди «Змінити дані документа»: прихід знімається зі складу, списане й переміщене повертається. Що рухає кожен тип документа і коли зворотного руху не буде, — у розділі про проводку з правила.
Зайві контрагенти й організації
Команда «Створити контрагента» не створює дубль, якщо такий контрагент уже є: перед створенням вона шукає картку з тією самою поштою, а якщо пошти в полях команди немає — з тією самою назвою. Знайшла — нової картки не буде, а команда вважається виконаною. Якщо пошту задано, але вона некоректна, картка не створюється зовсім.
Зайві картки видаляються зі списку контрагентів звичайною кнопкою видалення, і документи при цьому не страждають:
- видалення переносить картку в «Кошик». Звʼязки з документами, прайсами та історія лишаються як були, а кнопка «Відновити» повертає картку разом з усім цим;
- «Видалити назавжди» в кошику стирає картку разом з її прайсами та їхніми налаштуваннями, історією й реєстрацією клієнта в магазині, а товари відвʼязуються від цього постачальника. Документи лишаються, але посилання на контрагента в них обнуляється. Те саме робить автоочищення: картки, що лежать у кошику довше 60 днів, стираються без вашої участі;
- організація, створена правилом, — це такий самий запис списку контрагентів, його видно в розділі «Організації», і видаляється він так само. Перш ніж видаляти, перевірте, що правило не взяло наявну картку: якщо організація з такою назвою чи зовнішнім ID уже була, команда «Створити організацію» нової не заводить, а ставить у документ ту, що є, і записує в неї поля з правила. Картку контрагента з події команда не змінює;
- власну організацію не видалити ні в кошик, ні назавжди — програма відмовить.
Сценарії
- Нове правило з листом клієнтам — перед увімкненням відкрийте «Схему правил»: напис «Умови немає — спрацює на кожній події» означає, що лист піде всім. Далі — перевірка на одному документі.
- Попереду імпорт тисячі замовлень — правило без умови відпрацює по кожному рядку прямо всередині імпорту. Вимкніть правила, які надсилають листи, SMS чи HTTP-запити, або звузьте їхню умову.
- Правило змінило не ті документи — вимкніть його тумблером «Активність», знайдіть зачеплені записи в «Журналі операцій» за назвою правила й поправте поля чи скасуйте проводку. Як шукати: якщо формула записала не те.
- Два правила пишуть в одне поле — виграє те, що виконалося останнім за «Порядком виконання». Розведіть їх умовами або порядком (кілька правил на одній події).
Що робити, коли правило поводиться не так
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «Не виконано! Трігер #7 заказ - статус - в обработке Виконання команди: #8 Надіслати листа» | Команда виконалася невдало. Причина написана окремим рядком журналу за той самий момент | Знайти сусідній рядок у «Журналі операцій» (про журнал) |
| «Лист не надіслано!» | Поштовий сервер відмовив: у рядку далі йдуть адреса, тема й текст помилки | Перевірити налаштування поштового сервера та адресу отримувача в шаблоні листа |
| «Не вказано E-mail!» | У шаблоні листа порожній отримувач: макрос не підставився, бо в картці контрагента немає пошти | Заповнити пошту в картці контрагента або задати отримувача в шаблоні явно |
| Правило заведене з «Шаблонів повідомлень» спрацьовує на кожну подію | Умову там зібрати нема з чого: звідти створюється без прив’язки до документів чи контрагентів, а список полів умови береться саме від неї | Вимкнути правило й створити його заново зі списку документів або контрагентів (точки входу) |
| Правило спрацьовує на кожен документ підряд | Умова порожня. Правило створюється ввімкненим, тому працює ще до того, як ви задали умову | Відкрити «Схему правил»: там таке правило позначене написом «Умови немає — спрацює на кожній події» (про схему) |
| Правило ввімкнене, умова правильна, і все одно нічого | Усі команди правила вимкнені окремими галочками в третій секції | У «Схемі правил» це напис «Усі дії вимкнено — правило нічого не робить» (про схему) |
| Замість вікна — картинка «доступ заборонено» | У групі користувача немає права на вікно «Автоматичні правила» | Видати право в налаштуваннях груп (про доступ) |
| «Помилка оновлень» | Правка рядка прямо в сітці правил не збереглася | Оновити вікно пунктом «Оновити» в меню шапки й повторити |
Часті запитання
Скільки разів спрацювало правило?
Лічильника в інтерфейсі немає. Рахуйте рядки «Журналу операцій», відфільтровані за номером і назвою правила.
Чому в «Схемі правил» розділ «Компанії» порожній?
Правил цього розділу з інтерфейсу не завести, тому фільтр «Компанії» завжди показує порожню схему. Правила документів і контрагентів видно у своїх розділах.
Чому після збою лист пішов клієнту двічі?
Збій стався між надсиланням листа і записом у журнал спрацювань. При повторному збереженні програма не знала, що лист уже пішов (про обрив).
Чи можна змінити правило прямо на схемі?
Ні, схема тільки для перегляду. Олівець у кутку блока правила відкриває його картку на редагування.
Чи видно на схемі, який шаблон листа використовує команда?
Так. У блоці команди підписано назву шаблону листа або «Шаблон листа не задано», для процесу — його назву або «Процес не обрано».
Суміжні теми
- Якщо потрібна загальна картина, — як працюють автоматичні правила.
- Якщо правило мовчить, бо вже відпрацювало по запису, — повтори й «Період перевірки».
- Якщо формула записала в поле не те значення, — як виправити формулу.
- Якщо треба знайти, хто й коли змінив запис, — журнал операцій.