CurrencyTable::add()
Сигнатура
public static add(array<string|int, mixed> $data) : AddResult
Описание
Добавляет строку в таблицу сущности
Параметры
$data
array<string|int, mixed>
Возвращаемое значение
AddResult
Как применяется в CurrencyTable
CurrencyTable::add() — метод класса \Bitrix\Currency\CurrencyTable модуля «Валюты». Это ORM-сущность D7 (наследник DataManager): строки читаются как объекты EO_Currency, наборы — как EO_Currency_Collection. Метод достаётся CurrencyTable от DataManager::add: поведение общее для всех сущностей, а данные, поля и классы — свои.
Добавляет строку в таблицу CurrencyTable. Перед записью ORM проверяет поля (checkFields()) и вызывает события; ошибки возвращаются в результате, исключения не бросаются.
use Bitrix\Main\Loader;
use Bitrix\Currency\CurrencyTable;
Loader::includeModule('currency');
$result = CurrencyTable::add([
'CURRENCY' => 'currency',
'AMOUNT_CNT' => 1,
'AMOUNT' => 1.5,
]);
if ($result->isSuccess()) {
$id = $result->getId();
} else {
$errors = $result->getErrorMessages();
}Поля сущности CurrencyTable
| Поле | Тип | Свойства |
|---|---|---|
CURRENCY | string(3) | обязательное |
AMOUNT_CNT | int | необязательное, по умолчанию 1 |
AMOUNT | float | необязательное |
SORT | int | необязательное, по умолчанию 100 |
DATE_UPDATE | datetime | обязательное |
NUMCODE | string(3) | необязательное |
BASE | string(1) | обязательное |
CREATED_BY | int | необязательное |
DATE_CREATE | datetime | необязательное |
MODIFIED_BY | int | необязательное |
CURRENT_BASE_RATE | float | необязательное |
CREATED_BY_USER | reference | |
MODIFIED_BY_USER | reference | |
LANG_FORMAT | reference | |
CURRENT_LANG_FORMAT | reference |
Список — из описания класса в исходном коде; точный состав в вашей версии вернёт CurrencyTable::getEntity()->getFields().
Собственные методы CurrencyTable
add() есть и у других классов модуля «Валюты»: CurrencyLangTable, CurrencyRateTable.
Исходный файл: source/currency/lib/currency.php:877

