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

crm.status.add

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

crm.status.add(fields)

Создаёт новый элемент в указанном справочнике.

Если добавляется стадия для пользовательского направления сделок, то к идентификатору статуса будет автоматически добавлен префикс направления. Это нужно, чтобы определить направление по идентификатору стадии.

Параметры

ПараметрОписание
fieldsНабор полей - массив вида array("поле"=>"значение"[, ...]), содержащий значения полей справочника. (Обязательный)

Внимание! С версии модуля CRM 20.5.500 вводится ограничение на длину и формат значения поля STATUS_ID для некоторых ENTITY_ID:

  • STATUS (статус лида). Макс. длина: 21, может содержать только латинские буквы, цифры, знаки тире и подчеркивания.
  • QUOTE_STATUS (статус счета). Макс. длина: 22, может содержать только латинские буквы, цифры, знаки тире и подчеркивания.
  • DEAL_STAGE (статус сделки). Макс. длина: 22, может содержать только латинские буквы, цифры, знаки тире и подчеркивания.
  • DEAL_STAGE_xx (статус сделки в направлениях не по-умолчанию. xx - идентификатор направления). Макс. длина: 19 если xx меньше 10; Макс. длина: 18 если xx меньше 100 и т.д. Может содержать только латинские буквы, цифры, знаки тире и подчеркивания
  • Для остальных ENTITY_ID, максимальная длина STATUS_ID - 50 символов, содержать может любые символы.

Пример

	BX24.callMethod(
		"crm.status.add", 
		{
			fields:
			{ 
				"ENTITY_ID": "DEAL_STAGE",		
				"STATUS_ID": "DECISION",
				"NAME": "Принятие решения",
				"SORT": 70
			}
		}, 
		function(result) 
		{
			if(result.error())
				console.error(result.error());
			else
				console.info("Создан элемент справочника с ID " + result.data());
		}
	);	
BX24.callMethod(
        "crm.status.add", 
        {
           fields:
           { 
               "ENTITY_ID": "DEAL_STAGE_1",        
               "STATUS_ID": "DECISION",
               "NAME": "Принятие решения",
               "SORT": 70
           }
       }, 
       function(result) 
       {
           if(result.error())
               console.error(result.error());
           else
               console.info("Создан элемент справочника с ID " + result.data());
       }
   );

В втором примере поле STATUS_ID будет сохранено как С1:DECISION. То есть будет добавлен префикс "C1:", где 1 - идентификатор направления сделок, к которому принадлежит справочник DEAL_STAGE_1.



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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024