OnBeforeIBlockElementUpdate

Описание и параметры

bool функция-обработчик(
	array &arParams 
);

Событие вызывается в методе CIBlockElement::Update до изменения элемента информационного блока, и может быть использовано для отмены изменения или для переопределения некоторых полей.

Параметры

Параметр	Описание
arParams	Массив полей изменяемого элемента информационного блока.

Обратите внимание, что все параметры данного обработчика являются ссылками на исходные переменные. Поэтому если вы измените значение параметра внутри обработчика, это приведет к смене значения исходной переменной поступившей на вход функции-обработчика.

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

Для отмены изменения и прекращении выполнения метода CIBlockElement::Update необходимо в функции-обработчике создать исключение методом $APPLICATION->ThrowException() и вернуть false.

Смотрите также

Пример функции-обработчика

<?
// файл /bitrix/php_interface/init.php
// регистрируем обработчик
AddEventHandler("iblock", "OnBeforeIBlockElementUpdate", Array("MyClass", "OnBeforeIBlockElementUpdateHandler"));

class MyClass
{
	// создаем обработчик события "OnBeforeIBlockElementUpdate"
	public static function OnBeforeIBlockElementUpdateHandler(&$arFields)
	{
		if(strlen($arFields["CODE"])<=0)
		{
			global $APPLICATION;
			$APPLICATION->throwException("Введите символьный код. (ID:".$arFields["ID"].")");
			return false;
		}
	}
}
?>

Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.

10 Денис Турчин 20.04.2021 07:07:33
Важный, но не всегда очевидный момент: если вы манипулируете в обработчике данными массива PROPERTY_VALUES, то обязательно проверяйте его на существование! В противном случае, если метод CIBlockElement::Update был вызван без указания значений этого массива, ваши манипуляции очистят все остальные свойства элемента инфоблока.

Наверх