Битрикс ORM инструменты

Пожалуйста, будьте осторожны: это пока нестабильная версия без покрытия Unit-тестами!

Вспомогательные инструменты для работы с Битрикс D7 ORM.

Возможности

• Генерация описания полей таблицы хранения немножественных свойств элемента инфоблока.

Установка

1. Установить через composer:

   composer require webarchitect609/bitrix-orm-tools

2. Добавить подключение автозагрузчика composer в самое начало файла init.php

   require_once$_SERVER['DOCUMENT_ROOT'] . '/../../vendor/autoload.php';

Использование

Чтобы воспользоваться функциональностью генерации описания немножественных свойств элемента инфоблока:

• отнаследоваться от \WebArch\BitrixOrmTools\Iblock\Property\DynamicSinglePropertiesTable и объявить метод getIblockId();
• при объявлении Bitrix\Main\Entity\ReferenceField (или Bitrix\Main\ORM\Fields\Relations\Reference) воспользоваться созданным классом;

useBitrix\Iblock\ElementTable;
useBitrix\Main\Entity\ReferenceField;
useBitrix\Main\ORM\Query\Join;
useWebArch\BitrixOrmTools\Iblock\Property\DynamicSinglePropertiesTable;
class NewsSinglePropTable extends DynamicSinglePropertiesTable
{
publicstaticfunctiongetIblockId(): int
{
return123;
}
}
ElementTable::query()
->registerRuntimeField(
newReferenceField(
'NEWS_PROP',
NewsSinglePropTable::class,
Join::on('this.ID', 'ref.IBLOCK_ELEMENT_ID'),
['join_type' => 'INNER']
)
);

Известные особенности

Необходимость описывать конверторы для всех свойств

Если используются пользовательские свойства элемента инфоблока, может возникать ошибка

Unsupported property type `S` with user type `Vendor\Package\NutritionValueProperty`

Можно дописать необходимый конвертор и вернуть его, переопределив статический метод \WebArch\BitrixOrmTools\Iblock\Property\DynamicSinglePropertiesTable::getConverterList() и добавив к уже существующему списку конверторов.

Другой вариант - включить игнорирование таких ошибок при помощи метода \WebArch\BitrixOrmTools\Iblock\Property\DynamicSinglePropertiesTable::ignoreUnsupportedPropertyType()

Ошибка "Class \WebArch\BitrixOrmTools\Field\TimeField not found"

1. Обновить webarchitect609/bitrix-user-type >= 0.9.0
2. Предпочтительнее заменить в клиентском коде \WebArch\BitrixOrmTools\Field\TimeField на \WebArch\BitrixUserPropertyType\Field\TimeField. Временное решение: в init.php после подключения vendor/autoload.php активировать скрипт установки алиаса vendor/webarchitect609/bitrix-user-type/src/inc/aliases.php

   require_once'vendor/webarchitect609/bitrix-user-type/src/inc/aliases.php';

Лицензия и информация об авторе

BSD-3-Clause