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

crm.entity.mergeBatch

Объединение дубликатов


crm.entity.mergeBatch({params: {entityTypeId: number, entityIds: number[]}})

params - ассоциативный массив, содержащий ключи:
Ключ Описание
entityTypeId идентификатор типа сущности. Может принимать значения 1 (лид), 2 (сделка), 3 (контакт) или 4 (компания)
entityIdsмассив идентификаторов элементов, которые необходимо объединить

Метод вернет ассоциативный массив вида:

	
{
  "STATUS": "SUCCESS",
  "ENTITY_IDS": [
    "1" 
  ]
}

Здесь:

Параметр Описание
STATUS может принимать значения:
  • SUCCESS - объединение прошло успешно.
  • CONFLICT - при объединении возник конфликт.
  • ERROR - при объединении произошла ошибка. Например, если у текущего пользователя нет прав на изменение или удаление записей.
ENTITY_IDSсодержит идентификаторы элементов, которые были объединены, кроме идентификатора элемента, оставшегося после объединения.

Пример вызова:

	
BX24.callMethod(
	'crm.entity.mergeBatch',
	{ 
		params: {
			entityTypeId: 3,
			entityIds: [1, 2, 3],
		}
	},
	(result) => {
		console.log(result);
	}
);


Ручное объединение для случаев, когда возник конфликт


Для продолжения объединения вручную, в привычном пользователю интерфейсе Битиркс24, достаточно перенаправить его в раздел ручного объединения по соответствующей ссылке:


  • Контакты: /crm/contact/merge/?id=1,2,3
  • Компании: /crm/company/merge/?id=1,2,3
  • Лиды: /crm/lead/merge/?id=1,2,3
  • Сделки: /crm/deal/merge/?id=1,2,3

где параметр id содержит указанные через запятую идентификаторы объединяемых записей.





Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
Александр Марченко
Сообщение не промодерировано, возможны ошибки и неточности.
Поддерживаю. Не хватает списка конфликтующих полей, приходится танцы с бубном устраивать, чтобы точно их найти.
0
Дмитрий М
Сообщение не промодерировано, возможны ошибки и неточности.
Очень не хватает в ответе списка конфликтующих полей если $result == CONFLICT
© «Битрикс», 2001-2022, «1С-Битрикс», 2022
Наверх