Как подключить расширение в 1С:ЗУП

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

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

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

Проверьте условия перед подключением расширения

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

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

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

Сделайте резервную копию базы

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

Для клиент-серверной базы резервную копию делает администратор средствами СУБД (MS SQL, PostgreSQL) либо через выгрузку .dt в конфигураторе. Идеальный вариант — развернуть копию базы и сначала подключить расширение там. Если после установки расчёт зарплаты или отчёты начнут вести себя неправильно, вы сможете откатиться без потерь.

Подключите расширение через интерфейс 1С:ЗУП

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

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

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

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

Настройте безопасный режим и профиль безопасности

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

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

Проверьте, что расширение работает

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

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

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

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

Расширение в списке

Норма

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

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

Флажок снят или отображается сообщение об ошибке применения

Новый функционал

Норма

Кнопки, отчёты или формы из расширения доступны и работают

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

После перезахода в программу ничего не появилось

Типовые операции

Норма

Начисление зарплаты и отчёты работают как раньше

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

Ошибки при проведении документов или формировании отчётов

Обновление, отключение и удаление расширения

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

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

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

Частые проблемы и способы их решения

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

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

Маршрут решения

Как выбрать действие

Ошибка совместимости при добавлении файлаУточните релиз вашей ЗУП и запросите у разработчика версию расширения под него

После подключения сломался расчёт или отчётыНемедленно снимите флажок использования расширения и перезапустите сеанс

Расширение работает у администратора, но не у кадровикаПроверьте роли и профили групп доступа для объектов расширения

Нужно временно отключить доработкуСнимите флажок в списке расширений, не удаляя само расширение

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

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

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

Собьётся ли поддержка и обновление ЗУП после установки расширения?

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

Чем расширение отличается от внешней обработки?

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

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

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

Как безопасно удалить расширение, если оно вызывает ошибки?

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

Можно ли подключить несколько расширений одновременно?

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