1С: как передать COM-объект с клиента на сервер

Задача передать COM-объект с клиента на сервер возникает у разработчиков 1С при интеграции с внешними системами: Excel, Word, базами через OLE DB, сторонними приложениями через V83.ComConnector. Ключевое ограничение нужно понять сразу: COM-объект — это ссылка на живой экземпляр внешнего приложения в памяти конкретного компьютера, и платформа 1С не умеет сериализовать такие объекты для передачи между клиентским и серверным процессами.

При попытке передать COM-объект параметром в серверный вызов вы получите ошибку вида «Ошибка передачи данных между клиентом и сервером» или «Недопустимый тип параметра». Это не баг конкретной конфигурации, а архитектурное ограничение: клиент и сервер 1С могут работать на разных машинах, и внешний процесс, к которому привязан COM-объект, физически существует только на одном из них.

Правильное решение — не пытаться «протащить» объект через границу клиент–сервер, а перестроить логику: либо создавать и использовать COM-объект целиком на одной стороне, либо передавать между сторонами только данные (строки, структуры, таблицы значений, двоичные данные). Ниже разобраны рабочие варианты и критерии выбора между ними.

Почему COM-объект нельзя передать между клиентом и сервером

Клиент-серверная архитектура 1С предполагает, что при вызове серверной процедуры все параметры сериализуются: преобразуются во внутренний формат, передаются по сети и восстанавливаются на другой стороне. Сериализации подлежат примитивные типы, структуры, массивы, таблицы значений, ссылки на объекты базы данных и ряд других типов платформы.

COM-объект (тип COMОбъект в языке 1С) — это обёртка над указателем на внешний процесс операционной системы. Указатель имеет смысл только в адресном пространстве того компьютера, где объект создан. Даже если бы платформа попыталась передать такой указатель, на сервере он указывал бы на несуществующую память, а само внешнее приложение (например, Excel) на сервере могло бы быть не установлено вовсе.

Дополнительное ограничение — модальность и контекст выполнения. В тонком и веб-клиенте COM-технология вообще недоступна на клиенте: COMОбъект работает только в толстом клиенте Windows. Поэтому код, завязанный на COM, чаще всего намеренно выносят на сервер или в фоновые задания.

Вариант 1: создавать COM-объект на сервере

Самый надёжный подход — перенести всю работу с COM на сервер. Клиент передаёт серверной процедуре только входные данные (путь к файлу, параметры подключения, строку подключения), сервер создаёт COMОбъект, выполняет операции и возвращает результат в сериализуемом виде.

&НаСервере
Функция ПрочитатьДанныеExcel(ПутьКФайлу)
Excel = Новый COMОбъект("Excel.Application");
Excel.Visible = Ложь;
Книга = Excel.Workbooks.Open(ПутьКФайлу);
Лист = Книга.Sheets(1);
Результат = Новый Массив;
Для Строка = 1 По Лист.UsedRange.Rows.Count Цикл
Результат.Добавить(Лист.Cells(Строка, 1).Value);
КонецЦикла;
Книга.Close(Ложь);
Excel.Quit();
Возврат Результат;
КонецФункции

Обратите внимание на обязательное освобождение: вызов Quit() и завершение всех дочерних объектов. Если этого не сделать, процессы внешнего приложения будут накапливаться на сервере и со временем исчерпают память или дескрипторы — типичная причина «подвисаний» сервера 1С после интеграций с Excel.

Вариант 2: вся работа с COM на клиенте, на сервер — только данные

Если внешнее приложение установлено на компьютерах пользователей (типичный случай с Excel в толстом клиенте), логично оставить COM на клиенте. Клиент читает или записывает данные через COM-объект локально, а на сервер передаёт уже извлечённые значения: массивы, структуры, таблицы значений.

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

&НаКлиенте
Процедура ЗагрузитьНаКлиенте()
Excel = Новый COMОбъект("Excel.Application");
Книга = Excel.Workbooks.Open(ПутьКФайлу);
Данные = Новый Массив;
// ... чтение данных в массив структур ...
Книга.Close(Ложь);
Excel.Quit();
СохранитьДанныеНаСервере(Данные); // передаём только данные
КонецПроцедуры

Вариант 3: передача через файл и временное хранилище

Когда клиенту нужно отдать серверу содержимое файла для обработки COM-объектом на сервере, используется связка «временное хранилище + двоичные данные». Клиент помещает файл в хранилище, сервер извлекает его во временный файл и открывает COM-объектом уже локально на сервере.

1. 1
   На клиенте вызовите НачатьПомещениеФайлаВХранилище или ПоместитьФайл и получите адрес временного хранилища
2. 2
   Передайте адрес хранилища параметром в серверную процедуру
3. 3
   На сервере получите двоичные данные: ПолучитьИзВременногоХранилища(Адрес)
4. 4
   Запишите данные во временный файл на сервере (ПолучитьИмяВременногоФайла)
5. 5
   Откройте файл COM-объектом, обработайте, закройте и удалите временный файл
6. 6
   Верните результат клиенту в сериализуемом виде

Этот способ универсален: он работает и в тонком клиенте, и в веб-клиенте, потому что передача файла в хранилище — штатный механизм платформы, не требующий COM на клиенте. Не забудьте удалять временные файлы на сервере после обработки, иначе каталог временных файлов сервера будет расти.

Вариант 4: замена COM на альтернативные механизмы

Часто задача «передать COM-объект» на самом деле означает «обработать файл Excel/Word на сервере». Для этого COM может вообще не понадобиться:

• ТабличныйДокумент.Прочитать() — платформа умеет читать файлы xlsx и mxl без установленного Excel, прямо на сервере;
• Формат Open XML — разбор xlsx как zip-архива с XML через ЧтениеXML, работает в любом клиенте и на Linux-сервере;
• Внешние компоненты (Native API) — подключаются и на клиенте, и на сервере, передаются между ними не компоненты, а их результаты;
• HTTP и веб-сервисы — вместо COM-подключения к другой базе 1С используйте публикацию HTTP-сервисов или стандартный V83.ComConnector только на сервере.

Подключение к другой базе 1С через COM: где выполнять

Отдельный частый случай — COMObject("V83.COMConnector") для подключения к другой информационной базе. Здесь действует то же правило: объект подключения нельзя вернуть с сервера на клиент или наоборот. Каждая сторона, которой нужно подключение, создаёт его сама.

Рекомендуемая практика — выполнять COM-подключения к внешним базам только на сервере, желательно в фоновом задании. Тогда обмен не блокирует интерфейс пользователя, а строка подключения и пароль не попадают в клиентский код, где их легко извлечь.

&НаСервере
Функция ПолучитьДанныеИзВнешнейБазы(СтрокаПодключения)
    Коннектор = Новый COMОбъект("V83.COMConnector");
    Соединение = Коннектор.Connect(СтрокаПодключения);
    Запрос = Соединение.NewObject("Запрос");
    // ... выполнение запроса, выгрузка в таблицу значений ...
    Возврат РезультатТЗ; // передаём только данные
КонецФункции

Типичные ошибки и как их диагностировать

Первая ошибка — попытка вернуть COMОбъект из серверной функции. Платформа выдаст ошибку сериализации ещё на этапе вызова. Признак: сообщение о недопустимом типе параметра или значении возврата. Решение — возвращать данные, а не объект.

Вторая ошибка — создание COM-объекта в общем модуле с флагами «Клиент» и «Сервер» без разделения контекста. Код компилируется, но падает в тонком клиенте. Используйте директивы #Если ТолстыйКлиентОбычноеПриложение или явно разделяйте модули.

Третья ошибка — утечка процессов: Excel.Quit() не вызывается при исключении. Оборачивайте работу с COM в Попытка/Исключение с гарантированным завершением в блоке, который выполнится всегда, либо явно освобождайте объект в обработчике исключения.

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

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

FAQ