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

GetPropertyValues

Описание и параметры

 CIBlockElement::GetPropertyValues(
 $IBLOCK_ID, 
 $arElementFilter, 
 $extMode = false, 
 $propertyFilter = array()
);

Метод позволяет получить значения свойств для элементов одного информационного блока, отобранных по фильтру

Параметры функции

Параметр Описание
IBLOCK_ID ID инфоблока (ЕДИНИЧНОЕ значение).
arElementFilter Фильтр CIBlockElement::GetList для отбора элементов. Ключ IBLOCK_ID указывать нет необходимости - он будет добавлен внутри метода.
extMode Признак возврата расширенного числа полей. Необязательный.
propertyFilter Фильтр возвращаемых свойств. необязательный. Может иметь только 1 ключ - ID. Это массив ID возвращаемых свойств. Если пуст - будут возвращены значения всех свойств инфоблока, включая неактивные.

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

Возвращаемое значение - объект типа CIBlockPropertyResult.

Если $extMode = false, то возвратятся следующие ключи для каждого значения свойства:

IBLOCK_ELEMENT_ID - ID элемента,
IBLOCK_PROPERTY_ID - ID свойства,
VALUE - строковое значение свойства,
VALUE_NUM - цифровое значение свойства (имеет смысл для свойств типа число, список, привязка к элементам, разделам, файловым и производным от них).

Если $extMode = true, то дополнительно вернутся ключи:

PROPERTY_VALUE_ID - ID записи значения свойства в базе,
DESCRIPTION - описание значения свойства (если есть).

Результат отсортирован по полю IBLOCK_ELEMENT_ID

Примеры использования

Получить все значения свойств с кодами 10 и 14 активных элементов инфоблока 5

$iterator = CIBlockElement::GetPropertyValues(5, array('ACTIVE' => 'Y'), true, array('ID' => array(10, 14)));
while ($row = $iterator->Fetch())
{
  print_r($row);
}


© «Битрикс», 2001-2020, «1С-Битрикс», 2020
Наверх