Обработать ПриЗаписи своего УчебныеНачисленияНастроек

Показываем состав настоящего записываемого набора. ПриЗаписи выполняется внутри процесса записи и не означает, что внешняя транзакция уже зафиксирована.

Подготовка

1. Работайте только в собственной пустой учебной конфигурации. В Конфигураторе создайте ПланВидовРасчета УчебныеВидыРасчета; не добавляйте эти учебные объекты в рабочую базу.

2. Код — строковый длиной 10, наименование длиной 100. Для справочника, плана обмена и плана видов характеристик включите автонумерацию. Для счетов и видов расчёта код назначается явно в примере.

3. Для плана видов расчёта не включайте зависимость от базового периода и действие по периоду. Регистры расчёта в этом уроке не нужны.

4. Добавьте реквизиты Комментарий (Строка 100), Лимит (Число 15.2 с разрешённым отрицательным знаком), ЗапретУдаления (Булево). Не делайте их автоматически обязательными: дополнительные правила описаны отдельными обработчиками.

5. Для этой диагностики дополнительно создайте документ УчебныйРасчетНастроек с разрешённым проведением. Создайте регистр расчёта УчебныеНачисленияНастроек, периодичность Месяц, план видов расчёта УчебныеВидыРасчета, регистратор УчебныйРасчетНастроек, ресурс Результат типа Число 12.2.

6. Остальные механизмы расчёта оставьте выключенными. Обновите учебную конфигурацию; документы и начисления не создавайте. Читается только Периодичность регистра, начисление зарплаты не выполняется.

7. В модуле набора записей УчебныеНачисленияНастроек поместите основной обработчик. Для его запуска не назначайте событие формы и не вызывайте процедуру вручную.

8. Обновите учебную базу. Дополнительный блок выполняйте в серверной процедуре своей обработки. Каждый запуск создаёт отдельный собственный документ-регистратор; фильтр набора ограничивает запись только этим новым документом.

9. В этом упражнении учебный регистратор записывается без проведения, затем явно записывается его набор. Это демонстрация API набора, не реализация полноценного проведения документа. Рабочие документы не используются.

Процедура ПриЗаписи(Отказ, Замещение, ТолькоЗапись, ЗаписьФактическогоПериодаДействия, ЗаписьПерерасчетов)
    Сообщить("Записывается учебный набор: " + Строка(ЭтотОбъект.Количество()));
    Для Каждого Запись Из ЭтотОбъект Цикл
        Сообщить("Результат: " + Строка(Запись.Результат));
    КонецЦикла;
КонецПроцедуры

ВидРасчета = ПланыВидовРасчета.УчебныеВидыРасчета.СоздатьВидРасчета();
ВидРасчета.Код = Лев(Строка(Новый УникальныйИдентификатор), 8);
ВидРасчета.Наименование = "Учебное начисление";
ВидРасчета.Записать();
Документ = Документы.УчебныйРасчетНастроек.СоздатьДокумент();
Документ.Дата = Дата(2026, 10, 14);
Документ.Записать();
Набор = РегистрыРасчета.УчебныеНачисленияНастроек.СоздатьНаборЗаписей();
Набор.Отбор.Регистратор.Установить(Документ.Ссылка);
Запись = Набор.Добавить();
Запись.ПериодРегистрации = Дата(2026, 10, 1);
Запись.ВидРасчета = ВидРасчета.Ссылка;
Запись.Активность = Истина;
Запись.Результат = 750;
Если Набор.ПроверитьЗаполнение() Тогда
    Набор.Записать();
    Сообщить("Записан собственный учебный набор");
КонецЕсли;

Разбор по шагам

1. ЭтотОбъект в модуле набора записей — тот самый набор, созданный и заполненный дополнительным кодом.

2. ПроверитьЗаполнение запускает соответствующую проверку; Записать запускает события записи. Один вызов не подменяется ручным вызовом процедуры.

3. Замещение касается выбранного регистратора. Обработчик не записывает ЭтотОбъект повторно и не запускает рекурсивное проведение.

Как проверить результат

1. С положительным ресурсом проверка допускает запись собственного набора. Сообщения обработчика показывают его реальные строки.

2. Для ОбработкаПроверкиЗаполнения / ПередЗаписью замените ресурс в новом проверочном наборе на -1: своё правило устанавливает Отказ. Для ПриЗаписи проверка отрицательных значений не добавляется, обработчик только сообщает значения.

Ожидаемый результат

Платформенное событие обработало настоящий собственный набор записей.

На что обратить внимание

1. Отказ отменяет конкретное действие; сообщение само по себе ничего не отменяет.

2. Не очищайте отбор регистратора и не запускайте этот учебный блок над рабочими записями.

3. ПриЗаписи не подходит для отправки внешних сообщений о гарантированно зафиксированной транзакции. Показанный BSL при сборке справочника не выполнялся.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.