1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | ВнешниеКомпоненты |
| Полное имя | Справочник.ВнешниеКомпоненты (Catalogs.ВнешниеКомпоненты) |
| Синоним | — (отдельный синоним не задан; в интерфейсе используется наименование раздела «Внешние компоненты») |
| Конфигурация | Бухгалтерия для Казахстана, редакция 3.0, версия 3.0.74.2 |
| Происхождение | Служебный справочник подсистемы БСП «Подключаемые компоненты» (СтандартныеПодсистемы.ПодключаемыеКомпоненты) |
| Назначение | Централизованное хранение и версионный контроль внешних компонент (ActiveX/COM, .dll/.so, Native API, плагины браузеров), необходимых для работы функций конфигурации, зависящих от native-кода: криптография и ЭЦП, обмен с ИС ЭСФ и СНТ, работа с периферией (сканеры, ККМ, весы), специализированные механизмы формирования отчётности. Обеспечивает автоматическое обновление с Портала 1С:ИТС и контроль совместимости с клиентскими платформами и браузерами. |
Где найти в 1С: раздел «Администрирование» / «Стандартные подсистемы» → «Обслуживание» → «Внешние компоненты».
Навигационная ссылка: e1cib/list/Справочник.ВнешниеКомпоненты
Это служебный (технический) справочник. Он не участвует в бухгалтерском и налоговом учёте, не формирует проводок и движений по регистрам учёта. Ставки налогов, план счетов и электронные документы РК к данному объекту напрямую не относятся — он лишь обеспечивает работоспособность механизмов, которые их используют (например, подключение криптобиблиотеки для подписания ЭСФ/СНТ).
2. Реквизиты шапки и табличные части
2.1 Реквизиты шапки
| Имя | Тип | Обязательность | Назначение |
|---|---|---|---|
Использование |
Перечисление.ВариантыИспользованияВнешнихКомпонент |
Заполнять (ShowError) | Статус активности: используется / отключена. Критичен для автоматической деактивации старых версий. |
Идентификатор |
Строка | Заполнять (ShowError) | Уникальный программный идентификатор компоненты (GUID или строковое имя). Основной ключ поиска и управления версиями. |
Версия |
Строка | Заполнять (ShowError) | Номер версии (например, 1.2.3.45). Используется для версионного контроля и определения актуальности. |
ДатаВерсии |
ДатаВремя | Не проверять | Дата выпуска версии; определяет, какая версия является последней. |
ИмяФайла |
Строка | Не проверять | Исходное имя файла компоненты при загрузке (например, component.dll). Для отображения и обратного сохранения в файл. |
ХранилищеКомпоненты |
ХранилищеЗначения | Не проверять | Двоичное хранилище файла компоненты (бинарные данные библиотеки для установки на клиентские места). |
ОбновлятьСПортала1СИТС |
Булево | Не проверять | Флаг автообновления с Портала 1С:ИТС. При установке активирует логику деактивации младших версий. |
ОписаниеОшибки |
Строка | Не проверять | Текст последней ошибки загрузки/установки. Для диагностики проблем совместимости. |
2.2 Реквизиты совместимости (флаги платформ и браузеров)
Группа булевых реквизитов, описывающих, для каких клиентских окружений пригодна данная версия компоненты. Заполняются автоматически при загрузке из манифеста компоненты.
| Имя | Назначение |
|---|---|
Windows_x86 |
Windows 32-бит (тонкий/толстый клиент). |
Windows_x86_64 |
Windows 64-бит (тонкий/толстый клиент). |
Linux_x86 |
Linux 32-бит (тонкий клиент). |
Linux_x86_64 |
Linux 64-бит (тонкий клиент). |
Windows_x86_Firefox / Linux_x86_Firefox / Linux_x86_64_Firefox |
Веб-клиент Firefox (NPAPI-плагин) на соответствующих платформах. |
Windows_x86_MSIE / Windows_x86_64_MSIE |
Веб-клиент Internet Explorer на Windows. |
Windows_x86_Chrome / Linux_x86_Chrome |
Веб-клиент Chrome (Native Messaging / WebAssembly) на соответствующих платформах. |
Реквизит
Windows_x86_64_MSIEв evidence присутствует; часть флагов (macOS, дополнительные разрядности браузеров) может отличаться между релизами платформы 1С:Предприятие — требует проверки в конкретной версии, если выполняется программный анализ полного состава флагов.
2.3 Табличные части
Собственных прикладных табличных частей справочник не имеет. Вся информация о поддержке платформ вынесена в реквизиты шапки (см. 2.2). Дополнительно доступны стандартные табличные части реквизитов и, при необходимости, механизм присоединённых файлов БСП.
3. Формы
| Форма | Назначение |
|---|---|
ФормаЭлемента |
Просмотр и редактирование карточки компоненты: идентификатор, версия, дата версии, состав поддерживаемых платформ, флаг обновления с ИТС. Отсюда выполняются загрузка файла компоненты в хранилище и выгрузка обратно в файл. |
ФормаСписка |
Список зарегистрированных компонент с отбором по статусу использования и идентификатору; используется администратором для обзора и обслуживания. |
ФормаВыбора |
Служебный выбор компоненты при программном обращении. |
При отсутствии явно переопределённых форм платформа использует автогенерируемые. Основная работа пользователя ведётся не с карточкой напрямую, а через служебные формы подсистемы БСП (мастер настройки/обновления компонент).
4. Ключевые процедуры модулей
В evidence программные модули (BSL) не приложены, поэтому ниже — типовые обработчики и API данного вида объекта в составе подсистемы БСП «Подключаемые компоненты».
Модуль менеджера справочника / модуль объекта:
ОбработкаЗаполнения— начальная инициализация статусаИспользованиеи флагов совместимости при создании нового элемента.ПередЗаписью— при установленномОбновлятьСПортала1СИТСи признаке актуальной версии выполняется деактивация младших версий той же компоненты (перевод ихИспользованиев «Отключена»), чтобы в работе оставалась одна активная версия по каждомуИдентификатору.ОбработкаПроверкиЗаполнения— контроль обязательных реквизитовИдентификатор,Версия,Использование.
Общие модули подсистемы (ПодключаемыеКомпоненты, ПодключаемыеКомпонентыСлужебный, ПодключаемыеКомпонентыКлиент/Сервер):
- Регистрация компоненты в справочнике по данным манифеста (заполнение
Идентификатор,Версия,ДатаВремя, флагов платформ,ХранилищеКомпоненты). - Подбор подходящей версии под текущее клиентское окружение (тип клиента, ОС, разрядность, браузер) по реквизитам совместимости.
- Подключение компоненты на клиенте (
ПодключитьВнешнююКомпоненту) с записью текста ошибки вОписаниеОшибкипри неудаче. - Обновление компонент с Портала 1С:ИТС по флагу
ОбновлятьСПортала1СИТС.
5. Проведение и движения
Справочник непроводимый и не формирует бухгалтерских проводок и движений по регистрам учёта. Записей по регистрам накопления/бухгалтерии (в т.ч. по типовому плану счетов РК — 1210, 1030, 1330, 3310, 3130, 6010, 7010) он не создаёт.
Косвенное участие в учётных процессах — через обеспечиваемую функциональность: например, подключённая криптокомпонента используется при формировании и подписании электронных документов ЭСФ (ИС ЭСФ) и СНТ; сбои подключения компоненты приводят к невозможности подписать/отправить эти документы. Само же движение по учёту выполняют соответствующие документы конфигурации, а не данный справочник.
6. Связанные объекты и ввод на основании
Перечисление.ВариантыИспользованияВнешнихКомпонент— источник значений реквизитаИспользование.- Подсистема БСП «Подключаемые компоненты» — основной потребитель данных справочника (регистрация, подбор, подключение, обновление).
- Механизмы, использующие native-компоненты: криптография и ЭЦП, обмен с ИС ЭСФ и СНТ, работа с торговым оборудованием/периферией.
- Регламентное/фоновое задание обновления компонент с Портала 1С:ИТС.
Ввод на основании для данного объекта не предусмотрен — записи создаются программно при загрузке/обновлении компонент либо вручную администратором в форме списка.
7. Точки расширения
- Дополнительные реквизиты и сведения (БСП) — для служебной классификации компонент без изменения конфигурации.
- Программный API подсистемы — регистрация и подключение собственных внешних компонент через
ПодключаемыеКомпоненты(интеграция сторонних native-библиотек, например касс/фискальных регистраторов). - Переопределяемые модули подсистемы «Подключаемые компоненты» — точка настройки состава и правил обновления компонент.
- Расширения конфигурации — добавление реквизитов/обработчиков (
ПередЗаписью,ОбработкаПроверкиЗаполнения) без снятия с поддержки. - Присоединённые файлы — при необходимости хранения сопутствующей документации/манифестов рядом с элементом справочника.