Документация для разработчиков
Темная тема

OnBeforeIBlockPropertyAdd

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

bool функция-обработчик(
	array &arParams 
);
Событие вызывается в методе CIBlockProperty::Add до вставки свойства в инфоблок, и может быть использовано для отмены вставки или переопределения некоторых полей.

Параметры

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

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

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

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

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

<?
// файл /bitrix/php_interface/init.php
// регистрируем обработчик
AddEventHandler("iblock", "OnBeforeIBlockPropertyAdd", Array("MyClass", "OnBeforeIBlockPropertyAddHandler"));
class MyClass { // создаем обработчик события "OnBeforeIBlockPropertyAdd" public static function OnBeforeIBlockPropertyAddHandler(&$arFields) { if(strlen($arFields["CODE"])<=0) { global $APPLICATION; $APPLICATION->throwException("Введите символьный код."); return false; } } } ?>


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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх