Как установить 1С коннектор: полная инструкция

1С коннектор (COM-коннектор, объект V83.COMConnector) — это внешняя компонента, которая позволяет сторонним приложениям подключаться к информационным базам 1С и выполнять в них код. С её помощью сайты, скрипты, учётные системы и службы обмена получают доступ к данным 1С без запуска полноценного клиента. Компонента поставляется вместе с платформой 1С:Предприятие, но для работы её нужно правильно установить и зарегистрировать в операционной системе.

Чаще всего коннектор требуется в трёх сценариях: интеграция сайта с 1С, фоновая выгрузка данных скриптами на PowerShell, Python или C#, а также связь двух баз 1С между собой. Во всех случаях последовательность действий схожа, но есть нюансы, зависящие от разрядности системы, версии платформы и типа информационной базы — файловой или клиент-серверной. Ниже разобраны все варианты установки, проверка результата и типичные ошибки.

Что нужно подготовить перед установкой

Перед началом работ убедитесь, что у вас есть дистрибутив технологической платформы 1С:Предприятие той же версии, под которой работает информационная база. Коннектор версии 8.3.22, как правило, подключается к базам на платформе 8.3.22 и совместимых, но смешение сильно различающихся релизов может приводить к ошибкам. Узнать версию платформы базы можно в конфигураторе: меню «Справка» — «О программе».

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

Установка платформы с компонентом внешнего соединения

Запустите установщик платформы 1С:Предприятие (setup.exe из дистрибутива). Если платформа уже установлена, выберите режим «Изменить» — переустанавливать всё не нужно. На шаге выбора компонентов раскройте список и обязательно отметьте пункт «Внешнее соединение» (в некоторых версиях он называется «COM-соединение» или «1С:Предприятие — внешнее соединение»). Именно этот компонент содержит файл comcntr.dll — сам коннектор.

Дождитесь завершения установки. По умолчанию библиотека размещается в каталоге bin установленной версии платформы, например: C:\Program Files\1cv8\8.3.22.XXXX\bin\comcntr.dll. Путь зависит от версии платформы и разрядности — для 32-разрядной платформы на 64-разрядной Windows это будет C:\Program Files (x86)\1cv8\....

Регистрация comcntr.dll вручную

Если коннектор не был зарегистрирован автоматически при установке, выполните регистрацию вручную. Откройте командную строку от имени администратора и выполните команду regsvr32 с полным путём к библиотеке нужной версии платформы.

regsvr32 "C:\Program Files\1cv8\8.3.22.XXXX\bin\comcntr.dll"

После выполнения должно появиться сообщение «DllRegisterServer ... выполнено успешно». Если вместо этого появилась ошибка, проверьте три вещи: запущена ли командная строка от имени администратора, правильно ли указан путь и существует ли файл, не блокирует ли антивирус регистрацию компоненты.

Если на компьютере установлено несколько версий платформы, регистрируйте библиотеку той версии, которая соответствует рабочей базе. Повторная регистрация другой версии перезапишет привязку ProgID V83.COMConnector — это допустимо, но все приложения, использующие коннектор, начнут работать через новую версию.

Настройка подключения к базе

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

Файловая база

Строка соединения имеет вид: File="D:\Bases\Trade";Usr="Администратор";Pwd="пароль". Учтите, что при подключении через коннектор выполняется монопольный захват файловой базы, если в параметрах не указано иное — при активных сеансах пользователей подключение может завершиться ошибкой. Для регулярных обменов с файловой базой надёжнее использовать веб-сервисы или планировать обмен вне рабочего времени.

Клиент-серверная база

Строка соединения: Srvr="server1c";Ref="trade_base";Usr="обмен";Pwd="пароль". В этом случае коннектор обращается к кластеру серверов 1С, и монопольный режим не требуется — подключение работает параллельно с сеансами пользователей. Для обмена рекомендуется завести отдельного пользователя с минимально необходимыми правами, а не использовать учётную запись администратора.

Проверка работоспособности коннектора

Простейший способ проверить установку — выполнить тестовый скрипт, который создаёт COM-объект и открывает соединение. Подойдёт PowerShell или VBScript. Если объект создаётся и метод Connect возвращает соединение без исключений — коннектор установлен и зарегистрирован корректно.

$connector = New-Object -ComObject V83.COMConnector
$conn = $connector.Connect('File="D:\Bases\Trade";Usr="Администратор";Pwd=""')
Write-Host $conn.Конфигурация().Синоним

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

Установка коннектора на Linux

На Linux COM-технология недоступна, поэтому классический V83.COMConnector там не работает. Для интеграций на Linux-серверах используются альтернативы: публикация HTTP-сервисов и веб-сервисов 1С через веб-сервер (Apache), расширение протокола OData, которое платформа предоставляет из коробки, либо сторонние библиотеки, реализующие протокол обращения к 1С. Выбор зависит от задачи: для чтения данных удобен OData, для выполнения произвольной логики — HTTP-сервисы.

Типичные ошибки и их устранение

Большинство проблем при установке и первом подключении сводится к нескольким повторяющимся ситуациям. Ниже — самые частые из них с указанием последствий и способа решения.

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

Частые вопросы