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

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

Как поставить модуль в 1С: инструкция для разных типов подключений

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

Фраза «поставить модуль в 1С» на практике означает одну из трёх разных операций: подключение расширения конфигурации (файл .cfe), загрузку внешней обработки или отчёта (.epf, .erf) либо установку обновления конфигурации через файл поставки (.cf, .cfu). Порядок действий, риски и способы проверки у каждого сценария свои, поэтому сначала нужно понять, какой именно файл вы получили.

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

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

Как определить, какой модуль вам нужно поставить

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

Типы модулей 1С

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

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

Внешняя обработка или отчёт (.epf, .erf)

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

Обновление конфигурации (.cf, .cfu)

Меняет саму конфигурацию и структуру базы данных. Применяется для обновлений от поставщика, требует копии базы и монопольного доступа.

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

Что сделать перед установкой любого модуля

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

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

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

Как поставить расширение конфигурации (.cfe)

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

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

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

Если расширение не подключается

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

Как подключить внешнюю обработку или отчёт (.epf, .erf)

Разовый запуск не требует установки вообще: откройте базу в режиме «1С:Предприятие», выберите «Файл → Открыть» и укажите файл обработки. Она запустится сразу. Этот способ подходит для тестирования и разовых операций.

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

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

Как установить обновление конфигурации (.cf, .cfu)

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

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

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

Как проверить, что модуль установился и работает

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

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

Расширение в списке
Норма

Флажок «Используется» установлен, колонка ошибок пуста

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

Надпись о несовместимости или предупреждения в колонке ошибок

Дополнительная обработка
Норма

Появилась в указанном разделе командного интерфейса и открывается

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

Обработки нет в интерфейсе или при открытии ошибка компиляции

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

Версия в «О программе» соответствует новому релизу, обработчики обновления завершены

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

Старая версия, незавершённые отложенные обработчики, ошибки при входе

Работа пользователей
Норма

Новая функциональность доступна, типовые операции выполняются без ошибок

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

Ошибки в документах или отчётах, которые раньше работали

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

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

Типичные ошибки
01
Установка обновления без резервной копии — при сбое реструктуризации данные восстановить неоткуда.
02
Попытка загрузить расширение как обновление конфигурации — файл .cfe не подходит для конфигуратора, а .cf не подключается как расширение.
03
Забытый перезапуск сеанса после добавления расширения — пользователь решает, что модуль не встал, и ставит его повторно.
04
Неснятый флажок «Безопасный режим» у расширения, которому нужен доступ к файлам — функциональность молча не работает.
05
Обновление конфигурации при работающих пользователях — конфликт сеансов и отказ в монопольном доступе.
06
Отсутствие назначения у дополнительной печатной формы — кнопка не появляется в документах, и кажется, что обработка не установилась.

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

Итог

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

Сначала определите тип файла: .cfe ставится как расширение через интерфейс Предприятия, .epf/.erf — открывается напрямую или регистрируется в дополнительных обработках, .cf/.cfu — обновление через конфигуратор. Резервная копия перед обновлением обязательна, а результат всегда проверяется тестовым запуском затронутых операций.

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

Можно ли поставить модуль без прав администратора?

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

Чем расширение лучше изменения конфигурации напрямую?

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

Расширение подключено, но его функции не видны. Что делать?

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

Безопасно ли отключать безопасный режим у расширения?

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

Как удалить установленный модуль?

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

Что делать, если после обновления база не запускается?

Не предпринимайте повторных обновлений. Запустите конфигуратор и проверьте журнал ошибок, затем восстановите базу из резервной копии, сделанной перед обновлением. Если копии нет, попробуйте тестирование и исправление информационной базы, но успех не гарантирован — поэтому копия обязательна.