1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | ВнешниеКомпоненты |
| Полное имя | Справочник.ВнешниеКомпоненты / Catalogs.ВнешниеКомпоненты |
| Синоним | «Внешние компоненты» |
| Конфигурация | Управление торговлей для Казахстана, ред. 3.4.5.21 |
| Подсистема | Стандартные подсистемы (Библиотека стандартных подсистем, БСП) → «Внешние компоненты» |
| Где найти в 1С | Раздел «Стандартные подсистемы» → «Внешние компоненты». Прямая навигационная ссылка: e1cib/list/Справочник.ВнешниеКомпоненты |
Назначение. Служебный справочник, входящий в состав БСП. Хранит внешние компоненты (add-in, native / COM), используемые конфигурацией: файл(ы) компоненты и её метаданные. Компоненты применяются подсистемами работы с торговым оборудованием, криптографией/ЭЦП, обменом с ГИС (ИС ЭСФ, СНТ), сканированием и т. п. Элемент справочника — это «карточка» установленной в информационную базу компоненты, из которой платформа подключает её на клиенте/сервере через ПодключитьВнешнююКомпоненту.
Это технический (сервисный) объект инфраструктуры. Он не является объектом оперативного или регламентированного учёта, не хранит хозяйственных сумм и не участвует в расчёте налогов.
2. Реквизиты шапки и табличные части
Реквизиты шапки
| Реквизит | Тип | Назначение |
|---|---|---|
Код |
Строка | Внутренний код элемента справочника. |
Наименование |
Строка | Представление компоненты для пользователя. |
ИдентификаторОбъекта |
Строка | Программный идентификатор компоненты (имя объекта внутри архива компоненты), по которому выполняется подключение. |
ПолноеНаименование / Назначение |
Строка | Развёрнутое описание назначения компоненты (для какой задачи используется). |
Версия |
Строка | Версия загруженной компоненты (заполняется из манифеста при загрузке). |
ЭтоРасположениеВнешнейКомпонентыВМакете |
Булево | Признак: компонента поставляется в макете конфигурации, а не хранится присоединённым файлом. |
ИмяМакета |
Строка | Имя макета конфигурации, если компонента берётся из макета. |
Удалить* / ПометкаУдаления |
Булево | Служебные/стандартные реквизиты справочника. |
Хранение бинарного содержимого
Файл компоненты (обычно ZIP-архив с манифестом MANIFEST.XML и бинарными файлами под платформы/разрядности) хранится не в реквизите, а через механизм присоединённых файлов БСП. Владельцем файлов выступает подчинённый справочник:
Справочник.ВнешниеКомпонентыПрисоединенныеФайлы— присоединённые файлы конкретной компоненты (двоичные данные в томах/базе), реквизиты:ВладелецФайла,ХранилищеФайла/ссылка на том,Расширение,РазмерФайла,ДатаМодификацииУниверсальная,ВерсияФайлаи др.
Отдельной табличной части с бизнес-данными у справочника нет; при наличии в конкретной версии — используется служебная ТЧ совместимости (перечень поддерживаемых платформ/разрядностей), заполняемая автоматически из манифеста.
3. Формы
| Форма | Назначение |
|---|---|
Форма элемента (ФормаЭлемента) |
Карточка компоненты: наименование, идентификатор объекта, версия, признак «из макета», управление присоединённым файлом (загрузить/заменить/выгрузить). |
Форма списка (ФормаСписка) |
Список зарегистрированных компонент; отсюда выполняются команды загрузки новой компоненты и обновления. |
Форма выбора (ФормаВыбора) |
Подбор компоненты в другие объекты/обработки. |
| Служебные формы БСП | Помощник загрузки/обновления внешней компоненты (проверка манифеста, разрядности, версии) — вызывается из общих модулей подсистемы. |
Если в конкретной поставке отдельные формы не заданы, платформа использует автогенерируемые формы справочника.
4. Ключевые процедуры модулей
Прикладного BSL-evidence по модулям не приложено (в источнике присутствует только фасет «назначение»). Ниже — типовые обработчики и точки логики для этого вида объекта в БСП; конкретные имена процедур сверяйте с релизом 3.4.5.21.
Модуль объекта / модуль менеджера справочника:
ОбработкаЗаполнения— инициализация нового элемента.ПередЗаписью/ПриЗаписи— контроль корректностиИдентификаторОбъекта, актуализация версии.ОбработкаПроверкиЗаполнения— проверка обязательных реквизитов (наименование, идентификатор) и наличия присоединённого файла.
Общий модуль подсистемы (серверная логика БСП, напр. ВнешниеКомпоненты/ВнешниеКомпонентыСлужебный):
ПодключитьВнешнююКомпоненту(...)— подключение компоненты по ссылке справочника или идентификатору (клиент/сервер) с учётом кэширования.ЗагрузитьВнешнююКомпоненту(...)/ОбновитьВнешнююКомпоненту(...)— загрузка ZIP-архива, разбор манифеста, запись версии и присоединённого файла.ПроверитьПодключениеВнешнейКомпоненты(...)— диагностика доступности компоненты на текущей платформе/разрядности.- Функции получения расположения — возврат адреса из макета (
ЭтоРасположениеВнешнейКомпонентыВМакете = Истина) либо из присоединённого файла.
5. Проведение и движения
Справочник не проводится и не формирует движений по регистрам, а также не порождает бухгалтерских проводок. У объекта типа «Справочник» отсутствует механизм проведения; изменения затрагивают только таблицы самого справочника и подчинённого справочника присоединённых файлов.
Плановые/налоговые показатели РК к этому объекту неприменимы. Для справки приводим корректные параметры Казахстана-2026, которые задействуются в операционных и регламентированных документах конфигурации (реализация, поступление, ЭСФ/СНТ, зарплата), но не в данном служебном справочнике:
- НДС — 16% (стандартная ставка 2026 года).
- МРП = 4 325 ₸, МЗП = 85 000 ₸.
- ИПН: базовый вычет 30 МРП/мес (не более 360 МРП за год); ставка 10% до 8 500 МРП годового дохода и 15% сверх.
- ОПВ 10% (потолок базы — 50 МЗП), ОПВР 3,5%, ВОСМС 2%, ОСМС 3%, СО 5%, соцналог 6%.
- Типовой план счетов РК для торговых операций: 1210 (краткосрочная ДЗ покупателей), 1030 (деньги на текущих счетах), 1330 (товары), 3310 (КЗ поставщикам), 3130 (НДС к уплате), 6010 (доход от реализации), 7010 (себестоимость реализации).
- Электронные документы: ЭСФ (ИС ЭСФ), СНТ. Валюта учёта — тенге (₸).
Эти значения — контекст платформы, где реально возникают проводки; сам справочник «ВнешниеКомпоненты» в них не участвует.
6. Связанные объекты и ввод на основании
Справочник.ВнешниеКомпонентыПрисоединенныеФайлы— подчинённый справочник, хранит двоичные файлы компонент (владелец — элемент «ВнешниеКомпоненты»).- Общие модули подсистемы «Внешние компоненты» БСП — API подключения/загрузки.
- Подсистемы-потребители: работа с торговым оборудованием, криптография и ЭЦП, интеграция с ИС ЭСФ и СНТ, сканирование штрихкодов — обращаются к справочнику для подключения нужной компоненты по идентификатору.
- Регистры сведений БСП для настроек подключаемого оборудования/сервисов, ссылающиеся на компоненту.
Ввод на основании для этого справочника типовой конфигурацией не предусмотрен: элементы создаются вручную или программно при загрузке компоненты.
7. Точки расширения
- Загрузка кастомной компоненты: добавление собственного элемента с ZIP-архивом (манифест + бинарники под нужные платформы/разрядности) и подключение через API подсистемы по
ИдентификаторОбъекта. - Расширение конфигурации (Extension): добавление реквизитов карточки (например, ссылки на документацию, ответственного, среды применения) и подписок на события
ПередЗаписью/ОбработкаПроверкиЗаполнениябез снятия с поддержки. - Обёртки над API подключения: собственный общий модуль поверх
ПодключитьВнешнююКомпонентудля централизованного логирования и обработки ошибок подключения. - Права и профили доступа: настройка ролей на изменение справочника — доступ к загрузке/обновлению компонент обычно ограничивают администратором.
Требует проверки в релизе 3.4.5.21: точные имена процедур общих модулей подсистемы «Внешние компоненты» и состав служебных реквизитов совместимости по платформам — они версионно-зависимы в БСП.