Разработка и Конфигурация · 10 мин
Как установить модуль в 1С:Предприятие
Как установить модуль в 1С:Предприятие: загрузка расширения, внешней обработки и обновления конфигурации. Пошаговая инструкция, проверка результата и типичные ошибки.
Под «модулем» в 1С пользователи обычно понимают разные вещи: расширение конфигурации (файл .cfe), внешнюю обработку или отчёт (.epf, .erf), файл обновления конфигурации (.cfu) или полную выгрузку конфигурации (.cf). Способ установки зависит от того, какой именно файл вы получили от разработчика или поставщика, поэтому первый шаг — определить тип модуля.
Все операции по установке выполняются в конфигураторе или в режиме «Предприятие» под учётной записью с правами администратора. Для файловых баз потребуется монопольный доступ, то есть все пользователи должны выйти из программы. В клиент-серверном варианте часть действий можно выполнить без выгона пользователей, но обновление конфигурации базы данных всё равно потребует завершения сеансов.
Перед любыми изменениями сделайте резервную копию базы. Для файловой базы достаточно скопировать каталог с файлом 1Cv8.1CD либо выполнить выгрузку в dt через конфигуратор (Администрирование → Выгрузить информационную базу). Это займёт несколько минут, но позволит вернуться к рабочему состоянию, если модуль окажется несовместимым или установка пройдёт с ошибкой.
Определяем тип модуля по расширению файла
Прежде чем что-то устанавливать, посмотрите на расширение полученного файла. От этого зависит весь дальнейший порядок действий, и попытка загрузить файл «не туда» — самая частая причина ошибок у начинающих администраторов.
| Расширение | Что это | Как устанавливается |
|---|---|---|
| .cfe | Расширение конфигурации | Через управление расширениями в режиме «Предприятие» или конфигураторе |
| .epf / .erf | Внешняя обработка / отчёт | Открытие файла или подключение через «Дополнительные отчёты и обработки» |
| .cfu | Файл обновления конфигурации | Конфигуратор → Конфигурация → Поддержка → Обновить конфигурацию |
| .cf | Полная конфигурация | Конфигуратор → Загрузить конфигурацию из файла |
Установка расширения конфигурации (.cfe)
Расширения — самый безопасный и распространённый способ добавить модуль в типовую конфигурацию вроде «Управление торговлей» или «Бухгалтерия предприятия». Установка выполняется в режиме «Предприятие» и не требует монопольного доступа в большинстве случаев.
Откройте меню «Все функции» (если пункт недоступен, включите его: Сервис → Параметры → отображать команду «Все функции»). В списке найдите «Стандартные» → «Управление расширениями конфигурации». Нажмите «Добавить из файла», укажите путь к .cfe-файлу и подтвердите загрузку. После добавления убедитесь, что напротив расширения установлен флажок «Используется», и перезапустите сеанс.
- 1Сделайте резервную копию базы
- 2Откройте «Все функции» → «Стандартные» → «Управление расширениями конфигурации»
- 3Нажмите «Добавить из файла» и выберите .cfe-файл
- 4Проверьте, что флажок «Используется» установлен
- 5Перезапустите сеанс 1С и проверьте работу модуля
Если при подключении появляется сообщение о нарушении безопасности, проверьте настройки профиля безопасности: в типовых конфигурациях расширения могут блокироваться при включённом режиме защиты от опасных действий. Временно отключить его можно в диалоге подключения, но делайте это только для модулей из доверенного источника.
Подключение внешней обработки или отчёта (.epf, .erf)
Внешние обработки бывают двух сценариев использования. Разовый запуск: Файл → Открыть → выбрать файл .epf — обработка откроется и выполнится один раз, ничего в базе не сохраняя. Это удобно для сервисных утилит и тестирования.
Постоянное подключение выполняется через подсистему «Дополнительные отчёты и обработки»: Администрирование → Печатные формы, отчёты и обработки → включите флажок «Дополнительные отчёты и обработки», затем перейдите по одноимённой ссылке и добавьте файл. После добавления укажите размещение — в каких разделах меню обработка будет видна пользователям, и настройте права доступа.
Установка обновления конфигурации (.cfu) через конфигуратор
Если модуль поставляется как файл обновления .cfu, установка выполняется только в конфигураторе. Запустите конфигуратор, откройте конфигурацию (Конфигурация → Открыть конфигурацию), затем выберите Конфигурация → Поддержка → Обновить конфигурацию. В диалоге укажите «Выбор файла обновления» и путь к .cfu-файлу.
Платформа покажет список изменяемых объектов — просмотрите его, особенно если конфигурация дорабатывалась. Согласитесь с постановкой на поддержку, если система предложит. После загрузки обязательно выполните Конфигурация → Обновить конфигурацию базы данных (клавиша F7) — без этого шага изменения не применятся к данным, и пользователи продолжат работать со старой структурой.
Для файловой базы обновление конфигурации базы данных потребует монопольного режима: завершите все сеансы через Администрирование → Поддержка и обслуживание → Блокировка работы пользователей либо попросите коллег выйти. В клиент-серверном варианте сеансы завершаются через консоль кластера.
Проверка результата установки
После установки любого модуля нужно убедиться, что он фактически работает, а не просто «загрузился без ошибок». Для расширения проверьте его статус в списке расширений и наличие новых объектов в интерфейсе — пунктов меню, кнопок, отчётов, которые должен добавить модуль. Для внешней обработки — откройте её из раздела, в котором она размещена, и выполните тестовое действие на копии данных.
Полезно проверить журнал регистрации (в конфигураторе: Администрирование → Журнал регистрации) на наличие ошибок в момент первого запуска модуля. Ошибки вида «Метод объекта не обнаружен» или «Поле не найдено» обычно означают, что модуль рассчитан на другую версию конфигурации.
Как проверить результат
Флажок «Используется» установлен, ошибок в колонке состояния нет
Статус «отключено» или сообщение о несовместимости
Пункты меню и кнопки модуля видны и открываются
Объекты отсутствуют или выдают ошибку при открытии
Нет ошибок после перезапуска сеанса
Ошибки «метод не обнаружен», «поле не найдено»
Типичные ошибки и ограничения
Наиболее частая проблема — несовместимость версий. Модуль, написанный под конкретный релиз конфигурации, может отказаться работать на более старой или существенно более новой версии. Всегда уточняйте у поставщика модуля, с какими релизами он совместим, и сверяйте с вашей версией (Справка → О программе).
Вторая группа ошибок — права доступа. Если кнопка «Добавить» в управлении расширениями недоступна, у вашей учётной записи нет права «Администрирование расширений конфигурации». Обратитесь к администратору базы или выполните установку под учётной записью с полными правами.
Когда лучше привлечь специалиста
Самостоятельная установка оправдана для расширений и внешних обработок из проверенных источников на типовой конфигурации. Но есть ситуации, где риск ошибки выше стоимости услуг специалиста: сильно доработанная конфигурация, клиент-серверная база с десятками одновременных пользователей, модули, затрагивающие обмен данными или проведение документов.
Признак того, что задача выходит за рамки простой установки: поставщик модуля прислал инструкцию с ручной доработкой объектов конфигурации, объединением модулей или изменением ролей. Такие действия требуют понимания структуры конкретной конфигурации и опыта работы с механизмом сравнения и объединения.
Как выбрать действие
Что важно запомнить
Определите тип файла по расширению, сделайте резервную копию, установите модуль подходящим способом и проверьте результат в интерфейсе и журнале регистрации. Для типовых конфигураций предпочтительны расширения — они не нарушают поддержку и не мешают обновлениям.
Частые вопросы
Можно ли установить модуль без конфигуратора?
Да, если это расширение (.cfe) или внешняя обработка (.epf) — они подключаются прямо в режиме «Предприятие». Конфигуратор нужен только для файлов обновления .cfu и полных конфигураций .cf.
Что делать, если после установки модуля 1С перестала запускаться?
Запустите конфигуратор и отключите расширение через меню Конфигурация → Расширения конфигурации, сняв флажок использования. Если и это невозможно, восстановите базу из резервной копии, сделанной перед установкой.
Пропадёт ли установленный модуль при обновлении конфигурации?
Расширения при типовом обновлении обычно сохраняются, но могут отключиться при несовместимости с новым релизом — их статус нужно проверить после обновления. Модули, внедрённые изменением конфигурации, могут конфликтовать с обновлением и потребовать повторной адаптации.
Как удалить установленное расширение?
Откройте «Управление расширениями конфигурации», снимите флажок «Используется» или выделите расширение и нажмите «Удалить», затем перезапустите сеанс. Данные основной конфигурации при этом не затрагиваются.
Безопасно ли устанавливать модули из интернета?
Только из источников, которым вы доверяете. Обработки и расширения выполняют программный код с правами пользователя и могут читать и изменять любые данные базы. Перед установкой на рабочую базу протестируйте модуль на копии.
Почему кнопка добавления расширения неактивна?
У вашей учётной записи нет необходимых прав. Нужно право «Администрирование расширений конфигурации» — попросите администратора выдать его или выполнить установку под своей учётной записью с полными правами.