GetElementGroups

Описание

CDBResult
CIBlockElement::GetElementGroups(
	mixed ID,
	bool bElementOnly = false,
	array arSelect = array()
);

Принимает массив идентификаторов элементов. Возвращает группы, которым принадлежит элемент, по его коду ID. Метод статический.

Смотрите также

Параметры вызова

Параметр	Описание	С версии
ID	ID элемента, либо массив ID элементов, для которых надо вернуть привязки к разделам.
bElementOnly	Не обязательный параметр. Указывает на необходимость выборки привязок и из свойств типа "Привязка к разделу". По умолчанию равен false и значения свойств будут выбраны. Если значения свойств не нужны, то значением параметра надо задать true.	5.1.0
arSelect	Перечень возвращаемых полей. Допустимые поля: Поля, относящиеся к разделу: ID - ID раздела инфоблока; TIMESTAMP_X - дата последнего изменения параметров раздела; MODIFIED_BY - идентификатор пользователя, в последний раз изменившего раздел; DATE_CREATE - дата создания раздела; CREATED_BY - идентификатор пользователя, создавшего раздел; IBLOCK_ID - ID информационного блока; IBLOCK_SECTION_ID - ID раздела-родителя; ACTIVE - (Y\|N) флаг активности раздела; GLOBAL_ACTIVE - (Y\|N) флаг активности раздела, учитывая активность вышележащих (родительских) разделов; SORT - порядок сортировки; NAME - название раздела; PICTURE - код картинки раздела; LEFT_MARGIN - левая граница раздела; RIGHT_MARGIN - правая граница раздела; DEPTH_LEVEL - уровень вложенности раздела; DESCRIPTION - описание раздела; DESCRIPTION_TYPE - тип описания группы (text/html); SEARCHABLE_CONTENT - содержимое для поиска при фильтрации групп; CODE - символьный идентификатор; XML_ID - внешний код; EXTERNAL_ID - внешний код; TMP_ID - временный строковый идентификатор, используемый для служебных целей; DETAIL_PICTURE - код картинки детального просмотра раздела; SOCNET_GROUP_ID - группа Социальной сети. Поля, относящиеся к инфоблоку раздела: LIST_PAGE_URL - шаблон URL-а к странице для публичного просмотра списка элементов информационного блока; SECTION_PAGE_URL -шаблон URL-а к странице для просмотра раздела; IBLOCK_TYPE_ID - код типа инфоблоков; IBLOCK_CODE - символьный код инфоблока; IBLOCK_EXTERNAL_ID - внешний код инфоблока. Поля, относящиеся к элементу, для которого возвращаются разделы: IBLOCK_ELEMENT_ID - код элемента; ADDITIONAL_PROPERTY_ID - код свойства (не пусто, если элемент привязан к разделу через свойство). По умолчанию возвращаются все поля.	12.5.7

Параметр

Описание

С версии

ID элемента, либо массив ID элементов, для которых надо вернуть привязки к разделам.

bElementOnly

Не обязательный параметр. Указывает на необходимость выборки привязок и из свойств типа "Привязка к разделу". По умолчанию равен false и значения свойств будут выбраны. Если значения свойств не нужны, то значением параметра надо задать true.

5.1.0

arSelect

Перечень возвращаемых полей. Допустимые поля:

Поля, относящиеся к разделу:

ID - ID раздела инфоблока;
TIMESTAMP_X - дата последнего изменения параметров раздела;
MODIFIED_BY - идентификатор пользователя, в последний раз изменившего раздел;
DATE_CREATE - дата создания раздела;
CREATED_BY - идентификатор пользователя, создавшего раздел;
IBLOCK_ID - ID информационного блока;
IBLOCK_SECTION_ID - ID раздела-родителя;
ACTIVE - (Y|N) флаг активности раздела;
GLOBAL_ACTIVE - (Y|N) флаг активности раздела, учитывая активность вышележащих (родительских) разделов;
SORT - порядок сортировки;
NAME - название раздела;
PICTURE - код картинки раздела;
LEFT_MARGIN - левая граница раздела;
RIGHT_MARGIN - правая граница раздела;
DEPTH_LEVEL - уровень вложенности раздела;
DESCRIPTION - описание раздела;
DESCRIPTION_TYPE - тип описания группы (text/html);
SEARCHABLE_CONTENT - содержимое для поиска при фильтрации групп;
CODE - символьный идентификатор;
XML_ID - внешний код;
EXTERNAL_ID - внешний код;
TMP_ID - временный строковый идентификатор, используемый для служебных целей;
DETAIL_PICTURE - код картинки детального просмотра раздела;
SOCNET_GROUP_ID - группа Социальной сети.

Поля, относящиеся к инфоблоку раздела:

LIST_PAGE_URL - шаблон URL-а к странице для публичного просмотра списка элементов информационного блока;
SECTION_PAGE_URL -шаблон URL-а к странице для просмотра раздела;
IBLOCK_TYPE_ID - код типа инфоблоков;
IBLOCK_CODE - символьный код инфоблока;
IBLOCK_EXTERNAL_ID - внешний код инфоблока.

Поля, относящиеся к элементу, для которого возвращаются разделы:

IBLOCK_ELEMENT_ID - код элемента;
ADDITIONAL_PROPERTY_ID - код свойства (не пусто, если элемент привязан к разделу через свойство).

По умолчанию возвращаются все поля.

12.5.7

Возвращаемое значение

Возвращается объект CDBResult со всеми полями для формирования url. С версии 10.0.9 в результат запроса добавлено поле IBLOCK_ELEMENT_ID.

Примеры использования

<?
$db_old_groups = CIBlockElement::GetElementGroups($ELEMENT_ID, true);
$ar_new_groups = Array($NEW_GROUP_ID);
while($ar_group = $db_old_groups->Fetch())
	$ar_new_groups[] = $ar_group["ID"];
CIBlockElement::SetElementSection($ELEMENT_ID, $ar_new_groups);
?>

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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.

Армен Айрапетян 15.12.2022 14:54:55

Цитата
пишет: Если я передаю массив ID в функцию, время исполнения запроса и их количество (если верить отладке битрикс) одно и то же, как если бы я вызывал данную функцию в цикле с одним ID.

Добирать значения в цикле не рекомендуется. Лучше передавать массив с id элементов

Наверх