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

Под «плагином» в экосистеме 1С обычно понимают три разных вещи: расширение конфигурации (файл .cfe), внешнюю обработку или отчёт (файл .epf, .erf) и внешнюю компоненту (файл .dll или .zip для технологии Native API/COM). Порядок установки различается, поэтому первый шаг — понять, какой именно файл вы получили от разработчика или скачали из каталога.

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

Ниже разобраны подготовка, установка каждого типа плагина, проверка результата и типичные ошибки. Инструкции применимы к типовым конфигурациям на платформе 1С:Предприятие 8.3, но пункты меню могут немного отличаться в зависимости от версии конфигурации.

Определите тип плагина перед установкой

Расширение конфигурации (.cfe) — самый безопасный и современный способ доработки: оно не меняет типовую конфигурацию, а накладывается поверх неё. Такие плагины используют для добавления печатных форм, кнопок, проверок и небольших доработок логики. Они корректно переживают обновления, если не конфликтуют с изменёнными объектами.

Внешние обработки и отчёты (.epf, .erf) — самостоятельные файлы, которые можно открыть разово через «Файл → Открыть» или зарегистрировать в справочнике дополнительных отчётов и обработок, чтобы они появились в интерфейсе у пользователей. Внешние компоненты (библиотеки для сканеров, криптографии, оборудования) устанавливаются на уровне операционной системы и подключаются кодом.

Подготовка: резервная копия и проверка источника

Перед установкой любого плагина создайте выгрузку информационной базы: в конфигураторе откройте «Администрирование → Выгрузить информационную базу» и сохраните файл .dt. Для клиент-серверной базы надёжнее делать копию средствами СУБД. Проверьте, что копия восстанавливается, — файл, который нельзя развернуть, страховкой не является.

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

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

Установка расширения конфигурации (.cfe)

В пользовательском режиме откройте «Администрирование → Печатные формы, отчеты и обработки → Расширения» (в некоторых конфигурациях путь — «Настройки и администрирование → Расширения»). Нажмите «Добавить из файла», выберите файл .cfe и подтвердите загрузку. После добавления расширение появится в списке, но для активации обычно требуется перезапуск сеанса.

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

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

1. 1
   Сделайте резервную копию базы и проверьте её восстановление
2. 2
   Откройте «Администрирование → Печатные формы, отчеты и обработки → Расширения»
3. 3
   Нажмите «Добавить из файла» и выберите файл .cfe
4. 4
   Снимите флажок «Безопасный режим» только при необходимости и доверии к источнику
5. 5
   Перезапустите сеанс 1С и проверьте, что расширение активно
6. 6
   Проверьте работу новой функции на тестовом документе

Установка внешней обработки или отчёта (.epf, .erf)

Для разового запуска достаточно команды «Файл → Открыть» и выбора файла обработки. Это удобно для разовых сервисных операций: загрузки данных, группового изменения реквизитов, тестирования. Обработка при этом нигде не регистрируется и не появляется у других пользователей.

Чтобы обработка стала доступна всем пользователям из интерфейса, включите в настройках «Администрирование → Печатные формы, отчеты и обработки» флажок «Дополнительные отчеты и обработки», затем перейдите в одноимённый справочник и создайте новый элемент, загрузив файл. После записи обработка появится в разделах «Дополнительные обработки» соответствующих подсистем.

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

Установка внешней компоненты

Внешние компоненты поставляются как .dll для Windows, иногда как .zip-архив с вариантами под разные платформы. Классическая установка — регистрация COM-компоненты в системе командой regsvr32 от имени администратора, после чего она подключается кодом «ПодключитьВнешнююКомпоненту». Современные компоненты по технологии Native API часто подключаются из макета конфигурации без регистрации в ОС.

Учитывайте разрядность: 32-битная компонента не загрузится в 64-битном клиенте и наоборот. Для серверного варианта работы компоненту нужно устанавливать на сервер 1С, а не на компьютер пользователя. Если компонента нужна для оборудования (сканер, ККТ), проверьте, нет ли готового драйвера от производителя — он часто заменяет ручную установку.

Сравнение способов подключения

Расширение .cfe

Подходит для постоянных доработок типовой конфигурации; не ломает обновления, но требует совместимости версий

Внешняя обработка .epf/.erf

Подходит для сервисных операций и отчётов; простая установка, но не меняет поведение форм и документов

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

Подходит для оборудования и системных функций; требует прав администратора ОС и совпадения разрядности

Проверка результата и откат при проблемах

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

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

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

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

Статус расширения в списке

Норма

Расширение активно, ошибок применимости нет

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

Предупреждение о конфликте или расширение отключено

Работа изменённой формы

Норма

Форма открывается, новые элементы работают

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

Ошибка при открытии формы или записи документа

Журнал регистрации

Норма

Нет новых ошибок после установки

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

Появились ошибки выполнения кода расширения

Обновление конфигурации

Норма

Обновление проходит с подключённым расширением

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

Обновление блокируется конфликтом объектов

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

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

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

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

Можно ли установить плагин без конфигуратора?

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

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

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

Что произойдёт с плагином при обновлении конфигурации?

Внешние обработки обновление не затрагивает. Расширения сохраняются, но могут оказаться несовместимыми с новой версией: система сообщит о конфликте, и расширение придётся обновить до актуальной версии или временно отключить.

Безопасно ли снимать флажок «Безопасный режим» у расширения?

Только если вы доверяете источнику и разработчик прямо указывает, что это необходимо — например, для обмена файлами или работы с оборудованием. Безопасный режим ограничивает доступ кода к файловой системе и внешним ресурсам, и снимать его «на всякий случай» не следует.

Как полностью удалить плагин?

Расширение удаляется из списка расширений — данные основной конфигурации при этом не затрагиваются, но данные, созданные в объектах самого расширения, будут удалены вместе с ним. Внешняя обработка удаляется из справочника дополнительных обработок. Компоненту удаляют через отмену регистрации (regsvr32 /u) и удаление файла.

Можно ли проверить плагин, не рискуя рабочей базой?

Да, это рекомендуемая практика. Восстановите резервную копию в отдельную базу, установите плагин там и проверьте основные сценарии работы. Только после успешной проверки повторите установку в рабочей базе.