Возникает в момент, когда выполняется установка нового кода элемента справочника.
Синтаксис
ПриУстановкеНовогоКода(<СтандартнаяОбработка>, <Префикс>)Полное описание, параметры и ограничения
СправочникОбъект.<Имя справочника>.ПриУстановкеНовогоКода (CatalogObject.<Catalog name>.OnSetNewCode)
СправочникОбъект.<Имя справочника> (CatalogObject.<Catalog name>)
ПриУстановкеНовогоКода (OnSetNewCode)
Доступен, начиная с версии 8.0.
Синтаксис:
ПриУстановкеНовогоКода(<СтандартнаяОбработка>, <Префикс>)
Параметры:
<СтандартнаяОбработка>
Тип: Булево.
В данный параметр передается признак выполнения стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь, стандартная генерация нового кода производиться не будет.
Значение по умолчанию: Истина.
<Префикс>
Тип: Строка.
Префикс, который будет использоваться для генерации кода. Может быть изменен в процедуре-обработчике события.
Описание:
Возникает в момент, когда выполняется установка нового кода элемента справочника.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Параметр <Префикс> может быть указан, если код имеет тип Строка.
Замечание:
Безопасный режим на время исполнения данного обработчика будет отключен. Данное замечание не относится к обработчикам событий, расположенным в расширении конфигурации.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Добавить префикс к автоматически выдаваемому коду
Меняем префикс, оставляя выдачу уникального кода платформе.
Где и как запускать
Модуль объекта или набора записей, указанный в подготовке. Обработчик вызывается платформой; не вызывайте его как обычную команду формы.
Подготовка
В отдельной учебной конфигурации создайте неиерархический справочник УчебныеТовары: строковый код длиной 10 с автонумерацией, наименование длиной 100.
Добавьте реквизиты Цена (Число 15.2) и СнятСПродажи (Булево). Для Цена не включайте автоматический запрет отрицательного знака: в примере его проверяет код.
Откройте Справочники → УчебныеТовары → Модуль объекта. Обработчики размещаются на уровне модуля, не внутри команды формы. Обновите только учебную базу и проверяйте её элементы.
Процедура ПриУстановкеНовогоКода(СтандартнаяОбработка, Префикс)
Префикс = "УЧ-";
СтандартнаяОбработка = Истина;
Сообщить("Префикс нового кода: " + Префикс);
КонецПроцедурыРазбор по шагам
Создайте новый элемент с пустым кодом.
Обработчик задаёт префикс строкового кода.
СтандартнаяОбработка = Истина сохраняет автоматическую нумерацию.
Как проверить результат
Новый автоматически выданный код начинается с УЧ-.
Два новых учебных элемента получают разные коды.
Ожидаемый результат
Платформа выдаёт код с учебным префиксом.
На что обратить внимание
Префикс применяется только к строковому коду.
Не выключайте стандартную обработку, если не реализовали собственную уникальную нумерацию.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.