crm.contact.update
Scope: crm Права на выполнение: для всех
crm.contact.update(id, fields, params)
Обновляет существующий контакт.
Важно! Настоятельно рекомендуется при обновлении адреса передавать полный набор полей адреса в метод обновления. Особенности обновления полей адреса описаны здесь.
Параметры
Параметр | Описание |
---|---|
id | Идентификатор контакта. |
fields | Набор полей - массив вида array("обновляемое поле"=>"значение"[, ...]), где "обновляемое поле" может принимать значения из возвращаемых методом crm.contact.fields.
Примечание: чтобы узнать требуемый формат полей, выполните метод crm.contact.fields и посмотрите формат пришедших значений этих полей.
|
params | Набор параметров. REGISTER_SONET_EVENT - произвести регистрацию события изменения контакта в живой ленте. Дополнительно будет отправлено уведомление ответственному за контакт. |
Пример
var id = prompt("Введите ID"); BX24.callMethod( "crm.contact.update", { id: id, fields: { "TYPE_ID": "JOURNALIST", "SOURCE_ID": "CONFERENCE" }, params: { "REGISTER_SONET_EVENT": "Y" } }, function(result) { if(result.error()) console.error(result.error()); else { console.info(result.data()); } } );
Чтобы удалить одно из значений множественного поля, например поля EMAIL, нужно передать ID этого значения и обнулить VALUE.
BX24.callMethod( "crm.contact.update", { id: 46467, fields: { "EMAIL": [{ "ID": 83153, "VALUE": "" }] } }, function(result) { if (result.error()) console.error(result.error()); else { console.info(result.data()); } } );
© «Битрикс», 2001-2024, «1С-Битрикс», 2024