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