Библиотека в 1С: что это такое и как её использовать

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

Чаще всего под «библиотекой 1С» подразумевают именно БСП — это фундамент, на котором построены типовые конфигурации: «Управление торговлей», «Бухгалтерия предприятия», «Зарплата и управление персоналом». БСП даёт готовые механизмы: работу с пользователями, обмен данными, печать, хранение файлов, напоминания, версионирование объектов. Разработчику не нужно писать эти функции с нуля — достаточно внедрить подсистему и вызывать её программный интерфейс.

Отдельный смысл термина — «Библиотека электронных документов», которая поставляется как часть решений для обмена юридически значимыми документами, а также внешние библиотеки (DLL, компоненты Native API), которые расширяют возможности платформы: работа со сканерами, торговым оборудованием, криптографией. Ниже разберём каждый тип, способы подключения и типичные ошибки.

Что такое Библиотека стандартных подсистем (БСП)

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

БСП распространяется как конфигурация, которую можно скачать с портала 1С:Обновление программ (портал.1с.ru) при наличии действующего договора ИТС. Внутри поставки находится демонстрационная база, файлы выгрузки конфигурации и документация по внедрению каждой подсистемы — с пошаговыми инструкциями и примерами вызова программного интерфейса.

Ключевой принцип работы с БСП — использование программного интерфейса общих модулей, а не прямое обращение к объектам метаданных библиотеки. Например, вместо собственного кода записи файла в базу вызывается процедура модуля РаботаСФайлами. Это гарантирует, что при обновлении библиотеки ваш код продолжит работать, потому что состав экспортных процедур программного интерфейса меняется редко и обычно с сохранением обратной совместимости.

Какие виды библиотек встречаются в 1С

Кроме БСП, в практике встречается ещё несколько сущностей, которые называют библиотеками. Важно различать их, чтобы правильно искать документацию и понимать, как обновлять каждый компонент.

• БСП — набор подсистем на встроенном языке 1С, внедряется в конфигурацию через сравнение и объединение.
• Библиотека электронных документов (БЭД) — подсистема обмена юридически значимыми электронными документами (счета-фактуры, УПД, акты) через операторов ЭДО.
• Внешние компоненты (Native API, COM) — двоичные библиотеки (DLL, SO), подключаемые методом ПодключитьВнешнююКомпоненту, например драйверы торгового оборудования или компоненты сканирования штрихкодов.
• Библиотека картинок — стандартный объект конфигурации, коллекция изображений для кнопок, команд и форм.
• Библиотека стилей — наборы цветов, шрифтов и оформления элементов интерфейса.
• Сторонние библиотеки и расширения — готовые модули от партнёров и сообщества, например из магазина 1С:Совместимо.

Каждый вид имеет свой механизм обновления: БСП обновляется через сравнение и объединение конфигураций, внешние компоненты — заменой файлов и перерегистрацией, библиотеки картинок и стилей — внутри самой конфигурации конфигуратором.

Как внедрить БСП в собственную конфигурацию

Внедрение БСП — нетривиальная задача, которая требует аккуратности. Процесс выполняется в конфигураторе через механизм сравнения и объединения с поставкой библиотеки. Перед началом обязательно делается резервная копия информационной базы и выгрузка файла конфигурации (.cf) — это единственный способ откатиться при ошибке.

1. 1
   Скачайте дистрибутив БСП нужной версии с портала 1С:Обновление программ
2. 2
   Сделайте резервную копию базы и выгрузите конфигурацию в файл .cf
3. 3
   В конфигураторе откройте «Конфигурация → Сравнить, объединить с конфигурацией из файла»
4. 4
   Выберите файл поставки БСП и отметьте только нужные подсистемы
5. 5
   Выполните объединение, разрешив конфликты в пользу объектов БСП
6. 6
   Выполните первоначальную настройку по документации из поставки (модуль СтандартныеПодсистемыСервер, переопределяемые модули)
7. 7
   Обновите конфигурацию базы данных и протестируйте запуск в пользовательском режиме

После объединения библиотека требует настройки через переопределяемые общие модули: в них разработчик описывает особенности своей конфигурации — какие справочники участвуют в обменах, как формировать ключи доступа, какие роли существуют. Без заполнения переопределяемых модулей многие подсистемы работать не будут, а при запуске появятся ошибки вида «процедура не определена» или пустые списки настроек.

Как подключить внешнюю компоненту (DLL)

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

Типичные проблемы при подключении: несовпадение разрядности (32-битная компонента не загрузится в 64-битный клиент), отсутствие прав на установку у пользователя, блокировка антивирусом. Проверять результат подключения нужно по возвращаемому значению функции и через обработку исключений, а не «на глаз».

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

Обновление БСП и типовых конфигураций на её основе

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

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

Типичные ошибки при работе с библиотеками

Отдельная частая ситуация — попытка внедрить новую версию БСП в старую платформу. У каждой версии библиотеки указаны минимальные требования к версии платформы 1С:Предприятие и режиму совместимости. Если требования не соблюдены, конфигурация либо не обновится, либо будет работать нестабильно. Проверяйте совместимость в документации к поставке до начала работ.

Где искать документацию и как учиться работе с БСП

Основной источник — документация, входящая в поставку библиотеки: она содержит описание каждой подсистемы, инструкции по внедрению и справку по программному интерфейсу. Дополнительно полезны демонстрационная конфигурация из поставки (в ней можно посмотреть работающие примеры), публикации на портале 1С:ИТС и курсы по разработке на управляемых формах.

Практический подход к изучению: сначала развернуть демо-базу БСП, посмотреть, как устроены подсистемы «Пользователи», «Работа с файлами» и «Печать», затем перенести одну подсистему в тестовую пустую конфигурацию. Такой порядок даёт понимание механизма внедрения без риска для рабочего проекта.

Часто задаваемые вопросы