Расширение конфигурации в ЗУП 3.1: установка из файла .cfe, проверка и удаление

Расширение в 1С ЗУП 3.1 подключают прямо из программы: Администрирование → Печатные формы, отчеты и обработки → Расширения, кнопка Добавить из файла, выбрать файл .cfe и перезапустить программу. Конфигуратор для этого не нужен, а снимать конфигурацию с поддержки не нужно тем более.

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

Зачем ЗУП расширения и чем они лучше правки конфигурации

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

Что обычно подключают в ЗУП расширением:

• 🖨 свою печатную форму приказа, расчётного листка или справки;
• 📊 дополнительный отчёт, например свод по подразделениям в нужном разрезе;
• 🔧 исправление, которое разработчик выпустил до выхода очередного релиза;
• ➕ новые реквизиты в карточке сотрудника или документе;
• 🔗 загрузку данных из внешней системы учёта времени или СКУД.

Сравним три способа доработать ЗУП:

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

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

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

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

Как подключить расширение в 1С ЗУП 3.1 без конфигуратора

Это основной способ. Он работает и в файловой, и в клиент-серверной базе, и не требует монопольного доступа.

Шаг 1. Откройте список расширений

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

Шаг 2. Добавьте файл

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

Шаг 3. Проверьте флажки в строке

Расширение появится в списке. Посмотрите на колонки строки:

• Подключено (активно) — расширение будет применяться при запуске;
• Безопасный режим — ограничивает расширению доступ к файлам, внешним компонентам и COM-объектам;
• передача в подчинённые узлы — нужна, только если у вас распределённая база.

Безопасный режим оставьте включённым, если разработчик не сказал иное. Подробнее о нём — в разделе про контроль.

Шаг 4. Перезапустите программу

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

Шаг 5. Убедитесь, что доработка работает

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

Если файл не тот, что ожидает программа

Разработчики часто присылают доработку архивом. Сначала распакуйте его: программа принимает только сам файл .cfe, а не .zip.

Бывает, что в архиве лежит не расширение, а другой формат. Как понять, что с ним делать:

• 📄 .cfe — расширение, подключается по шагам выше;
• 📄 .epf или .erf — внешняя обработка или отчёт, их добавляют в соседнем пункте той же формы, «Дополнительные отчеты и обработки»;
• 📄 .cf — полная конфигурация, как расширение её не подключить. Это работа для программиста через сравнение и объединение.

Подключение расширения через конфигуратор

Конфигуратор нужен программисту или в двух практических случаях: если в пользовательском режиме расширение не добавляется и если у ЗУП обычный интерфейс без формы «Расширения».

Порядок действий:

1. Запустите базу в режиме «Конфигуратор» под администратором.
2. Откройте Конфигурация → Расширения конфигурации.
3. В окне списка добавьте новое расширение и загрузите в него файл .cfe командой загрузки из файла в меню Действия этого окна.
4. Откройте свойства расширения и проверьте флажки «Активно» и «Безопасный режим».
5. Выполните обновление конфигурации базы данных для расширения (команда «Обновить конфигурацию базы данных» в том же окне, клавиша F7).

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

Расширения в ЗУП 2.5: что реально возможно

ЗУП 2.5 написан на обычных формах. Формы «Расширения» в пользовательском режиме там нет, поэтому подключение возможно только через конфигуратор — по шагам из предыдущего раздела.

Ограничения редакции 2.5:

• ❌ Обычные формы расширение изменить не может. Механизм дорабатывает управляемые формы. Новую кнопку на форму документа ЗУП 2.5 так не добавить.
• ❌ Режим совместимости. Если в свойствах конфигурации выставлен режим совместимости с 8.2, механизм расширений недоступен. Проверьте это свойство в конфигураторе до заказа доработки.
• ✅ Новые объекты добавить можно — отчёт, обработку, справочник, если режим совместимости позволяет.

На практике для ЗУП 2.5 печатные формы и отчёты проще подключать внешними файлами .epf и .erf. Редакция 2.5 уже не развивается и не получает изменений законодательства. Вкладываться в расширения для неё имеет смысл только как в временную меру до перехода на 3.1.

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

Как обновить расширение на новую версию

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

Удаление с повторным добавлением хуже. Если расширение хранит свои данные, при удалении они пропадут.

Как временно отключить

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

Как удалить расширение полностью

1. Сохраните файл расширения на диск, если его копии нет: выделите строку и выберите сохранение в меню Ещё.
2. Нажмите Удалить и подтвердите.
3. Перезапустите программу.

Если расширение добавляло свои справочники, реквизиты или регистры, при удалении эти данные стираются из базы безвозвратно. Перед удалением такого расширения сделайте резервную копию.

Что происходит с расширением при обновлении ЗУП

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

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

Безопасный режим и контроль расширений

Расширение исполняет код с теми же возможностями, что и сама программа. В ЗУП это паспортные данные, оклады, сведения о детях и больничных. Контроль тут не формальность.

Что включает защиту:

Три практических правила:

• 🔒 Ведите учёт: какое расширение, от кого, для чего, когда установлено. Хватит таблицы на три колонки.
• 🔍 Удаляйте расширения, которые больше не нужны. Забытое «временное исправление» через год ломает обновление.
• 👤 Если расширение добавляет свои роли, проверьте, что пользователи их получили. Иначе программист увидит доработку под администратором, а расчётчик — нет.

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

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

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