Скопировать одно поле между элементами CRM
Переносит значение одного совместимого поля из исходной карточки в указанную карточку.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Робот полезен для администратора, переносящего согласованные сведения между карточками. При передаче сделки в другой процесс одно поле приходится заполнять повторно. Робот копирует его в совместимое поле другой карточки, сохраняя значение и множественность.
Что делает и когда применять
Переносит значение одного совместимого поля из исходной карточки в указанную карточку.
Тип и множественность должны совпадать. Для списков должны совпадать идентификаторы и названия вариантов. Пустое исходное поле также копируется; обязательное поле очистить нельзя. Поддерживаются строки, текст, ссылки, числа, Да/Нет, даты ISO, списки и простые привязки. Файлы и составные поля (включая телефоны и e-mail CRM) не изменяются. Код пользовательского поля указывайте в исходном виде UF_CRM_…. Не запускайте параллельно несколько изменений одного поля: между чтением и записью другой процесс может изменить его.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.
Проверьте типы обоих полей и их множественность. Для списков должны совпадать ID и названия вариантов. Учтите, что пустое исходное поле тоже копируется и может очистить необязательное поле получателя.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Скопировать одно поле между элементами CRM». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Проверьте типы обоих полей и их множественность. Для списков должны совпадать ID и названия вариантов. Учтите, что пустое исходное поле тоже копируется и может очистить необязательное поле получателя.
- Заполните Тип CRM: 1 — лид, 2 — сделка, 3 — контакт, 4 — компания, 31 — счёт, ID смарт-процесса, Код поля: title, TITLE или UF_CRM_…, ID элемента CRM, Тип CRM получателя, ID элемента получателя, Код поля получателя. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.
Параметры робота
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
Тип CRM: 1 — лид, 2 — сделка, 3 — контакт, 4 — компания, 31 — счёт, ID смарт-процесса (ENTITY_TYPE_ID) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
Код поля: title, TITLE или UF_CRM_… (FIELD) |
Формат: строка. | Обязательно. Значение по умолчанию в настройках не задано |
ID элемента CRM (ITEM_ID) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
Тип CRM получателя (TARGET_ENTITY_TYPE_ID) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
ID элемента получателя (TARGET_ITEM_ID) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
Код поля получателя (TARGET_FIELD) |
Формат: строка. | Обязательно. Значение по умолчанию в настройках не задано |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- Тип CRM: 1 — лид, 2 — сделка, 3 — контакт, 4 — компания, 31 — счёт, ID смарт-процесса (
ENTITY_TYPE_ID):2. - Код поля: title, TITLE или UF_CRM_… (
FIELD):UF_CRM_DELIVERY_NOTE. - ID элемента CRM (
ITEM_ID):501. - Тип CRM получателя (
TARGET_ENTITY_TYPE_ID):2. - ID элемента получателя (
TARGET_ITEM_ID):502. - Код поля получателя (
TARGET_FIELD):UF_CRM_DELIVERY_NOTE.
При исходном значении «Въезд со двора» оно переносится из сделки 501 в сделку 502. Если поле получателя уже равно исходному, фактического изменения может не быть. Несовместимые типы нужно исправить до запуска.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
Итоговое значение в JSON (result) |
текст |
Поле изменено (changed) |
да/нет |
Статус выполнения (status) |
да/нет |
Пояснение ошибки (error) |
строка |
Проверьте статус и «Поле изменено», затем используйте «Итоговое значение в JSON» для следующего согласования. Для файлов и составных контактных полей выбирайте специализированные действия.
Ошибки и ограничения
Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.