method public static

DiscountTable::update()

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

Сигнатура

public static update(mixed $primary, array<string|int, mixed> $data) : UpdateResult

Описание

Обновляет строку в таблице сущности по первичному ключу

Параметры

$primary mixed
$data array<string|int, mixed>
Массив с полями вида array( "fields" => array( "FIELD1" => "value1", "FIELD2" => "value2", ), "auth_context" => \Bitrix\Main\Authentication\Context object ) либо просто плоский массив полей.

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

UpdateResult

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

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

Изменяет строку DiscountTable по первичному ключу: передаются только меняющиеся поля. Как и add(), проходит проверку полей и события.

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

Loader::includeModule('sale');

$result = DiscountTable::update(1, [
    'XML_ID' => 'xml_id',
    'LID' => 'lid',
    'NAME' => 'name',
]);
if (!$result->isSuccess()) {
    $errors = $result->getErrorMessages();
}

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

ПолеТипСвойства
IDintобязательное
XML_IDstring(255)необязательное
LIDstring(2)обязательное
NAMEstring(255)необязательное
PRICE_FROMfloatнеобязательное
PRICE_TOfloatнеобязательное
CURRENCYstring(3)необязательное
DISCOUNT_VALUEfloatобязательное
DISCOUNT_TYPEstring(1)обязательное, по умолчанию 'P'
ACTIVEboolнеобязательное, по умолчанию 'Y'
SORTintнеобязательное, по умолчанию 100
ACTIVE_FROMdatetimeнеобязательное
ACTIVE_TOdatetimeнеобязательное
TIMESTAMP_Xdatetimeнеобязательное
MODIFIED_BYintнеобязательное
DATE_CREATEdatetimeнеобязательное
CREATED_BYintнеобязательное
PRIORITYintнеобязательное, по умолчанию 1
LAST_DISCOUNTboolнеобязательное, по умолчанию 'Y'
VERSIONintнеобязательное, по умолчанию 3
CONDITIONStextнеобязательное
CONDITIONS_LISTtextнеобязательное
UNPACKtextнеобязательное
ACTIONStextнеобязательное
ACTIONS_LISTtextнеобязательное
APPLICATIONtextнеобязательное
PREDICTION_TEXTtextнеобязательное
PREDICTIONStextнеобязательное
PREDICTIONS_APPtextнеобязательное
USE_COUPONSboolнеобязательное, по умолчанию 'N'
USE_INDEXboolнеобязательное, по умолчанию 'N'
PRESET_IDstringнеобязательное
EXECUTE_MODULEstring(50)обязательное, по умолчанию 'all'
EXECUTE_MODEintпо умолчанию 0
CREATED_BY_USERreference
MODIFIED_BY_USERreference

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

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

  • setAllUseCoupons() Устанавливает флаг наличия купонов для всех скидок.
  • setUseCoupons() Установить флаг наличия купонов для списка скидок.
  • validateCurrency() Возвращает валидаторы для поля CURRENCY.
  • validateDiscountType() Возвращает валидаторы для поля DISCOUNT_TYPE.
  • validateExecuteModule() Возвращает валидаторы для поля EXECUTE_MODULE.
  • validateLid() Возвращает валидаторы для поля LID.
  • validateName() Возвращает валидаторы для поля NAME.
  • validatePresetId() Возвращает валидаторы для поля PRESET_ID.
  • validateXmlId() Возвращает валидаторы для поля XML_ID.

update() есть и у других классов модуля «Интернет-магазин»: CashboxRestHandlerTable, DeliveryRestHandlerTable, DiscountCouponTable, DiscountEntitiesTable, DiscountGroupTable, DiscountModuleTable, EntityLabelTable, Fuser.

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

Что будем искать? Например,Продвижение