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

lists.add

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

Описание

lists.add (params)

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

Параметры

ПараметрОписание
IBLOCK_TYPE_ID id типа инфоблока (обязательное):
  • lists - тип инфоблока списка
  • bitrix_processes - тип инфоблока процессов
  • lists_socnet - тип инфоблока списков групп
IBLOCK_CODE код инфоблока (обязательное);
SOCNET_GROUP_IDid группы (обязательно, если список создается для группы);
FIELDSполя инфоблока:
  • NAME - название инфоблока (обязательно);
  • DESCRIPTION - описание;
  • SORT - сортировка;
  • PICTURE - изображение;
  • BIZPROC - включение поддержки бизнес-процессов.
MESSAGESподписи к элементам и разделам списка;
RIGHTSуправление правами доступа (если не заполнены, то авторизованному пользователю, который работает с rest устанавливается полный доступ на созданный инфоблок).

Пример

var params = {
	'IBLOCK_TYPE_ID': 'lists_socnet',
	'IBLOCK_CODE': 'rest_1',
	'SOCNET_GROUP_ID': '4',
	'FIELDS': {
		'NAME': 'List 1',
		'DESCRIPTION': 'Test list',
		'SORT': '10',
		'PICTURE': document.getElementById('iblock-image-add'),
		'BIZPROC': 'Y'
	},
	'MESSAGES': {
		'ELEMENT_NAME': 'Element',
		'ELEMENTS_NAME': 'Elements',
		'ELEMENT_ADD': 'Add element',
		'ELEMENT_EDIT': 'Edit element',
		'ELEMENT_DELETE': 'Delete element',
		'SECTION_NAME': 'Section',
		'SECTIONS_NAME': 'Sections',
		'SECTION_ADD': 'Add section',
		'SECTION_EDIT': 'Edit section',
		'SECTION_DELETE': 'Delete section'
	},
	'RIGHTS': {
		'SG4_A': 'W',
		'SG4_E': 'W',
		'SG4_K': 'W',
		'AU': 'D',
		'G2': 'D'
	}
};
BX24.callMethod(
	'lists.add',
	params,
	function(result)
	{
		if(result.error())
			alert("Error: " + result.error());
		else
			alert("Success: " + result.data());
	}
);


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