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

lists.element.add

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

Описание

lists.element.add (params, fields)

Метод создаёт элемент списка. В случае успешного создания элемента ответ true, иначе Exception.

Чтобы загрузить файлы в поле типа Файл (Диск) необходимо:

  1. использовать rest api модуля disk: disk.folder.uploadfile и disk.storage.uploadfile. В ответе при загрузке этих файлов, вы будете получать "FILE_ID": 290.
  2. Получить список ID загруженных файлов.
  3. Затем с помощью rest api модуля lists добавлять файлы в нужное поле:
    var params = {
    	'IBLOCK_TYPE_ID': 'lists',
    	'IBLOCK_ID': '41',
    	'ELEMENT_CODE': 'element1',
    	'FIELDS': {
    		'NAME': 'Test element 1',
    		'PROPERTY_121': { 'n0':["n1582"]}
    	}
    };
    BX24.callMethod(
    	'lists.element.add',
    	params,
    	function(result)
    	{
    		if(result.error())
    			alert("Error: " + result.error());
    		else
    			alert("Success: " + result.data());
    	}
    );

Параметры

Параметр Описание
IBLOCK_TYPE_IDid типа инфоблока (обязательно):
  • lists - тип инфоблока списка
  • bitrix_processes - тип инфоблока процессов
  • lists_socnet - тип инфоблока списков групп
IBLOCK_CODE/IBLOCK_IDкод или id инфоблока (обязательно)
ELEMENT_CODEкод элемента инфоблока (обязательно)
LIST_ELEMENT_URLшаблон адреса к элементам списка
FIELDSмассив полей и значений
SOCNET_GROUP_IDid группы (обязательно, если список создается для группы);

Пример

var params = {
	'IBLOCK_TYPE_ID': 'lists_socnet',
	'IBLOCK_CODE': 'rest_1',
	'ELEMENT_CODE': 'element_1',
	'LIST_ELEMENT_URL': '#list_id#/element/#section_id#/#element_id#/',
	'FIELDS': {
		'NAME': 'Test element',
		'PROPERTY_62': 'Text string',
		'PROPERTY_63': {
			'0': '7',
			'1': '9',
			'2': '10'
		}
	}
};
BX24.callMethod(
	'lists.element.add',
	params,
	function(result)
	{
		if(result.error())
			alert("Error: " + result.error());
		else
			alert("Success: " + result.data());
	}
);

Пример добавления файла:

var params = {
	'IBLOCK_TYPE_ID': 'lists',
	'IBLOCK_ID': '41',
	'ELEMENT_CODE': 'element1',
	'FIELDS': {
		'NAME': 'Test element 1',
		'PROPERTY_122': document.getElementById('fileInputId') // PROPERTY_122 - Пользовательское свойство типа "Файл"
	}
};
BX24.callMethod(
	'lists.element.add',
	params,
	function(result)
	{
		if(result.error())
			alert("Error: " + result.error());
		else
			alert("Success: " + result.data());
	}
);


© «Битрикс», 2001-2024, «1С-Битрикс», 2024