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