UserTransactTable::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
Как применяется в UserTransactTable
UserTransactTable::getRow() — метод класса \Bitrix\Sale\Internals\UserTransactTable модуля «Интернет-магазин». Это ORM-сущность D7 (наследник DataManager): строки читаются как объекты EO_UserTransact, наборы — как EO_UserTransact_Collection. Метод достаётся UserTransactTable от DataManager::getRow: поведение общее для всех сущностей, а данные, поля и классы — свои.
Короткая запись getList() для одной строки UserTransactTable: тот же массив параметров, но сразу возвращается массив полей или null, если ничего не найдено.
use Bitrix\Main\Loader;
use Bitrix\Sale\Internals\UserTransactTable;
Loader::includeModule('sale');
$row = UserTransactTable::getRow([
'select' => ['ID', 'USER_ID', 'TIMESTAMP_X'],
'filter' => ['>ID' => 0],
'order' => ['ID' => 'DESC'],
]);
if ($row === null) {
// записи нет
}Поля сущности 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()Проверяет поля данных перед сохранением в БД. Результат хранится в объекте $resultcleanCache()Очищает кеш таблета после модификаций данных.createCollection()createObject()cryptoEnabled()Возвращает true, если для поля включено шифрование.delete()Удаляет строку в таблице сущности по первичному ключуenableCrypto()Устанавливает флаг, указывающий на поддержку шифрования для поля.getById()Возвращает выборку по первичному ключу сущностиgetByPrimary()Возвращает выборку по первичному ключу сущности и необязательным параметрам для getList()getCollectionClass()Возвращает класс коллекции объектов для текущей сущности.
getRow() есть и у других классов модуля «Интернет-магазин»: CashboxRestHandlerTable, DeliveryRestHandlerTable, DiscountCouponTable, DiscountEntitiesTable, DiscountGroupTable, DiscountModuleTable, DiscountTable, EntityLabelTable.
Исходный файл: source/sale/lib/internals/usertransacttable.php:398

