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

crm.item.add

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

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

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

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

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

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

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

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

Параметры

Параметр Описание
entityTypeIdИдентификатор смарт-процесса.
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]
                ],
    ]
));


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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
2
Александр Князев
Сообщение не промодерировано, возможны ошибки и неточности.
Извините, а где, собственно говоря, этот метод в настройках входящего хука?
2
Иван Муравиков
Сообщение не промодерировано, возможны ошибки и неточности.
(2023-03-24) Если поле типа "да/нет" для значения "да" нужно передавать строку "Y" в остальных случаях присваивает полю значение "нет" при запросе значений элемента  (crm.item.get) в поле хранятся значения либо 0 либо 1
© «Битрикс», 2001-2023, «1С-Битрикс», 2023
Наверх