GetElementGroups — разделы элемента в Битрикс

GetElementGroups возвращает СЃРїРёСЃРѕРє всех разделов, Рє которым привязан элемент инфоблока, включая случаи множественной РїСЂРёРІСЏР·РєРё — РєРѕРіРґР° РѕРґРёРЅ товар относится сразу Рє нескольким категориям. Разберём метод Рё типичный сценарий его использования.

Базовый вызов

<?php

$sections = CIBlockElement::GetElementGroups($elementId, true);

foreach ($sections as $section) {
    echo $section['ID'] . ' — ' . $section['NAME'] . PHP_EOL;
}

Второй параметр, true, указывает получать только активные разделы. РџСЂРё false РІ результат попадут Рё деактивированные — это редко нужно РЅР° публичной части, РЅРѕ может пригодиться РїСЂРё административных задачах РІСЂРѕРґРµ аудита структуры.

Основной раздел среди нескольких

Если элемент привязан Рє нескольким разделам, РѕРґРёРЅ РёР· РЅРёС… считается основным — именно РѕРЅ обычно используется для построения хлебных крошек Рё канонического адреса страницы. Определить его можно РїРѕ полю IBLOCK_SECTION_ID самого элемента:

<?php

$element = CIBlockElement::GetByID($elementId)->GetNext();
$mainSectionId = $element['IBLOCK_SECTION_ID'];

$allSections = CIBlockElement::GetElementGroups($elementId, true);

Разница между IBLOCK_SECTION_ID Рё полным СЃРїРёСЃРєРѕРј РёР· GetElementGroups — источник частой путаницы: первое поле хранит РѕРґРёРЅ РѕСЃРЅРѕРІРЅРѕР№ раздел, второе — РІСЃРµ разделы, включая дополнительные РїСЂРёРІСЏР·РєРё.

Практическое применение: перекрёстные категории

Типичный сценарий — товар относится и к основной категории, и к разделу «Акции» или «Новинки». Вывод в этих разделах формируется через дополнительную привязку, а не дублированием элемента:

<?php

$sections = CIBlockElement::GetElementGroups($elementId, true);

$isInPromo = false;

foreach ($sections as $section) {
    if ($section['CODE'] === 'akcii') {
        $isInPromo = true;
        break;
    }
}

Ограничение: работает только при включённой множественной привязке

Множественная РїСЂРёРІСЏР·РєР° элементов Рє разделам должна быть СЏРІРЅРѕ включена РІ настройках инфоблока. Без этого Сѓ элемента всегда есть только РѕРґРёРЅ раздел — РѕСЃРЅРѕРІРЅРѕР№, Рё метод GetElementGroups вернёт массив РёР· единственного значения, совпадающего СЃ IBLOCK_SECTION_ID.

Производительность

Вызов метода для каждого элемента РІ СЃРїРёСЃРєРµ — отдельный запрос Рє базе. РќР° странице СЃРѕ СЃРїРёСЃРєРѕРј РёР· десятков товаров это быстро превращается РІ проблему N+1 запросов. Если разделы нужны сразу для всей выборки, эффективнее получить РёС… РѕРґРЅРёРј запросом через CIBlockElement::GetList СЃ указанием IBLOCK_SECTION_ID РІ выборке полей, либо через СЃРІСЏР·СЊ ORM, если РєРѕРґ написан РЅР° D7.

Фильтрация выборки по одному из перекрёстных разделов

Отдельная РѕС‚ GetElementGroups задача — РЅРµ получить разделы конкретного элемента, Р° наоборот, отобрать РІСЃРµ элементы, привязанные Рє определённому разделу через множественную РїСЂРёРІСЏР·РєСѓ, включая те, для РєРѕРіРѕ этот раздел РЅРµ РѕСЃРЅРѕРІРЅРѕР№. Для такой выборки используется фильтр GetList РїРѕ служебному полю SECTION_ID вместо IBLOCK_SECTION_ID:

<?php

$result = CIBlockElement::GetList(
    [],
    [
        'IBLOCK_ID' => $iblockId,
        'SECTION_ID' => $promoSectionId,
        'INCLUDE_SUBSECTIONS' => 'Y',
    ],
    false, false, ['ID', 'NAME']
);

SECTION_ID РІ фильтре учитывает РІСЃРµ РїСЂРёРІСЏР·РєРё элемента, включая дополнительные, тогда как обычный фильтр РїРѕ IBLOCK_SECTION_ID отбирает только РїРѕ РѕСЃРЅРѕРІРЅРѕРјСѓ разделу — разница между этими РґРІСѓРјСЏ полями РІ фильтре повторяет ту же логику, что Рё разница между самим значением поля элемента Рё результатом GetElementGroups.

Хранение привязки в базе данных

Технически множественная РїСЂРёРІСЏР·РєР° элемента Рє разделам хранится РІ отдельной служебной таблице b_iblock_section_element — именно её Рё опрашивает GetElementGroups РїРѕРґ капотом. РћСЃРЅРѕРІРЅРѕР№ раздел, хранящийся РІ поле IBLOCK_SECTION_ID самого элемента, для консистентности данных также должен иметь соответствующую запись РІ этой таблице — расхождение между РЅРёРјРё обычно РіРѕРІРѕСЂРёС‚ Рѕ повреждении данных, возникшем РїСЂРё РїСЂСЏРјРѕРј изменении структуры РІ РѕР±С…РѕРґ API.

Частые ошибки

• Вызов метода РІ цикле РїРѕ элементам СЃРїРёСЃРєР°. Создаёт лишний запрос РЅР° каждый элемент вместо РѕРґРЅРѕР№ общей выборки.
• Путаница между основным разделом Рё полным СЃРїРёСЃРєРѕРј. IBLOCK_SECTION_ID — РѕРґРЅРѕ значение, GetElementGroups — массив всех РїСЂРёРІСЏР·РѕРє.
• Ожидание нескольких разделов РїСЂРё выключенной множественной РїСЂРёРІСЏР·РєРµ. Настройка должна быть включена РІ свойствах инфоблока заранее.

Итог

GetElementGroups возвращает полный СЃРїРёСЃРѕРє разделов элемента РїСЂРё включённой множественной РїСЂРёРІСЏР·РєРµ — полезно для перекрёстных категорий РІСЂРѕРґРµ акций Рё РЅРѕРІРёРЅРѕРє. Для отдельного элемента РЅР° детальной странице метод удобен, РЅРѕ для СЃРїРёСЃРєРѕРІ стоит избегать вызова РІ цикле Рё получать данные Рѕ разделах РѕРґРЅРёРј общим запросом.