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.