Как выбрать свойства элемента в ElementTable::getList в D7 ORM Битрикс?

Вы убрали CIBlockElement::GetList и вызываете ElementTable::getList, в select добавили PROPERTY_ARTNUMBER - а в fetch() снова только ID и NAME. Свойства не пропали из базы: их нет в getMap() у "голого" ElementTable. Ниже - как за один elementtable getlist выбрать свойства в CMS 1С-Битрикс через Element{ApiCode}Table или runtime Reference, проверить SQL и не получить Unknown field PROPERTY.

ElementTable::getList в D7 ORM читает только колонки b_iblock_element из getMap(); пользовательские свойства - отдельные VALUE/DESCRIPTION, не поля PROPERTY_* в select. Сегодня проверьте API_CODE инфоблока и CODE свойств. С API_CODE берите Element{ApiCode}Table и select BRAND_VALUE => BRAND.VALUE. Без API_CODE - runtime join к ElementPropertyTable с фильтром Property.CODE. После запроса сверьте getLastQuery: один JOIN, ключи fetch() = алиасы select.

Материал про "1С-Битрикс: Управление сайтом", не Bitrix24. D7 ORM - слой, который собирает SQL из getList: select, filter, runtime. ElementTable знает "шапку" элемента; свойства лежат в других таблицах, поэтому префикс PROPERTY_ из старого GetList сам не заработает.

Что такое выборка свойств через ElementTable::getList

Поле - NAME, CODE, PREVIEW_TEXT в b_iblock_element, уже в getMap(). Property - значение с символьным CODE (ARTNUMBER, BRAND) в таблице свойств. ORM подключает property через Element{ApiCode}Table (с iblock 19.0.0+) или runtime Reference.

Нужно: список каталога с 2-5 свойствами без N+1 GetProperty. Не здесь: один элемент - GetByID/GetPropertyValues; запись - SetPropertyValues; сравнение GetList vs D7 - B60.

Делайте: сначала API_CODE. Не делайте: PROPERTY_* в select ElementTable без entity/runtime.

Проверьте инфоблок: 2.0, API_CODE и CODE

1. Свойства в отдельной таблице (инфоблок 2.0) в настройках ИБ.
2. Заполнен API_CODE инфоблока - иначе нет Element{ApiCode}Table.
3. У свойств символьный CODE; не совпадает с полем элемента NAME/CODE.
4. В getMap() ElementTable нет PROPERTY_*.
5. Решите ветку: compiled entity или runtime (см. таблицу ниже).

Выберите: Element{ApiCode}Table или Runtime

На практике ветку с API_CODE выбирают почти всегда: меньше runtime и проще filter по BRAND.VALUE. Join::on - в гайде B79. Не делайте: prop_s вручную при наличии API_CODE.

Настройте Element{ApiCode}Table::getList

use Bitrix\Main\Loader;
use Bitrix\Iblock\Elements\ElementCatalogTable;

Loader::includeModule('iblock');

$result = ElementCatalogTable::getList([
    'select' => [
        'ID', 'NAME',
        'BRAND_VALUE' => 'BRAND.VALUE',
        'NEWPRODUCT_NAME' => 'NEWPRODUCT.ITEM.VALUE',
    ],
    'filter' => ['=ACTIVE' => 'Y', '=BRAND.VALUE' => 'Acme'],
    'limit' => 50,
]);
while ($row = $result->fetch()) { /* BRAND_VALUE */ }

Нет PROPERTY_: связи по CODE свойства. Список - .ITEM.VALUE, файл - .FILE. Делайте: короткие алиасы в select. Не делайте: fetchAll() + несколько M:N свойств с limit - связи обрежутся.

Соберите runtime join к ElementPropertyTable

use Bitrix\Main\ORM\Query\Join;
use Bitrix\Main\ORM\Fields\Relations\Reference;
use Bitrix\Iblock\{ElementTable, ElementPropertyTable, PropertyTable};

$result = ElementTable::getList([
    'select' => ['ID', 'NAME', 'PROP_VALUE' => 'ELEMENT_PROPERTY.VALUE'],
    'filter' => [
        '=IBLOCK_ID' => 5, '=PROPERTY.CODE' => 'ARTNUMBER',
    ],
    'runtime' => [
        new Reference('ELEMENT_PROPERTY', ElementPropertyTable::class,
            Join::on('this.ID', 'ref.IBLOCK_ELEMENT_ID')),
        new Reference('PROPERTY', PropertyTable::class,
            Join::on('ref.IBLOCK_PROPERTY_ID', 'this.ID')),
    ],
]);

Фильтр по Property.CODE переносим между средами. Результат: один SQL на 50 элементов вместо 50+ GetProperty.

Разберите списочные и множественные свойства

Список: join PropertyEnumerationTable или NEWPRODUCT.ITEM в compiled entity. Множественное: только fetchObject() и коллекция по CODE - иначе одно VALUE или лишние строки. Enum подробнее - CIBlockPropertyEnum.

Делайте: LEFT-поведение, если элемент без свойства должен остаться в выборке. Не делайте: считать строки fetchAll() за число элементов при join к M:N.

Отладьте getLastQuery и типичные ошибки

В реальном проекте типичная ошибка - смотреть только fetch() и не открыть getLastQuery(): join к свойству есть, а алиас в select другой. Снимите SQL через getLastQuery() или getTracker(). Компромисс - GetPropertyValuesArray по ID; полная миграция - B60.

Проверьте чеклист перед продом

1. В fetch()/fetchObject() все CODE под ожидаемыми ключами.
2. Фильтр по свойству работает на пустом и заполненном значении.
3. На 20+ элементах один основной SQL, без N+1.
4. Множественное property отдает все значения.

Вопросы по миграции каталога - контакты, кейсы - портфолио.

Проверено: Максим Молков (профиль). Источники: ElementTable, архитектура ORM инфоблоков, урок 12866 курса 43. Актуальность: iblock 19.0.0+, API_CODE.

Частые вопросы