COM-соединение 1С: V83.COMConnector, регистрация comcntr.dll и примеры
COM-соединение — самый прямой способ добраться до данных базы 1С из другой базы или внешнего скрипта на Windows: без веб-сервера и публикации. Ниже — чем внешнее соединение отличается от COM-сервера, как зарегистрировать comcntr.dll, как составить строку подключения и выполнить запрос из 1С, Python и PowerShell, а также что делать с ошибками регистрации и версий.

COM-соединение и COM-сервер: в чём разница
На Windows 1С:Предприятие 8.3 даёт внешним программам два COM-объекта, и их часто путают:
| COM-соединение (внешнее соединение) | COM-сервер Automation | |
|---|---|---|
| ProgID | V83.COMConnector | V83.Application |
| Библиотека / программа | comcntr.dll из каталога bin платформы | Клиентское приложение 1cv8.exe |
| Интерфейс пользователя | Нет, работает в фоне | Запускается полноценный клиент, окно можно показать |
| Что доступно | Серверный контекст: справочники, документы, запросы, общие модули с флажком «Внешнее соединение» | Контекст клиентского приложения |
| Как регистрируется | regsvr32 comcntr.dll | 1cv8.exe /regserver |
Для обмена данными, выгрузок и скриптов почти всегда нужен V83.COMConnector: он быстрее, не требует интерфейса и подходит для работы по расписанию. Дальше речь о нём. COM — технология Windows, на сервере 1С под Linux этот способ недоступен; там используйте HTTP-сервисы и REST.
Регистрация comcntr.dll
Иногда компонента уже зарегистрирована после установки платформы, но на практике регистрацию приходится выполнять вручную: после установки новой версии платформы, при нескольких версиях на одной машине или если компонента зарегистрирована не той разрядности. Командная строка запускается от имени администратора:
rem 64-разрядная платформа на 64-разрядной Windows
regsvr32 "C:\Program Files\1cv8\8.3.24.1548\bin\comcntr.dll"
rem 32-разрядная платформа на 64-разрядной Windows
C:\Windows\SysWOW64\regsvr32.exe "C:\Program Files (x86)\1cv8\8.3.24.1548\bin\comcntr.dll"
rem отменить регистрацию старой версии
regsvr32 /u "C:\Program Files\1cv8\8.3.22.1709\bin\comcntr.dll"Номер версии в пути подставьте свой. Главное правило — разрядность компоненты должна совпадать с разрядностью процесса, который её создаёт. 64-разрядный Python или PowerShell не увидит 32-разрядную comcntr.dll, и наоборот. Для кода 1С, выполняемого на сервере, важна разрядность сервера 1С; для кода на клиенте — разрядность клиента.
Одновременно зарегистрированной под ProgID V83.COMConnector может быть только одна версия компоненты каждой разрядности. Если на сервере стоят несколько релизов, регистрируйте ту, что совпадает с версией сервера 1С, к которому подключаетесь.
Строка соединения
Метод Connect принимает строку соединения того же вида, что и в списке баз:
| Параметр | Значение | Пример |
|---|---|---|
File | Каталог файловой базы | File="D:\Bases\Trade"; |
Srvr | Сервер 1С; если кластер работает на нестандартном порту менеджера — с портом | Srvr="srv1c"; или Srvr="srv1c:1641"; |
Ref | Имя информационной базы в кластере | Ref="trade"; |
Usr | Имя пользователя 1С | Usr="Обмен"; |
Pwd | Пароль | Pwd="secret"; |
Для клиент-серверной базы указываются Srvr и Ref, для файловой — File. Значения заключаются в двойные кавычки; в коде 1С их удваивают. Заведите для интеграции отдельного пользователя с нужной ролью и не используйте учётную запись администратора.
Подключение к другой базе из 1С
Из встроенного языка COM-объект создаётся конструктором Новый COMОбъект. Код должен выполняться там, где зарегистрирована компонента: на сервере 1С (для клиент-серверного варианта) или на клиентской машине.
&НаСервереБезКонтекста
Функция ОстаткиИзДругойБазы()
Коннектор = Новый COMОбъект("V83.COMConnector");
База = Коннектор.Connect("Srvr=""srv1c"";Ref=""trade"";Usr=""Обмен"";Pwd=""secret"";");
Запрос = База.NewObject("Запрос");
Запрос.Текст =
"ВЫБРАТЬ
| Т.Номенклатура.Код КАК Код,
| Т.Номенклатура.Наименование КАК Наименование,
| Т.КоличествоОстаток КАК Количество
|ИЗ
| РегистрНакопления.ТоварыНаСкладах.Остатки КАК Т";
Результат = Новый ТаблицаЗначений;
Результат.Колонки.Добавить("Код");
Результат.Колонки.Добавить("Наименование");
Результат.Колонки.Добавить("Количество");
Выборка = Запрос.Выполнить().Выбрать();
Пока Выборка.Следующий() Цикл
Строка = Результат.Добавить();
Строка.Код = Выборка.Код;
Строка.Наименование = Выборка.Наименование;
Строка.Количество = Выборка.Количество;
КонецЦикла;
Выборка = Неопределено;
Запрос = Неопределено;
База = Неопределено;
Возврат Результат;
КонецФункцииЧто важно понимать при работе с внешним соединением:
- Объекты удалённой базы приходят как COM-объекты, а не как значения вашей базы. Примитивные типы (строка, число, дата, булево) копируются нормально, ссылки — нет. Переносите идентификатор ссылки строкой:
База.String(Ссылка.УникальныйИдентификатор()), а в своей базе ищите объект по нему. - Новые объекты удалённого контекста (запрос, структура, массив) создаются через
База.NewObject("Запрос"), а не черезНовый. - Из внешнего соединения доступны общие модули, у которых установлен флажок «Внешнее соединение». Их экспортные функции вызываются как
База.ИмяОбщегоМодуля.ИмяФункции(...)— так удобно прятать сложную логику на стороне приёмника и передавать только примитивы. - Соединение закрывается, когда освобождены все ссылки на COM-объекты. Обнуляйте переменные, иначе сеанс останется висеть в консоли кластера.
- Внешнее соединение — обычный сеанс информационной базы: оно видно в списке сеансов и учитывается при лицензировании так же, как другие подключения.
Запись данных в другую базу
Через внешнее соединение можно не только читать, но и создавать или изменять объекты приёмника. Ниже — перенос элемента номенклатуры с сохранением уникального идентификатора, чтобы при повторном запуске элемент находился, а не дублировался:
// Процедура серверного общего модуля
Процедура ПеренестиНоменклатуру(Ссылка, База)
СтрокаGUID = Строка(Ссылка.УникальныйИдентификатор());
GUID = База.NewObject("УникальныйИдентификатор", СтрокаGUID);
СсылкаПриемника = База.Справочники.Номенклатура.ПолучитьСсылку(GUID);
Объект = СсылкаПриемника.ПолучитьОбъект();
Если Объект = Неопределено Тогда
Объект = База.Справочники.Номенклатура.СоздатьЭлемент();
Объект.УстановитьСсылкуНового(СсылкаПриемника);
КонецЕсли;
Объект.Код = Ссылка.Код;
Объект.Наименование = Ссылка.Наименование;
Объект.ОбменДанными.Загрузка = Истина;
Объект.Записать();
КонецПроцедурыФлаг ОбменДанными.Загрузка отключает проверки и подписки на события в приёмнике — используйте его осознанно, только когда переносите уже проверенные данные. Реквизиты ссылочных типов так просто не присвоить: значение из вашей базы для приёмника чужое, поэтому для каждого такого реквизита сначала найдите или создайте соответствующий объект в приёмнике и присвойте уже его ссылку.
Каждое обращение к свойству удалённого объекта — это вызов через COM, поэтому тысячи мелких обращений в цикле работают медленно. Для массовых операций выгоднее собрать данные одним запросом на стороне источника и передать их в экспортную функцию общего модуля приёмника (с флажком «Внешнее соединение») строкой, например в JSON, а разбор и запись выполнить уже внутри приёмника.
На COM-соединении строятся и онлайн-обмены: например, универсальная обработка обмена данными XML умеет загружать данные в приёмник напрямую через COM, без файла.
Подключение из внешнего кода
Python
Нужен пакет pywin32 (pip install pywin32) и Python той же разрядности, что и зарегистрированная компонента. Кириллические имена свойств удобнее получать через getattr:
import win32com.client
connector = win32com.client.Dispatch("V83.COMConnector")
db = connector.Connect('Srvr="srv1c";Ref="trade";Usr="Обмен";Pwd="secret";')
query = db.NewObject("Запрос")
setattr(query, "Текст", """
ВЫБРАТЬ ПЕРВЫЕ 10
Н.Код КАК Код,
Н.Наименование КАК Наименование
ИЗ
Справочник.Номенклатура КАК Н
""")
selection = getattr(getattr(query, "Выполнить")(), "Выбрать")()
while getattr(selection, "Следующий")():
print(getattr(selection, "Код"), getattr(selection, "Наименование"))
selection = query = db = NonePowerShell
В Windows PowerShell 5.1 сохраните скрипт в UTF-8 с BOM, иначе кириллица в тексте запроса прочитается неверно. Разрядность консоли тоже имеет значение: 32-разрядный PowerShell находится в C:\Windows\SysWOW64\WindowsPowerShell\v1.0\.
$connector = New-Object -ComObject V83.COMConnector
$db = $connector.Connect('File="D:\Bases\Trade";Usr="Обмен";Pwd="secret";')
$query = $db.NewObject("Запрос")
$query.Текст = "ВЫБРАТЬ ПЕРВЫЕ 10 Н.Код КАК Код, Н.Наименование КАК Наименование ИЗ Справочник.Номенклатура КАК Н"
$selection = $query.Выполнить().Выбрать()
while ($selection.Следующий()) {
"{0}`t{1}" -f $selection.Код, $selection.Наименование
}
$selection = $null; $query = $null; $db = $null
[GC]::Collect()Вызов [GC]::Collect() в конце помогает быстрее освободить COM-объекты и закрыть сеанс 1С.
COM-сервер V83.Application
Если нужна именно клиентская часть — например, открыть форму или управлять интерфейсом из внешней программы, — используется COM-сервер Automation. Он регистрируется командой 1cv8.exe /regserver (из каталога bin нужной версии, от имени администратора) и подключается тем же методом Connect:
App = Новый COMОбъект("V83.Application");
App.Connect("File=""D:\Bases\Trade"";Usr=""Обмен"";Pwd=""secret"";");
App.Visible = Ложь;
// ... работа с контекстом клиентского приложения
App = Неопределено;Он заметно тяжелее внешнего соединения, так как запускает целый клиент, поэтому для фоновых задач его не применяют.
Типичные ошибки
| Ошибка | Причина и решение |
|---|---|
| «Недопустимая строка с указанием класса» / Invalid class string | Компонента не зарегистрирована или зарегистрирована другой разрядности. Выполните regsvr32 для нужной версии |
| Ошибка несоответствия версий при подключении к серверу | Версия comcntr.dll отличается от версии сервера 1С. Зарегистрируйте компоненту из каталога той же версии, что и сервер |
| Работает из консоли, но не из службы или планировщика | Служба запущена под пользователем без прав на каталог платформы или базы, либо в другой разрядности. Проверьте учётную запись и путь к интерпретатору |
| Сеансы «висят» после выполнения скрипта | Не освобождены COM-объекты. Обнуляйте все переменные, полученные из соединения |
| Ошибка идентификации пользователя | Проверьте Usr/Pwd и экранирование кавычек в строке соединения |
| Нет доступа к общему модулю | У модуля не установлен флажок «Внешнее соединение» |
Если компонента после обновления платформы ведёт себя непредсказуемо, отмените регистрацию всех старых версий (regsvr32 /u) и зарегистрируйте одну актуальную. В крупных инсталляциях администраторы иногда оформляют COMConnector как приложение COM+ через оснастку «Службы компонентов», чтобы задать учётную запись запуска; это не обязательный шаг и делается только при необходимости.
Когда COM-соединение — не лучший выбор
COM-соединение удобно внутри одной локальной сети и на Windows-серверах, но у него есть ограничения. Оно требует прямого сетевого доступа к серверу 1С (портам агента, менеджера кластера и рабочих процессов), не работает через интернет без VPN, зависит от версии платформы на обеих сторонах и не подходит для серверов на Linux. Если базы находятся в разных офисах, обмен идёт с сайтом или внешним сервисом либо платформа на сервере регулярно обновляется — стабильнее работать через веб-публикацию: HTTP-сервисы и REST, стандартный интерфейс OData или веб-сервисы. Для регулярной синхронизации между базами 1С также подойдёт план обмена с передачей сообщений через файлы.
Актуальность для новых версий
В ветке 8.3 COM-соединение работает через ProgID V83.COMConnector, а COM-сервер — через V83.Application; это технология только для Windows. Компоненту comcntr.dll нужно регистрировать заново при смене версии платформы, а её версия должна совпадать с версией сервера 1С. Пути в примерах указаны для установки по умолчанию — подставьте свой номер релиза.
Частые вопросы
Как зарегистрировать comcntr.dll?
Откройте командную строку от имени администратора и выполните regsvr32 с полным путём к comcntr.dll в каталоге bin нужной версии платформы. Для 32-разрядной платформы на 64-разрядной Windows используйте regsvr32 из каталога SysWOW64.
Чем V83.COMConnector отличается от V83.Application?
V83.COMConnector создаёт внешнее соединение без интерфейса и даёт серверный контекст базы — для обменов и скриптов. V83.Application запускает полноценный клиент 1С как COM-сервер Automation и нужен, только если требуется клиентский контекст.
Почему возникает ошибка «Недопустимая строка с указанием класса»?
Компонента не зарегистрирована или разрядность программы не совпадает с разрядностью зарегистрированной comcntr.dll. Зарегистрируйте компоненту нужной разрядности или запустите скрипт в интерпретаторе той же разрядности.
Можно ли использовать COM-соединение на Linux?
Нет, COM — технология Windows. Для серверов 1С на Linux используйте HTTP-сервисы, стандартный интерфейс OData или веб-сервисы.
Как передать ссылку из одной базы в другую через COM?
Ссылку напрямую передать нельзя. Передайте строкой её уникальный идентификатор или код, а в принимающей базе найдите объект по этому значению.