Документация для разработчиков
Темная тема

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