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

GetElementID

int public static CIBlockFindTools::GetElementID(
	mixed $element_id,
	string $element_code,
	mixed $section_id,
	string $section_code,
	array $arFilter
);

Метод возвращает ID элемента информационного блока. Если в $element_id передано положительное число, метод возвращает его. Если ID не передан, метод ищет элемент по символьному коду $element_code с учетом раздела и фильтра $arFilter. Метод статический.

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

Параметр Описание
$element_id ID элемента. Если значение больше нуля, поиск по коду не выполняется.
$element_code Символьный код элемента. Используется, если $element_id не задан.
$section_id ID раздела, в котором нужно искать элемент. Если значение больше нуля, оно добавляется в фильтр поиска.
$section_code Символьный код раздела. Используется для определения раздела, если $section_id не задан.
$arFilter Фильтр для выборки элемента. Обычно содержит IBLOCK_ID, ACTIVE, ACTIVE_DATE, CHECK_PERMISSIONS и другие условия, которые поддерживает CIBlockElement::GetList.

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

Метод возвращает ID найденного элемента. Если элемент не найден или не переданы данные для поиска, возвращается 0.

Примеры

Получение ID активного элемента по символьному коду внутри раздела:

use Bitrix\Main\Loader;

Loader::includeModule('iblock');

$iblockId = 2;
$elementCode = 'item-code';
$sectionCode = 'catalog-section';

$elementId = CIBlockFindTools::GetElementID(
    0,
    $elementCode,
    0,
    $sectionCode,
    array(
        'IBLOCK_ID' => $iblockId,
        'ACTIVE' => 'Y',
        'ACTIVE_DATE' => 'Y',
        'CHECK_PERMISSIONS' => 'Y',
    )
);

if ($elementId > 0)
{
    echo 'ID element: ' . $elementId;
}
else
{
    echo 'Element not found';
}


Была ли эта страница полезна?

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

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

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