При интеграции различных конфигураций 1С через механизм COM-соединения разработчики часто сталкиваются с ситуацией, когда код, успешно работающий внутри базы, начинает выдавать ошибку при вызове извне. Типичный сценарий: создание и запись документа (например, ЗаявкаНаРемонт в «Альфа-Авто») прерывается системным сообщением: «Попытка передачи с клиента на сервер мутабельного значения». Рассмотрим подробно, почему это происходит и как правильно организовать запись данных, чтобы избежать конфликтов контекстов.
Для начала проанализируем природу COM-соединения (V83.COMConnector). В архитектуре 1С этот контекст является специфическим. Несмотря на то что он выполняется на стороне сервера (если соединение инициировано серверным кодом), платформа зачастую интерпретирует его как «Внешнее соединение», которое имеет свои ограничения на передачу данных.
Когда мы вызываем метод Записать() у объекта, созданного через COM, платформа инициирует выполнение всех связанных событий: ПередЗаписью, ПриЗаписи, а также всех подписок на события, зарегистрированных в конфигурации. Проблема заключается в следующем:
ДокументОбъект.ДокументОбъект является мутабельным (изменяемым). Правила платформы 1С строго запрещают передачу мутабельных значений между разными контекстами (например, из контекста внешнего соединения в контекст сервера).В конфигурациях вроде «Альфа-Авто» часто встречаются подписки (например, связанные с обменом данными или мобильными устройствами), которые не рассчитаны на работу через COM, что и приводит к падению системы.
Это самый надежный и архитектурно правильный способ. Вместо того чтобы пытаться манипулировать объектом напрямую через COM, мы переносим логику создания и записи документа внутрь самой целевой конфигурации. Рассмотрим этот метод по шагам.
Шаг 1. Создание общего модуля. В целевой базе (куда мы записываем данные) создадим или используем существующий общий модуль. В свойствах модуля обязательно должны быть установлены флаги: «Сервер», «Внешнее соединение» и «Вызов сервера».
Шаг 2. Написание экспортной процедуры. Напишем процедуру, которая будет принимать простые типы данных (строки, числа, структуры), создавать документ и записывать его локально. Проанализируем пример кода:
// В целевой базе (например, Альфа-Авто) в серверном общем модуле
Функция СоздатьЗаявкуНаРемонтИзВнешнихДанных(ДанныеЗаявки) Экспорт
НоваяЗаявка = Документы.ЗаявкаНаРемонт.СоздатьДокумент();
// Используем режим загрузки, чтобы минимизировать влияние лишних проверок
НоваяЗаявка.ОбменДанными.Загрузка = Истина;
// Заполняем реквизиты из переданной структуры
НоваяЗаявка.Дата = ТекущаяДатаСеанса();
НоваяЗаявка.Организация = Справочники.Организации.НайтиПоКоду(ДанныеЗаявки.КодОрганизации);
НоваяЗаявка.Автомобиль = Справочники.Автомобили.НайтиПоРеквизиту("VIN", ДанныеЗаявки.VIN);
// Вызываем необходимые обработчики, если это нужно
// Документы.ЗаявкаНаРемонт.АвтомобильПриИзменении(НоваяЗаявка);
Попытка
НоваяЗаявка.Записать(РежимЗаписиДокумента.Запись);
Возврат "Документ создан: " + Строка(НоваяЗаявка.Ссылка);
Исключение
Возврат "Ошибка записи: " + ОписаниеОшибки();
КонецПопытки;
КонецФункции
Шаг 3. Вызов из внешней базы. Теперь в нашей самописной конфигурации мы просто вызываем эту функцию через COM-объект, передавая структуру с данными вместо манипулирования самим документом.
// В исходной базе
СтруктураДанных = БазаАльфа.NewObject("Структура");
СтруктураДанных.Вставить("VIN", Объект.Машина.Вин);
СтруктураДанных.Вставить("КодОрганизации", "00001");
Результат = БазаАльфа.Расш1_ОбщийМодульОбмен.СоздатьЗаявкуНаРемонтИзВнешнихДанных(СтруктураДанных);
Сообщить(Результат);
Поскольку в этом случае ДокументОбъект не пересекает границу COM-соединения, а создается и живет целиком внутри целевой базы на сервере, ошибка мутабельности физически не может возникнуть.
Если вы не хотите менять логику вызова, но точно знаете, какая подписка на событие вызывает ошибку, можно воспользоваться механизмом расширений. Рассмотрим, как нейтрализовать обработчик, который мешает записи.
Выясним причину ошибки: в тексте сообщения 1С обычно указывает имя процедуры, на которой произошел сбой (например, ЗаписьЗаявкиНаРемонтПриЗаписи). Если эта процедура находится в модуле без флага «Внешнее соединение», она — наш кандидат на доработку.
Рассмотрим алгоритм действий:
&Вместо.
&Вместо("ЗаписьЗаявкиНаРемонтПриЗаписи")
Процедура Расш1_ЗаписьЗаявкиНаРемонтПриЗаписи(Источник, Отказ)
// Если мы находимся в контексте внешнего соединения, просто ничего не делаем
#Если ВнешнееСоединение Тогда
Возврат;
#Иначе
// В обычном режиме выполняем стандартную логику
ПродолжитьВызов(Источник, Отказ);
#КонецЕсли
КонецПроцедуры
Этот метод позволяет сохранить работоспособность типовой конфигурации для обычных пользователей, при этом полностью игнорируя проблемный код при работе через COM.
Рассмотрим альтернативный вариант подключения. Вместо V83.COMConnector можно использовать V83.Application.
Разберем разницу:
При использовании Application среда выполнения будет полностью идентична работе пользователя в толстом или тонком клиенте. В этом случае вызовы серверных процедур из подписок будут происходить по стандартным правилам взаимодействия клиента и сервера 1С, и платформа сама корректно обработает передачу параметров. Однако у этого способа есть существенные минусы: он работает значительно медленнее и потребляет полноценную клиентскую лицензию.
Проанализируем еще несколько нюансов, которые помогут сделать интеграцию стабильной:
1. Свойство ОбменДанными.Загрузка. Всегда устанавливайте НоваяЗаявка.ОбменДанными.Загрузка = Истина;. Это отключает большинство проверок в модуле объекта (но, как мы выяснили, не отключает подписки). Это хорошая практика при программном создании документов из внешних систем.
2. Проверка флагов модулей. Если вы решили оставить код в исходном виде, убедитесь, что ВСЕ модули, участвующие в цепочке записи (модуль объекта, модули подписок, модули, вызываемые из модулей подписок), имеют установленный флаг «Внешнее соединение». Если хотя бы одно звено цепи не имеет этого флага, 1С попытается сменить контекст и выдаст ошибку мутабельности.
3. Использование простых типов. Старайтесь никогда не передавать ссылки (СправочникСсылка, ДокументСсылка) или объекты через границу COM. Лучше передавать уникальные идентификаторы (GUID), коды или артикулы в виде строк. Это избавит вас от множества проблем с правами доступа и контекстными вызовами.
Подводя итог, мы рекомендуем использовать Способ №1 (Серверная обертка) как наиболее стабильный и производительный. Он позволяет полностью изолировать логику целевой базы от вызывающей стороны, что значительно упрощает отладку и поддержку системы.