Как подключить внешнюю компоненту в 1С

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

Выбор способа зависит от формата компоненты. Современные компоненты чаще всего поставляются по технологии Native API и упакованы в ZIP-архив с манифестом — их подключают из макета конфигурации. Старые компоненты в виде COM-объектов требуют регистрации в реестре Windows и подключаются через COMСоединение или создание COM-объекта. Ниже разобраны оба сценария с проверкой результата и разбором типичных сбоев.

Перед началом работы убедитесь, что у вас есть сам файл компоненты из доверенного источника, права на запись в каталог установки (или права администратора для регистрации COM) и доступ к конфигуратору, если компонента будет встраиваться в макет. Работу лучше проверять сначала на тестовой базе.

Определяем тип компоненты и требования

Первый шаг — понять, что именно у вас в руках. Компонента Native API обычно поставляется в виде ZIP-архива, внутри которого лежат файлы DLL для разных платформ (Windows x86, x64, иногда Linux) и файл манифеста manifest.xml. COM-компонента — это одиночная DLL или OCX-файл без манифеста, которую регистрируют в системе.

Критичный параметр — разрядность. 32-битная компонента не загрузится в 64-битном клиенте 1С и наоборот. Если используется тонкий или толстый клиент x86-64, нужна 64-битная версия библиотеки. Проверить разрядность клиента можно в окне «О программе» или через системную информацию.

Также заранее уточните, где компонента будет использоваться: на клиенте или на сервере. Для серверного вызова библиотека должна быть доступна на сервере 1С:Предприятия, а для кластера под Linux — собрана именно под Linux. Это частая причина ситуации «на клиенте работает, на сервере нет».

Подключение компоненты Native API из макета

Штатный и рекомендуемый способ для управляемых конфигураций — поместить ZIP-архив компоненты в макет типа «Двоичные данные» и подключать его программно. Так компонента хранится внутри информационной базы, обновляется вместе с конфигурацией и не требует ручной установки на каждое рабочее место.

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

Если Не ПодключитьВнешнююКомпоненту("ОбщийМакет.СканерШтрихкода", "Scanner", ТипВнешнейКомпоненты.Native) Тогда
ВызватьИсключение "Не удалось подключить компоненту сканера";
КонецЕсли;

Сканер = Новый("AddIn.Scanner.Driver");

Обратите внимание на второй параметр — это символьное имя компоненты, а при создании объекта используется связка «AddIn.ИмяКомпоненты.ProgID». Имя и ProgID должны точно совпадать с тем, что указано в манифесте компоненты, иначе объект не создастся, хотя подключение может пройти успешно.

1. 1
   Создайте общий макет типа «Двоичные данные» и загрузите ZIP компоненты
2. 2
   Обновите конфигурацию базы данных
3. 3
   Вызовите ПодключитьВнешнююКомпоненту с указанием макета и типа Native
4. 4
   Создайте объект через Новый("AddIn.Имя.ProgID")
5. 5
   Вызовите тестовый метод компоненты и проверьте результат

Подключение компоненты из файла на диске

Если компонента не встроена в конфигурацию, её можно подключить напрямую из файла. Для Native API указывается путь к ZIP-архиву, для отдельных DLL — путь к файлу библиотеки. Способ удобен на этапе разработки и отладки, когда архив часто пересобирается.

Учтите ограничение: путь должен быть доступен тому процессу, который выполняет код. Если код выполняется на сервере, путь интерпретируется относительно сервера, а не клиентского компьютера. Поэтому для клиент-серверного режима файловый способ подходит только при гарантированном наличии файла на сервере.

В файловой базе на локальном компьютере достаточно указать путь вида «C:\Components\MyComponent.zip». Проверьте, что у пользователя, под которым работает 1С, есть права на чтение этого каталога, а антивирус не блокирует загрузку библиотеки.

Подключение COM-компоненты через регистрацию в системе

Старые компоненты и библиотеки сторонних поставщиков часто реализованы как COM-объекты. Их подключают в два этапа: регистрация в реестре Windows и создание объекта в коде 1С. Регистрация выполняется один раз на каждом компьютере, где используется компонента.

Для регистрации запустите командную строку от имени администратора и выполните regsvr32 с полным путём к DLL. Для 32-битной библиотеки на 64-битной Windows используйте regsvr32 из каталога SysWOW64, иначе регистрация попадёт не в ту ветку реестра и 1С объект не увидит.

regsvr32 "C:\Components\MyLibrary.dll"

После регистрации объект создаётся в коде по его программному идентификатору: Новый COMОбъект("Vendor.Library"). Узнать ProgID можно из документации поставщика или из реестра. Если регистрация прошла успешно, но объект не создаётся — почти всегда проблема в несовпадении разрядности клиента 1С и библиотеки.

Проверка результата и типичные ошибки

Подключение следует считать завершённым только после тестового вызова. Успешный возврат Истина от ПодключитьВнешнююКомпоненту означает лишь загрузку библиотеки — но объект может не создаться из-за неверного ProgID, а метод — вернуть ошибку из-за отсутствия лицензии или оборудования.

Практический минимум проверки: создать объект, вызвать метод получения версии компоненты (он есть почти у всех драйверов) и убедиться, что возвращается осмысленное значение, а не исключение. Только после этого передавайте компоненту в рабочий код.

Ограничения и безопасность

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

Учтите ограничения клиентов: в веб-клиенте COM-объекты не работают, а Native API компоненты требуют специальной сборки под браузер и работают не во всех обозревателях. Для тонкого клиента на Linux нужна Linux-сборка библиотеки. Если компонента критична для бизнес-процесса, продумайте поведение системы при её недоступности — например, ручной ввод штрих-кода вместо сканирования.

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