1c-transactions-and-locks

Транзакции и управляемые блокировки 1С

Применяется: при написании и правке кода, который пишет в информационную базу - обработчики записи и проведения, групповые операции, обмены, загрузки.

Это канон по теме. В карточке TXN-01 каталога дефектов (anti_patterns.md пункт 8) и в 1c-coding-standards.md разделе про конкурентность остались короткие ссылки сюда, чтобы не разошлись две версии.

---

Транзакции, которые платформа открывает сама

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

Операция	Что попадает внутрь транзакции
Записать() у ссылочного объекта	ПередЗаписью, сама запись, ПриЗаписи, проведение
Удалить() у ссылочного объекта	ПередУдалением, удаление
Записать() у набора записей регистра	запись набора целиком
Формирование движений при проведении	запись наборов движений

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

Там же не нужны и дополнительные блокировки на записываемый объект: платформа его уже заблокировала.

Канонический шаблон явной транзакции

Явная транзакция открывается в вызывающем коде, когда нужно атомарно записать несколько объектов или совместить запись с правкой регистров.

НачатьТранзакцию();

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

	ДанныеОшибки = Новый Структура;
	ДанныеОшибки.Вставить("Документ", Документ.Ссылка);
	ДанныеОшибки.Вставить("Подробно", ПодробноеПредставлениеОшибки(ИнформацияОбОшибке()));

	ЗаписьЖурналаРегистрации(
		"Проведение." + Документ.Метаданные().Имя + ".Ошибка",
		УровеньЖурналаРегистрации.Ошибка,
		Документ.Метаданные(),
		Документ.Ссылка,
		НСтр("ru = 'Не удалось провести документ.'"),
		ДанныеОшибки);

	ВызватьИсключение;
КонецПопытки;