AGENT SKILL

1c-events-transactions

暂无简介

License 许可
MIT
最近更新
2026-11-14
Stars
★ 4
Forks
0

02 资源文件 3

03 SKILL.md 正文

1c-events-transactions — проведение, блокировки, транзакции, язык

Обработчики событий объектов/форм, проведение документов, шаблоны транзакций, управляемые блокировки. Это «горячая» зона — ошибки здесь дорого стоят (deadlock'и, рассинхрон данных).

🔴 №783 — Транзакции: короткие, только запись

Транзакция должна быть короткой и охватывать только запись.

Шаблон (как в БСП):

// Чтение и подготовка данных — ДО транзакции
ДанныеДляЗаписи = ПодготовитьДанные();   // запросы, .ПолучитьОбъект(), вычисления

НачатьТранзакцию();
Попытка
    // ... только запись ...
    ЗаписатьДанные(ДанныеДляЗаписи);
    ЗафиксироватьТранзакцию();
Исключение
    ОтменитьТранзакцию();
    ВызватьИсключение;   // обязательно!
КонецПопытки;

❌ Неправильно — чтение внутри транзакции:

НачатьТранзакцию();
Попытка
    Выборка = Запрос.Выполнить().Выбрать();   // 🔴 чтение ВНУТРИ транзакции
    Пока Выборка.Следующий() Цикл ... КонецЦикла;
    ЗафиксироватьТранзакцию();
Исключение
    ОтменитьТранзакцию();
    ВызватьИсключение;
КонецПопытки;

⚠️ Исключение: чтение внутри транзакции допустимо для read-modify-write с явной БлокировкаДанных — когда без блокировки нельзя гарантировать консистентность остатка. Это осознанный компромисс с комментарием-обоснованием (см. references/locks-transactions.md §3).

⚠️ Второе исключение — контроль остатков после записи движений в ОбработкаПроведения: Движения.Записать() → чтение Остатки(&МоментВремени, …) → Отказ при уходе в минус. Это чтение ВНУТРИ транзакции проведения канонично (платформа открыла транзакцию; Отказ откатит движения). Не «чините» его выносом чтения за транзакцию — контроль сломается. Полный шаблон — в секции «Контроль отрицательных остатков» ниже.


🔴 №460 — Управляемый режим блокировки

В прикладном коде — управляемые блокировки (БлокировкаДанных), не исключительные. Исключительные — только в особых случаях, с обоснованием в комментарии.


№648 — Точечное чтение данных

Не читать «на всякий случай» весь объект. 2 поля — читайте 2 поля, а не Объект.Ссылка целиком.

❌ ДокОбъект = ДокСсылка.ПолучитьОбъект(); — вытянули ВСЕ реквизиты ✅ Значения = ОбщегоНазначения.ЗначенияРеквизитовОбъекта(ДокСсылка, "Организация");


№450 / №464 / №465 — Обработчики проведения

Событие Когда Что делать
ОбработкаПроведения При проведении Формировать движения; транзакция уже открыта платформой — не вкладывать НачалоТранзакции
ОбработкаУдаленияПроведения При отмене проведения Сформировать пустой набор / удалить движения
ПередЗаписью Перед записью (проведён/непроведён) Валидация, заполнение по умолчанию

🔴 Движения (Движения.X) — только в обработчиках проведения, не из внешнего кода.


№661 — Блокирующее чтение остатков

В начале транзакции проведения не делайте блокирующего чтения остатков без необходимости — это источник deadlock'ов. Только если действительно нужен read-modify-write с гарантией.


Шаблон read-modify-write с блокировкой

НачалоТранзакции();
Попытка
    // Блокировка ДО чтения: иначе два пользователя проведут одновременно
    // и получат отрицательный остаток.
    Блокировка = Новый БлокировкаДанных;
    ЭлементБлокировки = Блокировка.Добавить("РегистрНакопления.<Имя>");
    ЭлементБлокировки.УстановитьЗначение("Измерение", Значение);
    ЭлементБлокировки.Режим = РежимБлокировкиДанных.Исключительный;
    Блокировка.Заблокировать();

    // Чтение остатка (можно внутри транзакции — есть блокировка)
    Остаток = ПолучитьОстаток(Значение);

    // Проверка + запись
    Если Остаток < Расход Тогда
        ВызватьИсключение НСтр("ru = 'Недостаточно остатка'");
    КонецЕсли;

    // ... запись движения ...
    ЗафиксироватьТранзакцию();
Исключение
    ОтменитьТранзакцию();
    ВызватьИсключение;
КонецПопытки;

📖 Подробности и 6 сценариев блокировок — references/locks-transactions.md.


🔴 Контроль отрицательных остатков при проведении (баланс-регистры)

Канонический паттерн для остаточных регистров: сначала записать движения, потом прочитать остатки и отказать при уходе в минус. Чтение Остатки(&МоментВремени, …) здесь идёт ВНУТРИ транзакции проведения — это допустимое исключение из №783 (платформа уже открыла транзакцию, Отказ откатит записанные движения).

Процедура ОбработкаПроведения(Отказ, РежимПроведения)
    Если Не Отказ Тогда
        УстановитьУправляемыеБлокировки();   // №460 — по измерениям регистра
        СформироватьДвижения();               // Движения.X.Записывать = Истина
        Движения.Записать();                  // №792 — пакетная запись ДО контроля

        // Чтение Остатки внутри транзакции проведения — канон для баланс-регистров.
        // Контроль: ВТ ключей → Остатки(&МоментВремени, (Изм) В (ВЫБРАТЬ ИЗ ВрКлючи))
        // → ГДЕ/ИМЕЮЩИЕ ЕСТЬNULL(КоличествоОстаток,0) < 0 → СообщитьПользователю(…,Отказ)
        ПроконтролироватьОстатки(Отказ);
    КонецЕсли;
КонецПроцедуры

🔑 Требование к регистру (частая ловушка, выявлена в полевом тесте): контроль остатков возможен только для накопительных регистров типа Balance / BalanceAndTurnovers. На регистре Turnovers (Обороты) виртуальной таблицы .Остатки() не существует — запрос не скомпилируется. Если в задаче «проведение по остаткам» целевой регистр оказался оборотным — нужен другой/новый баланс-регистр. См. 1c-metadata → references/registers-design.md §1.

📖 Образец в типовых: Документ.ВнутреннееПотреблениеТоваров.ОбработкаПроведения (Движения.Записать() → Остатки(&Дата, …) с Граница(МоментВремени(), ВидГраницы.Включая) → Отказ).


№499 / №790 — Исключения и логирование (кратко)

  • Попытка/Исключение — обязательно логировать причину через ЗаписьЖурналаРегистрации. Молчаливый перехват — антипаттерн.
  • ВызватьИсключение — с понятным локализованным текстом (НСтр("ru = '…'")), не технический мусор ("err-1").

Полная карточка — скил 1c-logging.


Мини-чек-лист по проведению и транзакциям

  • [ ] Транзакция короткая, только запись (№783)
  • [ ] Чтение данных — до НачалоТранзакции(), не внутри (№783)
  • [ ] НачалоТранзакции() не внутри ОбработкаПроведения (уже открыта платформой)
  • [ ] Попытка/Исключение с ОтменитьТранзакцию() + ВызватьИсключение
  • [ ] Блокировки управляемые (БлокировкаДанных), не исключительные (№460)
  • [ ] Блокировка ДО чтения остатков при read-modify-write (№661)
  • [ ] Контроль остатков после Движения.Записать() — только для баланс-регистра (Остатки(&МоментВремени,…), №733); это разрешённое исключение №783, не чинить его выносом за транзакцию
  • [ ] Движения — только в обработчиках проведения
  • [ ] Чтение точечное (ЗначенияРеквизитовОбъекта, не .ПолучитьОбъект()) (№648)
  • [ ] Попытка/Исключение логируется, не молчит (№499)

Детали (читать по необходимости)

  • references/events.md — обработчики событий объектов и форм (№450, №464, №465, №789, №558…)
  • references/locks-transactions.md — блокировки и транзакции: §2 диалоги в транзакции, §3 read-modify-write, §4 deadlock'и, §5 массовые операции, §6 сценарии
  • references/language.md — код, процедуры, параметры: №648, №783, №460, №724, №646/307, №454/647, №441/455/456, №782, №499, №790

04 同仓库更多 Skills