Технология внешних компонент 1С: что это и как применять

Технология внешних компонент (ВК) в 1С — это механизм расширения возможностей платформы за счёт подключаемых бинарных модулей, написанных на языках вроде C++ или C#. Через внешние компоненты 1С умеет работать с оборудованием (сканеры штрихкодов, ККТ, электронные весы), выполнять сложные вычисления, обращаться к системным функциям ОС и делать то, что невозможно или неэффективно реализовать на встроенном языке.

Компонент поставляется в виде файла библиотеки — DLL для Windows, SO для Linux, dylib для macOS — и подключается из кода 1С методом ПодключитьВнешнююКомпоненту(). После подключения объект компонента становится доступен в коде как обычный объект с методами, свойствами и событиями.

Типичный пример из практики: драйвер сканера штрихкодов, поставляемый «1С:Библиотека подключаемого оборудования», — это внешняя компонента. Когда кассир сканирует товар, компонента перехватывает данные со сканера и генерирует событие ВнешнееСобытие, которое обрабатывает прикладной код конфигурации.

Зачем нужны внешние компоненты и где они применяются

Встроенный язык 1С закрыт внутри платформы: у него нет прямого доступа к API операционной системы, драйверам устройств и низкоуровневым библиотекам. Внешняя компонента выступает мостом между платформой и внешним миром. Она получает вызовы из кода 1С, выполняет работу на уровне ОС и возвращает результат.

Основные сценарии применения:

• подключение торгового оборудования — сканеры, терминалы сбора данных, фискальные регистраторы, весы, эквайринговые терминалы;
• криптография и электронная подпись — обращение к криптопровайдерам и токенам;
• распознавание и обработка изображений, работа со штрихкодами и QR-кодами на уровне генерации картинок;
• интеграция с внешними системами через нативные SDK, когда веб-сервисов недостаточно;
• ускорение вычислений — математика и обработка больших массивов данных на C++ быстрее интерпретируемого кода.

Две технологии создания компонент: Native API и COM

Платформа 1С поддерживает два стандарта внешних компонент, и выбор между ними определяет, где компонента будет работать.

COM (Component Object Model) — технология Microsoft, доступная только в Windows. Компонент регистрируется в системном реестре, и 1С обращается к нему через COM-интерфейс. Так исторически построено большинство старых драйверов оборудования. Ограничение очевидно: на Linux-сервере или веб-клиенте такая компонента не заработает.

Native API — кроссплатформенная технология от фирмы «1С». Компонент компилируется под каждую целевую платформу (Windows, Linux, macOS, разные разрядности) и упаковывается в ZIP-архив вместе с файлом манифеста MANIFEST.XML, где перечислены все варианты библиотек. Платформа сама выбирает подходящую библиотеку при подключении. Native API не требует регистрации в реестре и работает в том числе на сервере 1С и в веб-клиенте (при наличии расширения для браузера).

Как устроено подключение компоненты в коде 1С

Подключение выполняется встроенным методом. В тонком и толстом клиенте вызов выглядит так:

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

Первый параметр — место хранения компоненты: общий макет конфигурации, справочник (в типовых решениях компоненты часто хранятся в справочнике «Внешние компоненты» БСП) или путь к файлу. Второй — символьное имя, под которым компонента регистрируется в сеансе. Далее через конструктор Новый("AddIn.Имя.Объект") создаётся экземпляр объекта компоненты.

На сервере 1С подключение делается тем же методом, но компонента должна быть Native API и иметь Linux-сборку, если сервер работает под Linux. COM-компоненту на сервере подключить нельзя — это одна из самых частых причин «внезапно переставшего работать» обмена после переноса кода с клиента на сервер.

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

Установка и регистрация на клиентских машинах

Для Native API-компонент в макете установка происходит автоматически: при первом вызове ПодключитьВнешнююКомпоненту платформа извлекает библиотеку из архива в каталог пользователя и загружает её. Права администратора обычно не требуются. Если компонента поставляется отдельным файлом, её нужно положить в каталог, доступный пользователю, и указать полный путь при подключении.

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

regsvr32 "C:\Components\MyDriver.dll"

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

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

Ошибка «Не удалось подключить внешнюю компоненту» без деталей — стандартная ситуация. Метод возвращает только Истина/Ложь, поэтому причины приходится искать последовательно. Чаще всего виноваты: отсутствие нужной разрядности библиотеки в ZIP-архиве, ошибки в MANIFEST.XML, заблокированный антивирусом файл DLL, отсутствие зависимых системных библиотек (например, Visual C++ Redistributable) на машине пользователя.

Полезный приём — подключить компоненту в толстом клиенте на машине разработчика, где виден журнал регистрации и можно проверить загрузку библиотеки системными средствами. На Windows зависимости DLL проверяются утилитами просмотра зависимостей; если какой-то системной библиотеки нет, компонента молча не загрузится.

Разработка собственной компоненты: что нужно знать

Для создания Native API-компоненты фирма «1С» публикует заголовочные файлы и примеры шаблона проекта на C++. Компонент реализует фиксированный набор интерфейсов: инициализация, регистрация методов и свойств, обработка вызовов, передача событий в платформу. Данные между 1С и компонентой передаются через специальную структуру variant, поддерживающую типы 1С: число, строка, булево, дата, двоичные данные.

Альтернатива для тех, кто не работает с C++, — обёртки на .NET через COM: класс на C# помечается атрибутами COM-видимости, регистрируется утилитой regasm и подключается из 1С как обычный COM-объект. Это рабочий путь для Windows-инфраструктуры, но с уже названным ограничением — только Windows и только клиент.

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

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

После подключения убедитесь, что компонента не просто загрузилась, а реально выполняет свою функцию. Для драйверов оборудования это тестовый вызов (например, «Тест устройства» в обработках настройки оборудования), для вычислительных компонент — контрольный расчёт с известным результатом.

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