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';
}