method public static

UserTransactTable::getByPrimary()

Класс: \Bitrix\Sale\Internals\UserTransactTable

Сигнатура

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

Описание

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

Параметры

$primary mixed

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

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

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

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

EO_UserTransact_Result

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

UserTransactTable::getByPrimary() — метод класса \Bitrix\Sale\Internals\UserTransactTable модуля «Интернет-магазин». Это ORM-сущность D7 (наследник DataManager): строки читаются как объекты EO_UserTransact, наборы — как EO_UserTransact_Collection. Метод достаётся UserTransactTable от DataManager::getByPrimary: поведение общее для всех сущностей, а данные, поля и классы — свои.

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

use Bitrix\Main\Loader;
use Bitrix\Sale\Internals\UserTransactTable;

Loader::includeModule('sale');

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

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

Поле	Тип	Свойства
`ID`	`int`	обязательное
`USER_ID`	`int`	обязательное
`TIMESTAMP_X`	`datetime`	необязательное, по умолчанию current
`TRANSACT_DATE`	`datetime`	обязательное
`AMOUNT`	`double`	необязательное, по умолчанию 0.0000
`CURRENCY`	`string(3)`	обязательное
`DEBIT`	`bool`	необязательное, по умолчанию 'N'
`ORDER_ID`	`int`	необязательное
`DESCRIPTION`	`string(255)`	обязательное
`NOTES`	`text`	необязательное
`PAYMENT_ID`	`int`	необязательное
`EMPLOYEE_ID`	`int`	необязательное

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

Другие методы UserTransactTable

add() Добавляет строку в таблицу сущности
addMulti() Добавляет несколько строк в таблицу сущности.
checkFields() Проверяет поля данных перед сохранением в БД. Результат хранится в объекте $result
cleanCache() Очищает кеш таблета после модификаций данных.
createCollection()
createObject()
cryptoEnabled() Возвращает true, если для поля включено шифрование.
delete() Удаляет строку в таблице сущности по первичному ключу
enableCrypto() Устанавливает флаг, указывающий на поддержку шифрования для поля.
getById() Возвращает выборку по первичному ключу сущности
getCollectionClass() Возвращает класс коллекции объектов для текущей сущности.
getCollectionClassName() Возвращает имя класса (без пространства имён) коллекции объектов для текущей сущности.

getByPrimary() есть и у других классов модуля «Интернет-магазин»: BasketArchivePackedTable, BasketArchiveTable, BasketPropertyTable, BasketTable, BusinessValueCode1CTable, BusinessValuePersonDomainTable, BusinessValueTable, BuyerStatisticTable.

Исходный файл: source/sale/lib/internals/usertransacttable.php