Сохранить адрес указанного типа в реквизите
Робот «Сохранить адрес указанного типа в реквизите» создаёт отсутствующий адрес или меняет выбранные поля, проверяя прежние значения и сохранение остальных.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую задачу решает
Администратору CRM, который сохраняет согласованное изменение конкретного типа адреса выбранного реквизита.
Полная перезапись адреса способна затереть соседние поля. Робот принимает только выбранные изменения и сравнивает прежние значения перед записью. Это помогает заметить устаревшую подготовку, но не блокирует одновременные действия других пользователей.
Параметры и подготовка
| Поле | Как заполнить |
|---|---|
ID реквизита (REQUISITE_ID) |
Обязательное поле |
Тип адреса (TYPE_ID) |
Обязательное поле |
Новые значения JSON (UPDATES) |
Обязательное поле |
Прежние значения JSON или NONE (EXPECTED) |
Обязательное поле |
Уникальный ключ операции (OPERATION_KEY) |
Обязательное поле |
Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.
Как использовать
- Получите REQUISITE_ID и TYPE_ID из выбранного реквизита и справочника типов адреса. Предварительно прочитайте текущий адрес.
- В UPDATES передайте непустой объект новых текстовых полей. Для очистки конкретного поля задайте пустую строку, а не null.
- В EXPECTED передайте прежние значения ровно тех же полей. Для создания отсутствующего адреса используйте буквальное NONE без JSON-кавычек.
- Задайте уникальный OPERATION_KEY для этой операции. При неизвестном исходе сначала сверяйте адрес; не меняйте ключ ради повторной отправки.
- Проверьте статус, changed и replayed. Новый согласованный набор изменений требует нового ключа и свежих прежних значений.
Как заполнить JSON-поля
Новые значения JSON (UPDATES)
{
"CITY": "Новый город"
}
Непустой объект только выбранных адресных полей. Значения строки до 5000 символов; пустая строка очищает поле. {} запрещён.
Это объект с именованными полями. Не заменяйте его массивом []. Имена полей и их регистр должны совпасть с приведённым форматом.
Прежние значения JSON или NONE (EXPECTED)
{
"CITY": "Старый город"
}
Снимок прежних значений тех же ключей, что UPDATES. Возьмите их чтением адреса непосредственно перед подготовкой операции. Для отсутствующего адреса вместо JSON передайте буквальное NONE. Null допустим только как явно прочитанное значение.
Это объект с именованными полями. Не заменяйте его массивом []. Имена полей и их регистр должны совпасть с приведённым форматом.
Учебный пример и ожидаемый результат
Учебный адрес реквизита 81 типа 1 имеет CITY «Старый город». UPDATES={"CITY":"Новый город"}, EXPECTED={"CITY":"Старый город"}, OPERATION_KEY=address-demo-20261015-01. При подтверждённом прежнем значении ожидается changed=Y и новый CITY. Если город уже изменился другим пользователем, запись не должна продолжаться на устаревшем ожидании.
Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.
Что возвращает и как продолжить процесс
- «ID реквизита» (
requisiteId). - «Тип адреса» (
typeId). - «Адрес изменён» (
changed). - «Сохранённое подтверждение» (
replayed).
changed=N возможен, когда нужные значения уже установлены. replayed показывает возврат сохранённого подтверждения той же операции с повторной сверкой. Эти признаки не заменяют контроль итогового адреса при сообщении об ошибке.
Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Пояснение ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.
Ограничения и разбор ошибок
Принимает REQUISITE_ID, TYPE_ID, UPDATES: непустой JSON выбранных ADDRESS_1/ADDRESS_2/CITY/POSTAL_CODE/REGION/PROVINCE/COUNTRY/COUNTRY_CODE, EXPECTED: NONE для создания или JSON прежних значений тех же полей, OPERATION_KEY. Новые значения: строки до 5000 символов, пустая строка явно очищает поле. Ожидаемый null допустим только для явно прочитанного null, пропуск не равен null. Проверяет доступ и владельца, повторяет чтение перед записью, передаёт только выбранные поля и подтверждает результат, сохраняя прочитанные непрошенные текстовые поля. Уже нужные значения: no-op. Ключ защищает от повторной отправки при неизвестном результате. Возвращает ID, changed/replayed; адрес в хранилище повторов не сохраняет. Одновременные изменения не блокируются; сервисные поля адреса могут обновляться порталом.
Строки новых значений ограничены 5000 символами. Пропущенное поле не равно явно прочитанному null. При неоднозначном результате новая отправка по ключу блокируется; изменение могло сохраниться. Проверьте адрес вручную перед продолжением.