Найти идентификатор варианта списка по названию
Помогает записать в поле CRM вариант, когда известно только его название.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Робот полезен для интегратора и администратора CRM, заполняющего поля-списки. Внешняя система передаёт название варианта, а в поле CRM нужен его ID. Робот ищет точное название и отдельно сообщает неоднозначность, чтобы случайно не выбрать одноимённый вариант.
Что делает и когда применять
Помогает записать в поле CRM вариант, когда известно только его название.
Сравнивает название точно, с учётом регистра и пробелов. При нескольких совпадениях возвращает их список и признак неоднозначности; один вариант произвольно не выбирает.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.
Узнайте тип CRM и исходный код пользовательского поля-списка. Скопируйте название варианта точно, сохраняя регистр и пробелы. Поле и его варианты должны уже существовать.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Найти идентификатор варианта списка по названию». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Узнайте тип CRM и исходный код пользовательского поля-списка. Скопируйте название варианта точно, сохраняя регистр и пробелы. Поле и его варианты должны уже существовать.
- Заполните Тип CRM: 1 — лид, 2 — сделка, 3 — контакт, 4 — компания, 31 — счёт, ID смарт-процесса, Код поля: title, TITLE или UF_CRM_…, Точное название варианта. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.
Параметры робота
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
Тип CRM: 1 — лид, 2 — сделка, 3 — контакт, 4 — компания, 31 — счёт, ID смарт-процесса (ENTITY_TYPE_ID) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
Код поля: title, TITLE или UF_CRM_… (FIELD) |
Формат: строка. | Обязательно. Значение по умолчанию в настройках не задано |
Точное название варианта (LABEL) |
Формат: строка. | Обязательно. Значение по умолчанию в настройках не задано |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- Тип CRM: 1 — лид, 2 — сделка, 3 — контакт, 4 — компания, 31 — счёт, ID смарт-процесса (
ENTITY_TYPE_ID):2. - Код поля: title, TITLE или UF_CRM_… (
FIELD):UF_CRM_DELIVERY_MODE. - Точное название варианта (
LABEL):Самовывоз.
Если в поле есть ровно один вариант «Самовывоз», результат содержит его ID, found=Y и ambiguous=N. Несколько одноимённых вариантов дадут список совпадений и неоднозначность; робот не выбирает один из них произвольно.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
Единственный найденный идентификатор (id) |
строка |
Все совпавшие идентификаторы (matches) |
строка, несколько значений |
Есть совпадения (found) |
да/нет |
Найдено несколько вариантов (ambiguous) |
да/нет |
Статус выполнения (status) |
да/нет |
Пояснение ошибки (error) |
строка |
Подставляйте «Единственный найденный идентификатор» в последующую запись поля только после found=Y и ambiguous=N. При неоднозначности направьте справочник администратору, сохранив все совпавшие ID.
Ошибки и ограничения
Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.