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

crm.contact.list

Scope: crm Права на выполнение: для всех

Возвращает список контактов по фильтру. Является реализацией списочного метода для контактов.

При выборке используйте маски:

  • "*" - для выборки всех полей (без пользовательских и множественных)
  • "UF_*"- для выборки всех пользовательских полей (без множественных)

Маски для выборки множественных полей нет. Для выборки множественных полей укажите нужные в списке выбора ("PHONE", "EMAIL" и так далее).

Для получения списка компаний, привязанных к контакту используйте метод crm.contact.company.items.get.

Внимание! Поля: телефон, почта, сайт, мессенджеры - множественные. По ним фильтры работают только на точное совпадение.

Параметры

Cм. описание списочных методов.

Пример

BX24.callMethod(
	"crm.contact.list",
	{
		order: { "DATE_CREATE": "ASC" },
		filter: { "TYPE_ID": "CLIENT" },
		select: [ "ID", "NAME", "LAST_NAME", "TYPE_ID", "SOURCE_ID" ]
	},
	function(result)
	{
		if(result.error())
			console.error(result.error());
		else
		{
			console.dir(result.data());
			if(result.more())
				result.next();
		}
	}
);
//Поиск контакта по телефону
BX24.callMethod(
	"crm.contact.list",
	{
		filter: { "PHONE": "555888" },
		select: [ "ID", "NAME", "LAST_NAME" ]
	},
	function(result) 
	{
		if(result.error())
			console.error(result.error());
		else
		{
			console.dir(result.data());
			if(result.more())
				result.next();
		}
	}
);


© «Битрикс», 2001-2024, «1С-Битрикс», 2024