К статье
Практический материал

Администрирование · 9 мин

Как установить библиотеку 1С: пошаговое руководство

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

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

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

Определите, какая именно библиотека нужна

До начала установки важно понять, что именно вы получили от поставщика или скачали с портала 1С. От этого зависит весь дальнейший порядок действий.

  • Дистрибутив с setup.exe — шаблон конфигурации или библиотеки, устанавливается в каталог шаблонов и создаёт новую базу или обновляет существующую.
  • Файл .cf — конфигурация для загрузки или сравнения-объединения через Конфигуратор.
  • Файл .epf или .erf — внешняя обработка, «установки» как таковой не требует, открывается через «Файл → Открыть».
  • DLL или архив с компонентой — внешняя компонента по технологии Native API или COM, регистрируется в системе или подключается из макета конфигурации.

Если сомневаетесь в типе файла, откройте сопроводительную документацию (файл readme или 1cv8.htm в комплекте поставки) — там всегда указан поддерживаемый способ установки и минимальная версия платформы.

Подготовка: платформа, права и резервная копия

Библиотека работает только на совместимой версии платформы 1С:Предприятие. Проверьте установленную версию: в окне запуска или через «Пуск → Все программы → 1С Предприятие». Если требуемая версия отсутствует, сначала установите платформу с дистрибутива, полученного через портал portal.1c.ru по действующей подписке.

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

Установка библиотеки из дистрибутива

Это стандартный сценарий для библиотек и конфигураций, поставляемых фирмой «1С» и партнёрами. Дистрибутив представляет собой архив или папку с файлом setup.exe.

Порядок установки дистрибутива
  1. 1
    Распакуйте архив дистрибутива во временную папку
  2. 2
    Запустите setup.exe от имени администратора
  3. 3
    Примите лицензионное соглашение и укажите каталог шаблонов (по умолчанию подставляется стандартный путь)
  4. 4
    Дождитесь завершения копирования файлов шаблона
  5. 5
    Откройте окно запуска 1С и убедитесь, что шаблон доступен при создании новой базы

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

Создание базы из установленного шаблона

В окне запуска 1С нажмите «Добавить», выберите «Создание новой информационной базы», затем в списке шаблонов найдите установленную библиотеку с нужным номером релиза. Укажите имя базы и каталог размещения — после завершения база появится в списке и будет готова к первому запуску.

Внедрение библиотеки в существующую конфигурацию

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

Общий порядок такой: откройте базу в Конфигураторе с монопольным доступом, сделайте выгрузку .dt, затем выполните «Конфигурация → Сравнить, объединить с конфигурацией из файла» и укажите .cf библиотеки. В окне сравнения отметьте только те объекты, которые реально требуются, — при внедрении БСП фирма «1С» поставляет файл настроек объединения, который автоматизирует выбор.

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

Установка внешних компонент и DLL

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

Если компонента поставляется отдельным DLL-файлом, её регистрируют в операционной системе командой regsvr32 (для COM-компонент) либо копируют в каталог, указанный в документации поставщика. Для регистрации требуются права администратора, а разрядность компоненты должна совпадать с разрядностью клиента 1С: 32-битная компонента не загрузится в 64-битном клиенте.

cmd
regsvr32 "C:\Components\MyComponent.dll"

Проверка результата установки

После любого сценария установки убедитесь, что библиотека действительно доступна и работает. Не ограничивайтесь отсутствием ошибок — проверьте функциональность.

Контрольные точки

Как проверить результат

Шаблон в списке при создании базы
Норма

Библиотека с нужным релизом видна в окне выбора шаблона

Тревожный признак

Шаблона нет — проверьте каталог tmplts в настройках запуска

Запуск базы после внедрения
Норма

База открывается, отработало первоначальное заполнение, подсистемы видны в интерфейсе

Тревожный признак

Ошибки при обновлении конфигурации БД или пустой интерфейс

Внешняя компонента
Норма

Объект компоненты создаётся без ошибки «Не найдена внешняя компонента»

Тревожный признак

Ошибка подключения — несовпадение разрядности или компонента не зарегистрирована

Дополнительно полезно открыть «Все функции → Стандартные → Информация о конфигурации» или аналогичный отчёт и сверить версию библиотеки с тем релизом, который вы устанавливали.

Типичные ошибки и как их избежать

Типичные ошибки
01
Внедрение .cf через «Загрузить конфигурацию из файла» вместо сравнения-объединения — рабочая конфигурация полностью замещается библиотекой, данные прикладных объектов теряются
02
Установка дистрибутива не в тот каталог шаблонов — шаблон не виден при создании базы, хотя установка прошла успешно
03
Работа без монопольного доступа — обновление конфигурации базы данных прерывается с ошибкой, база может остаться в промежуточном состоянии
04
Игнорирование требований к версии платформы — библиотека устанавливается, но при запуске возникают ошибки несовместимости
05
Регистрация 32-битной DLL под 64-битным клиентом — компонента не подключается без явной диагностики причины

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

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

Можно ли установить библиотеку 1С без диска и подписки ИТС?

Дистрибутивы библиотек и обновлений распространяются через портал portal.1c.ru и доступны при действующем договоре сопровождения. Без доступа к порталу получить легальный дистрибутив можно у франчайзи-партнёра, который обслуживает вашу организацию.

Чем отличается загрузка конфигурации от объединения?

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

Шаблон установился, но не виден при создании базы. Что делать?

Откройте в окне запуска 1С «Настройка» и проверьте список каталогов шаблонов конфигураций. Добавьте путь, в который фактически установился дистрибутив, либо переустановите дистрибутив, указав каталог из настроек.

Нужно ли обновлять библиотеку после установки?

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

Можно ли внедрить библиотеку в клиент-серверной базе?

Да, порядок действий тот же, но монопольный доступ обеспечивается через блокировку сеансов в консоли кластера или через завершение работы пользователей из Конфигуратора. Выгрузку .dt на больших серверных базах разумно заменить резервной копией средствами СУБД.

Итог

Что важно запомнить

Сначала определите тип библиотеки: дистрибутив ставится через setup.exe и создаёт базу из шаблона, .cf внедряется через сравнение-объединение в Конфигураторе, внешние компоненты регистрируются в ОС. Перед внедрением в рабочую базу всегда делайте резервную копию и работайте в монопольном режиме, а после установки проверяйте результат запуском и сверкой версии.