method public static

DiscountTable::getByPrimary()

Сигнатура

public static getByPrimary(mixed $primary[, array<string|int, mixed> $parameters = = '[]' ]) : EO_Discount_Result

Описание

Возвращает выборку по первичному ключу сущности и необязательным параметрам для getList()

Параметры

$primary mixed

Первичный ключ сущности

$parameters array<string|int, mixed> = = '[]'

Дополнительные параметры для getList()

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

EO_Discount_Result

Как применяется в DiscountTable

DiscountTable::getByPrimary() — метод класса \Bitrix\Catalog\DiscountTable модуля «Торговый каталог». Это ORM-сущность D7 (наследник DataManager): строки читаются как объекты EO_Discount, наборы — как EO_Discount_Collection. Метод достаётся DiscountTable от DataManager::getByPrimary: поведение общее для всех сущностей, а данные, поля и классы — свои.

То же, что getById(), но с параметрами getList() вторым аргументом. Для составного ключа DiscountTable передаётся массивом.

use Bitrix\Main\Loader;
use Bitrix\Catalog\DiscountTable;

Loader::includeModule('catalog');

$row = DiscountTable::getByPrimary(1, [
    'select' => ['ID', 'XML_ID', 'SITE_ID'],
])->fetch();

Поля сущности DiscountTable

Поле	Тип	Свойства
`ID`	`int`	обязательное
`XML_ID`	`string(255)`	необязательное
`SITE_ID`	`string(2)`	обязательное
`TYPE`	`int`	обязательное
`ACTIVE`	`bool`	необязательное, по умолчанию 'Y'
`ACTIVE_FROM`	`datetime`	необязательное
`ACTIVE_TO`	`datetime`	необязательное
`RENEWAL`	`bool`	необязательное, по умолчанию 'N'
`NAME`	`string(255)`	необязательное
`SORT`	`int`	необязательное, по умолчанию 100
`MAX_DISCOUNT`	`double`	необязательное
`VALUE_TYPE`	`string(1)`	обязательное, по умолчанию 'P'
`VALUE`	`double`	обязательное, по умолчанию 0.0000
`CURRENCY`	`string(3)`	обязательное
`TIMESTAMP_X`	`datetime`	обязательное, по умолчанию 'CURRENT_TIMESTAMP'
`COUNT_PERIOD`	`string(1)`	обязательное, по умолчанию 'U'
`COUNT_SIZE`	`int`	обязательное
`COUNT_TYPE`	`bool`	необязательное, по умолчанию 'Y'
`COUNT_FROM`	`datetime`	необязательное
`COUNT_TO`	`datetime`	необязательное
`ACTION_SIZE`	`int`	обязательное
`ACTION_TYPE`	`bool`	необязательное, по умолчанию 'Y'
`MODIFIED_BY`	`int`	необязательное
`DATE_CREATE`	`datetime`	необязательное
`CREATED_BY`	`int`	необязательное
`PRIORITY`	`int`	необязательное, по умолчанию 1
`LAST_DISCOUNT`	`bool`	необязательное, по умолчанию 'Y'
`VERSION`	`int`	необязательное, по умолчанию 1
`NOTES`	`string(255)`	необязательное
`CONDITIONS`	`string`	необязательное
`UNPACK`	`string`	необязательное
`USE_COUPONS`	`bool`	необязательное, по умолчанию 'N'
`CREATED_BY_USER`	`reference`
`MODIFIED_BY_USER`	`reference`
`RESTRICTION`	`reference`

Список — из описания класса в исходном коде; точный состав в вашей версии вернёт DiscountTable::getEntity()->getFields().

Собственные методы DiscountTable

checkType() Проверить поле TYPE.
convertCurrency() Преобразовать данные скидки в другую валюту (валюту магазина).
setUseCoupons() Установить флаг наличия купонов для списка скидок.
validateCurrency() Возвращает валидаторы для поля CURRENCY.
validateName() Возвращает валидаторы для поля NAME.
validateNotes() Возвращает валидаторы для поля NOTES.
validateSiteId() Возвращает валидаторы для поля SITE_ID.
validateType() Возвращает валидаторы для поля TYPE.
validateXmlId() Возвращает валидаторы для поля XML_ID.

getByPrimary() есть и у других классов модуля «Торговый каталог»: CatalogIblockTable, CatalogViewedProductTable, DiscountCouponTable, DiscountModuleTable, DiscountRestrictionTable, ExtraTable, GroupAccessTable, GroupLangTable.

Исходный файл: source/catalog/lib/discount.php