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

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

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

Возвращается объект 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);
?>


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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2019, «1С-Битрикс», 2019
Наверх