method public static

VatTable::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

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

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

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

use Bitrix\Main\Loader;
use Bitrix\Catalog\VatTable;

Loader::includeModule('catalog');

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

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

Поле	Тип	Свойства
`ID`	`int`	обязательное
`TIMESTAMP_X`	`datetime`	обязательное, по умолчанию 'CURRENT_TIMESTAMP'
`ACTIVE`	`bool`	необязательное, по умолчанию 'Y'
`SORT`	`int`	необязательное, по умолчанию 100
`NAME`	`string(50)`	обязательное
`RATE`	`double`	обязательное, по умолчанию 0.00

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

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

getActiveVatIdByRate() Возвращает ID активной ставки НДС для указанного значения. При необходимости создаёт новую ставку НДС.
getExcludeVatId() Возвращает id исключаемого НДС, если существует.
isExistsExcludeVat() Возвращает true, если существует системный НДС.

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

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