1c-events-transactions
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 4
- Forks
- 0
02 资源文件 3
- 参考文档references/events.md8.2 KB
- 参考文档references/language.md21.2 KB
- 参考文档references/locks-transactions.md16.8 KB
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
1c-valid
Эталонный валидный скил для тестов. Use when testing validator — все правила соблюдены, ошибок быть не должно.
1c-no-license
Скил без поля license — должен дать ошибку об обязательном поле.
1c-broken
暂无简介
1c-ui-ux
暂无简介
1c-thin-triggers
暂无简介
1c-testing
暂无简介