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);
?>