Установка внешней компоненты в 1С 8.3: что это и как подключить

Внешняя компонента 1С — это отдельный подключаемый модуль (обычно файл .dll/.so или архив с ним), который добавляет платформе то, чего в ней нет из коробки: работу со сканером, весами, фискальным регистратором, электронной подписью, отправку в мессенджеры. Установка внешней компоненты — это её загрузка в базу и подключение к сеансу, чтобы конфигурация смогла вызывать методы модуля.

Что это за зверь, какие бывают компоненты, как их поставить в файловой и клиент-серверной базе и что делать, когда компонента упорно не подключается — по порядку ниже.

Что такое внешняя компонента и зачем она нужна

Платформа 1С:Предприятие 8.3 умеет многое, но не всё. Когда нужна работа с «железом» или сторонним протоколом, разработчик пишет модуль на C++ (реже — через COM) и оформляет его как внешнюю компоненту (ВК).

Типичные задачи, которые закрывают ВК:

• 🖨 обмен с оборудованием — сканеры штрихкодов, весы, ТСД, фискальники;
• 🔐 криптография и электронная подпись (например, работа с КриптоПро);
• 💬 отправка сообщений в Telegram, WhatsApp и другие мессенджеры;
• 🌐 нестандартные обмены и интеграции по своим протоколам;
• ⚙️ ускорение тяжёлых вычислений, которые на встроенном языке медленные.

Проще говоря: ВК — это «переходник» между 1С и тем, с чем она сама общаться не умеет.

Native и COM: какие бывают внешние компоненты

Технологий подключения две, и путать их не стоит — от типа зависит и способ установки, и разрядность.

💡 Если выбираете между двумя версиями одной компоненты — берите Native. COM не заработает ни в веб-клиенте, ни под Linux-сервером.

Ещё одно важное деление — откуда берётся компонента:

• из макета конфигурации — разработчик уже положил ВК внутрь базы, её только надо установить и подключить кодом;
• из внешнего файла (архива) — вам прислали .zip, и его нужно скормить платформе вручную или обработкой.

Как установить внешнюю компоненту: пошагово

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

Если у вас есть архив с компонентой

Когда ВК уже лежит в файле, установка идёт через методы платформы. В коде обработки это обычно выглядит так:

УстановитьВнешнююКомпоненту("c:\vk\component.zip");
ПодключитьВнешнююКомпоненту("c:\vk\component.zip",
    "МояКомпонента", ТипВнешнейКомпоненты.Native);

Пути и имена — латиницей, как в манифесте. После УстановитьВнешнююКомпоненту файлы копируются в системный каталог пользователя, и распаковывать архив руками не надо.

Если компонента лежит в макете конфигурации

Здесь файла на диске нет — ВК хранится внутри базы как макет. Подключение делают из адреса макета:

Адрес = ПоместитьВоВременноеХранилище(
    ПолучитьОбщийМакет("МояКомпонента").ПолучитьДвоичныеДанные());
ПодключитьВнешнююКомпоненту(Адрес, "МояКомпонента",
    ТипВнешнейКомпоненты.Native);

Такой вариант удобнее в клиент-серверной базе: компонента едет вместе с конфигурацией и не требует ручной установки на каждом рабочем месте.

«Предложение об установке внешних компонент» — что это за окно

Когда обработка впервые ставит ВК, платформа показывает диалог-предупреждение: приложение запрашивает разрешение на установку внешней компоненты.

Это штатная защита. Платформа не ставит сторонний код молча — она спрашивает пользователя.

• Нажали Да — компонента установится и запомнится.
• Нажали Нет — установка отменится, и обработка выдаст ошибку подключения.

⚠️ Если окно не появляется, а установка всё равно падает — скорее всего, у пользователя нет прав на запись в системный каталог. Запустите 1С от администратора один раз, чтобы поставить компоненту.

Особенности: файловая и клиент-серверная база

Способ один, но нюансы разные.

• Файловая база. Компонента ставится на той машине, где открыта 1С. Каждое рабочее место — своя установка. Права на запись в профиль пользователя обязательны.
• Клиент-серверная база. Если ВК вызывается на сервере (&НаСервере), она должна быть установлена на сервере 1С под учёткой службы USR1CV8. Клиентские вызовы — на клиенте. Часто нужна установка в обоих местах.

Перед установкой компоненты на боевой сервер сделайте резервную копию и протестируйте на копии базы.

Почему внешняя компонента не подключается

Самая частая боль — компонента установилась, а ПодключитьВнешнююКомпоненту возвращает Ложь. Разберём симптомы.

Частые ошибки и как их избежать

Даже опытные спотыкаются на одном и том же:

• ❌ Распаковали архив вручную и подсунули .dll напрямую. Платформе нужен архив с манифестом — отдавайте .zip целиком.
• ❌ Смешали разрядность. 64-битный сервер + 32-битная ВК = молчаливый отказ. Держите всё в одной разрядности.
• ❌ Забыли про клиент-серверную специфику. Поставили на клиенте, а вызов идёт на сервере.
• ❌ Ставят под пользователем без прав. Первую установку иногда нужно провести от администратора.
• ❌ Оставили COM в веб-клиенте. COM-компонента там не заработает никогда — только Native.

💡 После обновления платформы 1С проверьте, что ВК осталась подключённой. Крупные обновления иногда сбрасывают путь к компоненте, и её приходится ставить заново.

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