DiscountTable::add()
Сигнатура
public static add(array<string|int, mixed> $data) : AddResult
Описание
Добавить скидку.
Параметры
$data
array<string|int, mixed>
Возвращаемое значение
AddResult
Как применяется в DiscountTable
DiscountTable::add() — метод класса \Bitrix\Catalog\DiscountTable модуля «Торговый каталог». Это ORM-сущность D7 (наследник DataManager): строки читаются как объекты EO_Discount, наборы — как EO_Discount_Collection. Метод достаётся DiscountTable от DataManager::add: поведение общее для всех сущностей, а данные, поля и классы — свои.
Добавляет строку в таблицу DiscountTable. Перед записью ORM проверяет поля (checkFields()) и вызывает события; ошибки возвращаются в результате, исключения не бросаются.
use Bitrix\Main\Loader;
use Bitrix\Catalog\DiscountTable;
Loader::includeModule('catalog');
$result = DiscountTable::add([
'XML_ID' => 'xml_id',
'SITE_ID' => 'site_id',
'TYPE' => 1,
]);
if ($result->isSuccess()) {
$id = $result->getId();
} else {
$errors = $result->getErrorMessages();
}Поля сущности DiscountTable
| Поле | Тип | Свойства |
|---|---|---|
ID | int | обязательное |
XML_ID | string(255) | необязательное |
SITE_ID | string(2) | обязательное |
TYPE | int | обязательное |
ACTIVE | bool | необязательное, по умолчанию 'Y' |
ACTIVE_FROM | datetime | необязательное |
ACTIVE_TO | datetime | необязательное |
RENEWAL | bool | необязательное, по умолчанию 'N' |
NAME | string(255) | необязательное |
SORT | int | необязательное, по умолчанию 100 |
MAX_DISCOUNT | double | необязательное |
VALUE_TYPE | string(1) | обязательное, по умолчанию 'P' |
VALUE | double | обязательное, по умолчанию 0.0000 |
CURRENCY | string(3) | обязательное |
TIMESTAMP_X | datetime | обязательное, по умолчанию 'CURRENT_TIMESTAMP' |
COUNT_PERIOD | string(1) | обязательное, по умолчанию 'U' |
COUNT_SIZE | int | обязательное |
COUNT_TYPE | bool | необязательное, по умолчанию 'Y' |
COUNT_FROM | datetime | необязательное |
COUNT_TO | datetime | необязательное |
ACTION_SIZE | int | обязательное |
ACTION_TYPE | bool | необязательное, по умолчанию 'Y' |
MODIFIED_BY | int | необязательное |
DATE_CREATE | datetime | необязательное |
CREATED_BY | int | необязательное |
PRIORITY | int | необязательное, по умолчанию 1 |
LAST_DISCOUNT | bool | необязательное, по умолчанию 'Y' |
VERSION | int | необязательное, по умолчанию 1 |
NOTES | string(255) | необязательное |
CONDITIONS | string | необязательное |
UNPACK | string | необязательное |
USE_COUPONS | bool | необязательное, по умолчанию 'N' |
CREATED_BY_USER | reference | |
MODIFIED_BY_USER | reference | |
RESTRICTION | reference |
Список — из описания класса в исходном коде; точный состав в вашей версии вернёт DiscountTable::getEntity()->getFields().
Собственные методы DiscountTable
checkType()Проверить поле TYPE.convertCurrency()Преобразовать данные скидки в другую валюту (валюту магазина).setUseCoupons()Установить флаг наличия купонов для списка скидок.validateCurrency()Возвращает валидаторы для поля CURRENCY.validateName()Возвращает валидаторы для поля NAME.validateNotes()Возвращает валидаторы для поля NOTES.validateSiteId()Возвращает валидаторы для поля SITE_ID.validateType()Возвращает валидаторы для поля TYPE.validateXmlId()Возвращает валидаторы для поля XML_ID.
add() есть и у других классов модуля «Торговый каталог»: CatalogIblockTable, CatalogViewedProductTable, DiscountCouponTable, DiscountModuleTable, DiscountRestrictionTable, ExtraTable, GroupAccessTable, GroupLangTable.
Исходный файл: source/catalog/lib/discount.php:361

