Предыдущее значение поля
Робот «Предыдущее значение поля» возвращает в бизнес-процесс Битрикс24 то, каким поле было до последнего изменения: прежнее значение, новое значение, время изменения и ID пользователя, который его внёс. Работает со сделками, лидами, контактами, компаниями и смарт-процессами; нужна включённая история изменений полей.
Робот читает историю изменений, которую приложение ведёт на вашем портале Битрикс24, и отдаёт последнее изменение одного поля: значение до, значение после, время и ID пользователя. История изменений полей должна быть включена в настройках приложения; если она выключена или поле ещё не менялось, робот не падает, а возвращает признак «найдено» = N, поэтому нормальный путь не приходится оборачивать в обработку ошибок. Поле указывается кодом в том виде, как его отдаёт REST Битрикс24: title, opportunity, ufCrm_123; телефоны, почта, сайты и мессенджеры задаются как phone, email, web, im. По умолчанию берётся элемент, на котором идёт процесс; режимы «по ID» нужны, когда процесс идёт на другом элементе. Если поле изменили в фоне без пользователя (например, робот или бизнес-процесс после паузы), признак изменения без пользователя равен Y, а ID пользователя — 0.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| Код поля (например, title, opportunity, ufCrm_123; для телефонов, почты, сайтов и мессенджеров — phone, email, web, im) | string | да | |
| Элемент | select | — | auto |
| ID элемента (для режимов «по ID») | string | — | |
| ID типа смарт-процесса (только для режима смарт-процесса) | string | — |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Значение поля до последнего изменения | string |
| Значение поля после последнего изменения | string |
| Когда поле менялось в последний раз | datetime |
| ID пользователя, который сделал изменение; 0, если изменение сделано в фоне без пользователя. Для изменения, которое история ещё не записала, — последний редактор элемента | int |
| Изменение сделано в фоне без пользователя (например, роботом или бизнес-процессом после паузы); Y и для изменения, которое история ещё не записала (Y/N) | bool |
| Изменение найдено (Y/N) | bool |
| Успешно | bool |
| Сообщение о результате | string |
Какие ошибки может вернуть робот?
Эти сообщения робот пишет в журнал бизнес-процесса, когда не может выполнить шаг. По тексту видно, что исправить в настройках или данных.
- Не указан код поля.
- Для этого элемента история изменений не ведётся. Робот работает с лидами, сделками, контактами, компаниями и смарт-процессами; для режимов «по ID» укажите корректный ID.
- Не удалось прочитать историю изменений. Запустите шаг позже; если ошибка повторяется, напишите в поддержку.
Сценарий: уведомить руководителя, если сумму сделки снизили
- Робот стоит на стадии «Согласование» и читает поле opportunity
- Он возвращает прежнюю и новую сумму, а также ID сотрудника, который её менял
- Если новая сумма меньше прежней, руководителю уходит уведомление с обеими цифрами