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
ProgIDV83.COMConnectorV83.Application
Библиотека / программаcomcntr.dll из каталога bin платформыКлиентское приложение 1cv8.exe
Интерфейс пользователяНет, работает в фонеЗапускается полноценный клиент, окно можно показать
Что доступноСерверный контекст: справочники, документы, запросы, общие модули с флажком «Внешнее соединение»Контекст клиентского приложения
Как регистрируетсяregsvr32 comcntr.dll1cv8.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 = None

PowerShell

В 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?

Ссылку напрямую передать нельзя. Передайте строкой её уникальный идентификатор или код, а в принимающей базе найдите объект по этому значению.

Интеграция и веб-сервисы

1С:Конвертация данных 2 и 3: правила обмена и универсальный обмен XML

Чем отличаются Конвертация данных 2 и 3, как разработать правила обмена и выполнить перенос обработкой «Универсальный обмен данными в формате XML», как устроены правила КД 3 и формат EnterpriseData.

Интеграция и веб-сервисы

Как выгрузить УПД в XML из 1С: Бухгалтерия 3.0 и УТ 11

Пошаговая выгрузка УПД в XML по формату ФНС 5.03 из 1С:Бухгалтерии 3.0 и УТ 11 без подключённого ЭДО, что делать с ZIP-архивом, какие реквизиты проверить и как выгрузить документ в XML программно.

Интеграция и веб-сервисы

API 1С: интеграция через HTTP-сервисы, OData и веб-сервисы

Какие API есть у 1С:Предприятия 8.3 и как подключиться к базе: HTTP-сервисы с обработчиками GET и POST, стандартный интерфейс OData, веб-сервисы SOAP, публикация и аутентификация.

Интеграция и веб-сервисы

Веб-сервер 1С: публикация базы на Apache и IIS через Конфигуратор и webinst

Как подготовить Apache или IIS для 1С, опубликовать базу из Конфигуратора или утилитой webinst, настроить default.vrd, права и HTTPS и исправить типичные ошибки публикации.