method public static

DiscountCouponTable::getRow()

Класс: \Bitrix\Catalog\DiscountCouponTable

Сигнатура

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

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

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

Короткая запись getList() для одной строки DiscountCouponTable: тот же массив параметров, но сразу возвращается массив полей или null, если ничего не найдено.

use Bitrix\Main\Loader;
use Bitrix\Catalog\DiscountCouponTable;

Loader::includeModule('catalog');

$row = DiscountCouponTable::getRow([
    'select' => ['ID', 'DISCOUNT_ID', 'ACTIVE'],
    'filter' => ['>ID' => 0],
    'order'  => ['ID' => 'DESC'],
]);
if ($row === null) {
    // записи нет
}

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

Поле	Тип	Свойства
`ID`	`int`	обязательное
`DISCOUNT_ID`	`int`	обязательное
`ACTIVE`	`bool`	необязательное, по умолчанию 'Y'
`COUPON`	`string(32)`	обязательное
`DATE_APPLY`	`datetime`	необязательное
`TYPE`	`enum`	необязательное, по умолчанию 'O'
`TIMESTAMP_X`	`datetime`	необязательное
`MODIFIED_BY`	`int`	необязательное
`DATE_CREATE`	`datetime`	необязательное
`CREATED_BY`	`int`	необязательное
`DESCRIPTION`	`string`	необязательное
`CREATED_BY_USER`	`reference`
`MODIFIED_BY_USER`	`reference`
`DISCOUNT`	`reference`

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

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

checkCoupon() Проверить купон.
checkDiscountId() Проверить id скидки.
couponManager() Вернуть методы для менеджера купонов.
deleteByDiscount() Удалить все купоны для скидки.
getCouponTypes() Возвращает список типов купонов.
getData() Вернуть описание купона.
isExist() Проверить существующий купон.
saveApplied() Сохранить применённые купоны.
validateCoupon() Возвращает валидаторы для поля COUPON.
validateDiscountId() Возвращает валидаторы для поля DISCOUNT_ID.

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

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