РегистрБухгалтерииНаборЗаписей.<Имя регистра бухгалтерии>.ПриЗаписи

События · OnWrite

Возникает при записи объекта. Процедура-обработчик вызывается после записи объекта в базу данных, но до окончания транзакции записи.

Синтаксис

ПриЗаписи(<Отказ>, <Замещение>)
Полное описание, параметры и ограничения

РегистрБухгалтерииНаборЗаписей.<Имя регистра бухгалтерии>.ПриЗаписи (AccountingRegisterRecordSet.<Accounting register name>.OnWrite)

РегистрБухгалтерииНаборЗаписей.<Имя регистра бухгалтерии> (AccountingRegisterRecordSet.<Accounting register name>)

ПриЗаписи (OnWrite)

Доступен, начиная с версии 8.0.

Синтаксис:
ПриЗаписи(<Отказ>, <Замещение>)
Параметры:

<Отказ>
Тип: Булево.
Признак отказа от выполнения действия.
Значение по умолчанию: Ложь.

<Замещение>
Тип: Булево.
Режим записи набора.
Истина - запись осуществляется с заменой существующих в базе данных записей набора.
Ложь - запись осуществляется с "дописыванием" текущего набора записей.
Описание:

Возникает при записи объекта. Процедура-обработчик вызывается после записи объекта в базу данных, но до окончания транзакции записи.

Доступность:

Сервер, толстый клиент, внешнее соединение.

Замечание:

Безопасный режим на время исполнения данного обработчика будет отключен. Данное замечание не относится к обработчикам событий, расположенным в расширении конфигурации.
Использование в версии:

Доступен, начиная с версии 8.0.

Методическая информация

Практические примеры

Обработать ПриЗаписи своего УчебныйУчетЗапросов

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

Где и как запускать

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

Подготовка

  1. В собственной пустой учебной конфигурации создайте план счетов УчебныеСчетаЗапросов: строковый код 10, максимум субконто 0. В предопределенных данных добавьте Актив (код УЧ-А, вид Активный) и Пассив (код УЧ-П, вид Пассивный), оба не забалансовые. Обновление учебной базы должно создать их как данные.

  2. Создайте регистр бухгалтерии УчебныйУчетЗапросов с планом УчебныеСчетаЗапросов и включенной Корреспонденцией. Длина уточнения периода 3, итоги включены. Измерения: Организация (Строка 20, Балансовый Истина), Подразделение (Строка 20, Балансовый Ложь).

  3. Ресурсы регистра: Сумма (Число 15.2, Балансовый Истина), Количество (Число 10.0, Балансовый Ложь). Признаки учета для ресурсов не назначайте: в этой учебной схеме они используются для обоих счетов. Реквизит регистра Комментарий (Строка 100). Общие реквизиты и субконто для этой партии не нужны.

  4. Создайте документ УчебнаяПроводкаЗапросов с разрешенным проведением и автонумерацией. Реквизиты: СчетДебета и СчетКредита (ПланСчетовСсылка.УчебныеСчетаЗапросов), Организация (Строка 20), ПодразделениеДебета и ПодразделениеКредита (Строка 20), Сумма (Число 15.2), КоличествоДебета и КоличествоКредита (Число 10.0), Комментарий (Строка 100).

  5. В движениях документа УчебнаяПроводкаЗапросов включите УчебныйУчетЗапросов. Обработчик проведения не нужен: проверочный блок отдельно записывает непроведённый собственный регистратор и его набор.

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

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

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

Процедура ПриЗаписи(Отказ, Замещение)
    Сообщить("Записывается учебный набор: " + Строка(ЭтотОбъект.Количество()));
    Для Каждого Запись Из ЭтотОбъект Цикл
        Сообщить("Сумма: " + Строка(Запись.Сумма));
    КонецЦикла;
КонецПроцедуры
Серверная процедура: новый собственный регистратор и настоящая запись набора
Документ = Документы.УчебнаяПроводкаЗапросов.СоздатьДокумент();
Документ.Дата = Дата(2026, 10, 14);
Документ.Записать();
Набор = РегистрыБухгалтерии.УчебныйУчетЗапросов.СоздатьНаборЗаписей();
Набор.Отбор.Регистратор.Установить(Документ.Ссылка);
Запись = Набор.Добавить();
Запись.Период = Документ.Дата;
Запись.Активность = Истина;
Запись.СчетДт = ПланыСчетов.УчебныеСчетаЗапросов.Актив;
Запись.СчетКт = ПланыСчетов.УчебныеСчетаЗапросов.Пассив;
Запись.Организация = "Урок";
Запись.ПодразделениеДт = "А";
Запись.ПодразделениеКт = "Б";
Запись.Сумма = 750;
Запись.КоличествоДт = 3;
Запись.КоличествоКт = 3;
Если Набор.ПроверитьЗаполнение() Тогда
    Набор.Записать();
    Сообщить("Записан собственный учебный набор");
КонецЕсли;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.