Заметки
Как в БП менять поле типа Сайт/Телефон/Email
Как в БП менять поле типа Сайт/Телефон/Email: fM-поля, мультиполя, ограничения роботов.
Телефон, email и сайт в CRM — это мультиполя, а не обычные строки.
Задача
Сначала нужно отделить бизнес-сценарий от технического механизма.
Задача — как в БП менять поле типа Сайт/Телефон/Email. В этой теме важны: FM-поля, мультиполя, ограничения роботов.
Перед правкой лучше воспроизвести сценарий на тестовой карточке и записать фактические ID, типы полей, пользователя запуска и текст ошибки.
Как это устроено
Большинство ошибок появляется из-за неверного формата данных или точки запуска.
- передавайте массив значений;
- указывайте VALUE и VALUE_TYPE;
- читайте старые значения перед добавлением нового;
- не очищайте мультиполя пустой строкой без проверки.
Рабочий подход
Начинайте со штатного API и добавляйте обходы только там, где штатный сценарий не покрывает задачу.
Для облака используйте REST и проверяйте права приложения. Для коробки, если код выполняется внутри портала, чаще удобнее PHP/D7 и штатные классы модуля.
Если действие меняет CRM-карточку, учитывайте роботов, бизнес-процессы, события и повторные вызовы обработчиков. Любая запись в карточку может стать новым триггером.
Частые ошибки
Ошибки лучше ловить на минимальном примере, а не в большом процессе.
- не проверили права пользователя или приложения;
- перепутали ID, текстовое значение и XML_ID;
- передали строку вместо массива для множественного поля;
- запустили процесс повторно и получили дубли;
- обошли штатную операцию CRM и не запустили роботов или события.
Минимальный пример
Пример показывает только базовую форму. На реальном портале замените ID, поля и права на свои.
BX24.callMethod(
'crm.contact.update',
{
id: 123,
fields: {
PHONE: [
{
VALUE: '+79990000000',
VALUE_TYPE: 'WORK',
},
],
EMAIL: [
{
VALUE: 'client@example.com',
VALUE_TYPE: 'WORK',
},
],
},
}
);