DiscountTable::getRow()
Сигнатура
public static getRow(array<string|int, mixed> $parameters) : array<string|int, mixed>|null
Описание
Возвращает одну строку (или null) по параметрам для getList()
Параметры
$parameters
array<string|int, mixed>
Возвращаемое значение
array<string|int, mixed>|null
Как применяется в DiscountTable
DiscountTable::getRow() — метод класса \Bitrix\Catalog\DiscountTable модуля «Торговый каталог». Это ORM-сущность D7 (наследник DataManager): строки читаются как объекты EO_Discount, наборы — как EO_Discount_Collection. Метод достаётся DiscountTable от DataManager::getRow: поведение общее для всех сущностей, а данные, поля и классы — свои.
Короткая запись getList() для одной строки DiscountTable: тот же массив параметров, но сразу возвращается массив полей или null, если ничего не найдено.
use Bitrix\Main\Loader;
use Bitrix\Catalog\DiscountTable;
Loader::includeModule('catalog');
$row = DiscountTable::getRow([
'select' => ['ID', 'XML_ID', 'SITE_ID'],
'filter' => ['>ID' => 0],
'order' => ['ID' => 'DESC'],
]);
if ($row === null) {
// записи нет
}Поля сущности 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.
getRow() есть и у других классов модуля «Торговый каталог»: CatalogIblockTable, CatalogViewedProductTable, DiscountCouponTable, DiscountModuleTable, DiscountRestrictionTable, ExtraTable, GroupAccessTable, GroupLangTable.
Исходный файл: source/catalog/lib/discount.php:398

