method public static

VatTable::getByPrimary()

Сигнатура

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

Описание

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

Параметры

$primary mixed

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

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

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

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

EO_Vat_Result

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

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

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

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

Loader::includeModule('catalog');

$row = VatTable::getByPrimary(1, [
    'select' => ['ID', 'TIMESTAMP_X', 'ACTIVE'],
])->fetch();

Поля сущности 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, если существует системный НДС.

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

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