crm.item.add

Описание и параметры

crm.item.add({entityTypeId: number, fields: ?{})

Метод создает новый элемент смарт-процесса с идентификатором entityTypeId.

При создании элемента производится стандартный ряд проверок, модификаций и автоматических действий:

• проверяются права доступа;
• проверяется заполненность обязательных полей;
• проверяется заполненность зависимых от стадий обязательных полей;
• проверяется корректность заполнения полей;
• полям присваиваются значения по умолчанию;
• после сохранения запускаются роботы.

Метод вернет результат аналогичный вызову метода crm.item.get на только что созданном элементе.

Чтобы загрузить файл, в качестве значения пользовательского поля необходимо передать массив, где первый элемент - это имя файла, а второй - это закодированный в base64 контент файла.

Примеры fields для разных запросов можно посмотреть здесь.

Параметры

Примеры

Пример добавления элемента смарт-процесса с загрузкой файла

$Smart_Type_ID = 577;

$file_name_1 = 'test_file_img.jpg';
$file_name_2 = 'test_file_img_2.jpg';
$path_1 = 'folder/test_file_img.jpg';
$path_2 = 'folder/test_file_img_2.jpg';

// Кодировать файлы в base64
$base64image_1 = base64_encode(file_get_contents($path_1));
$base64image_2 = base64_encode(file_get_contents($path_2));

// Формируем запрос
$param['act'] = "crm.item.add?" . http_build_query(array(
	"entityTypeId" => $Smart_Type_ID,
	"fields" => [
		'title' => 'Тест',
		'company_id' => 57,
		'contact_ids' => [ 5, 7 ],
		'assigned_by_id' => 1,
		'ufCrm5_1641472560814' => 57, // тип - список, 57 - ID одного из вариантов списка
		'ufCrm5_1641472485686' => 'строка',
		'ufCrm5_1641472326332' => 777,
		'ufCrm5_1643035938' => 5, // тип - привязка к CRM
		// тип - файл, множественное
		'ufCrm5_1641473846006' => [
			'0' => [ $file_name_1, $base64image_1],
			'1' => [ $file_name_2, $base64image_2]
		],
	]
));