Внешние компоненты 1С

ОБЯЗАТЕЛЬНОДЛЯ НОВИЧКОВ

Разработчику

---

Назначение

Внешняя компонента — библиотека (.dll, .so), которая расширяет платформу там, где BSL не хватает: ККТ, сканер штрихкода, ТСД, спец. протокол, криптопровайдер.

Технология	Статус
Native API	Рекомендуемая, Windows/Linux/macOS, веб и мобильный клиент
COM	Legacy (8.1 и совместимость); на сервере Linux не используют

Комплект для Native API — четыре файла (Win32/Win64, Linux32/Linux64) + манifest в ZIP; для тонкого и веб-клиента ZIP обязателен.

---

Схема подключения

1. УстановитьВнешнююКомпоненту() — однократно на рабочей станции (тонкий/веб-клиент; из макета или базы, не с диска).
2. ПодключитьВнешнююКомпоненту() — перед каждым использованием в сеансе.
3. Новый("AddIn.<Имя>.<Расширение>") — вызов API компоненты.

Установка и подключение

Не объединяйте установку и подключение в один блок без условия: повторная установка вызывает интерактивное исключение.

---

Откуда брать компоненту

Источник	Тонкий/веб	Толстый/сервер
Файл на диске	Только отдельные .dll/.so	Да
Макет конфигурации (ZIP или файлы)	ZIP + Установить...	Подключить...
ХранилищеЗначения в базе	ZIP + установка	Подключение

Пример с макета:

УстановитьВнешнююКомпоненту("Обработка.Драйвер.Макет.AddIn");
ПодключитьВнешнююКомпоненту("Обработка.Драйвер.Макет.AddIn", "МойДрайвер");
Объект = Новый("AddIn.МойДрайвер.Компонента");

На сервере и в мобильном приложении — только Native API. Веб-клиент — Native API; COM только в IE на Windows (устаревший сценарий).

---

Контекст исполнения

Контекст	Native API	COM
Толстый клиент	Да	Да
Тонкий клиент	Да	Нет
Сервер 1С	Да	Нет
Веб-клиент	Да	Ограниченно (Windows)

Драйвер ККТ на Linux-сервере — Native API на сервере; UI оператора — тонкий клиент с установкой на ПК кассира.

---

Связанные материалы

• Интеграция — хаб
• Automation — другой способ связи с внешним ПО (COM)

---

Проверка себя

• Зачем два шага — установка и подключение?
• Почему на сервере Linux нельзя COM-компоненту Excel?
• Где хранить ZIP-комплект компоненты для веб-клиента?