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

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

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

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

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

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

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

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

Любая установка, кроме простого открытия внешней обработки, начинается с резервной копии. Для файловой базы достаточно скопировать файл 1Cv8.1CD при закрытой программе или сделать выгрузку через конфигуратор («Администрирование — Выгрузить информационную базу»). Для клиент-серверной базы выгрузку .dt выполняет администратор, либо копия создаётся средствами СУБД.

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

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

Самый простой способ проверить обработку — открыть её через меню «Файл — Открыть» в режиме предприятия. Это ничего не меняет в базе и подходит для разового запуска. Для постоянного использования обработку подключают в справочник дополнительных отчётов и обработок.

Порядок подключения в типовых конфигурациях на БСП (УТ, ERP, БП, ЗУП): перейдите в «Администрирование — Печатные формы, отчеты и обработки», включите флажок «Дополнительные отчеты и обработки», затем откройте одноимённый справочник. Нажмите «Создать» или «Добавить из файла», выберите файл .epf/.erf, при необходимости укажите размещение (в каких разделах появится команда) и запишите элемент. После этого обработка доступна пользователям из интерфейса.

1. 1
   Включите опцию «Дополнительные отчеты и обработки» в разделе «Администрирование»
2. 2
   Откройте справочник «Дополнительные отчеты и обработки»
3. 3
   Нажмите «Добавить из файла» и выберите .epf или .erf
4. 4
   Задайте размещение команд и права доступа
5. 5
   Запишите и проверьте запуск обработки из интерфейса

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

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

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

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

Добавление модуля через конфигуратор

Если требуется добавить общий модуль или код в существующий объект, работа ведётся в конфигураторе. Откройте конфигурацию (потребуется монопольный режим), убедитесь, что конфигурация доступна для изменения: «Поддержка — Настройка поддержки — Включить возможность изменения». Учтите, что это действие может нарушить автоматическое обновление типовой конфигурации.

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

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

Установка модуля из файла поставки (.cf)

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

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

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

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

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

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

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

Обработка в списке дополнительных

Норма

Открывается и выполняет свою функцию

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

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

Состояние расширения

Норма

Активно, без пометок о несовместимости

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

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

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

Норма

Завершилось без ошибок, реструктуризация прошла

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

Ошибки в окне сообщений, конфликты реквизитов

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

Норма

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

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

Повторяющиеся ошибки при работе пользователей

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

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

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

Почему не открывается файл .epf с ошибкой безопасности?

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

Расширение перестало работать после обновления конфигурации. Что делать?

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

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

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

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

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

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

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