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

lists.element.get

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

Описание

lists.element.get(params)

Метод возвращает список элементов или элемент. В случае успеха возвращает данные по элементу(там), иначе пустой массив.

Параметры

ПараметрОписание
IBLOCK_TYPE_IDid типа инфоблока (обязательно):
  • lists - тип инфоблока списка
  • bitrix_processes - тип инфоблока процессов
  • lists_socnet - тип инфоблока списков групп
SOCNET_GROUP_IDid группы (обязательно, если список создается для группы);
IBLOCK_CODE/IBLOCK_IDкод или id инфоблока (обязательно)
ELEMENT_CODE/ELEMENT_IDкод или id элемента (Если не указан, вернет список всех элементов списка)
ELEMENT_ORDERСортировка. Массив полей элементов информационного блока. Направление сортировки: asc (по возрастания) или desc (по убыванию) Пример:
'ELEMENT_ORDER': { "ID": "DESC" } 

Не поддерживается сортировка всех множественных свойств, а так же свойств: S:Money, PREVIEW_TEXT, DETAIL_TEXT, S:ECrm, S:map_yandex, PREVIEW_PICTURE, DETAIL_PICTURE, S:DiskFile, IBLOCK_SECTION_ID, BIZPROC, COMMENTS.
FILTERФильтрация элементов. Объект с списком полей и значений. Для фильтрации доступны почти все поля из фильтра CIBlockElement::GetList. Например для фильтрации по полю число, нужно указать знак равно:
'FILTER': {
	'=ID': [120,121],
}
Так же есть возможность использовать полнотекстовый поиск. Для этого Нужно использовать поле SEARCHABLE_CONTENT с префиксом "*";

Пример

var params = {
	'IBLOCK_TYPE_ID': 'lists_socnet',
	'IBLOCK_CODE': 'rest_1',
	'ELEMENT_CODE': 'element_1'
};
BX24.callMethod(
	'lists.element.get',
	params,
	function(result)
	{
		if(result.error())
			alert("Error: " + result.error());
		else
			console.log(result.data());
	}
);
var params = {
	'IBLOCK_TYPE_ID': 'lists',
	'IBLOCK_ID': '41',
	'FILTER': {
		'>=DATE_CREATE': '27.03.2018 00:00:00',
		'<=DATE_CREATE': '27.03.2018 23:59:59',
	}
};


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