method public static

DiscountGroupTable::add()

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

Сигнатура

public static add(array<string|int, mixed> $data) : AddResult

Описание

Добавляет строку в таблицу сущности

Параметры

$data array<string|int, mixed>

Массив с полями вида array( "fields" => array( "FIELD1" => "value1", "FIELD2" => "value2", ), "auth_context" => \Bitrix\Main\Authentication\Context object ) либо просто плоский массив полей. Этот метод использует стратегию по умолчанию, определённую в классе.

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

AddResult

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

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

Добавляет строку в таблицу DiscountGroupTable. Перед записью ORM проверяет поля (checkFields()) и вызывает события; ошибки возвращаются в результате, исключения не бросаются.

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

Loader::includeModule('sale');

$result = DiscountGroupTable::add([
    'DISCOUNT_ID' => 1,
    'ACTIVE' => 'active',
    'GROUP_ID' => 1,
]);
if ($result->isSuccess()) {
    $id = $result->getId();
} else {
    $errors = $result->getErrorMessages();
}

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

Поле	Тип	Свойства
`ID`	`int`	обязательное
`DISCOUNT_ID`	`int`	обязательное
`ACTIVE`	`string(1)`	необязательное
`GROUP_ID`	`int`	обязательное
`DISCOUNT`	`reference`

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

Собственные методы DiscountGroupTable

changeActiveByDiscount() Изменить флаг активности в таблице по скидке.
deleteByDiscount() Удаляет список групп пользователей по скидке.
getActiveDiscountByGroups() Возвращает активные скидки по списку групп пользователей.
getDiscountByGroups() Возвращает список скидок по группам пользователей.
updateByDiscount() Обновляет список групп пользователей по скидке.

add() есть и у других классов модуля «Интернет-магазин»: ActionEntity, BasketArchiveTable, CashboxRestHandlerTable, DeliveryRestHandlerTable, DiscountCouponsManager, DiscountCouponsManagerBase, DiscountCouponTable, DiscountEntitiesTable.

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