Как установить расширение в 1С Управление торговлей

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

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

Что нужно проверить перед установкой расширения

Главное условие — совместимость расширения с вашей версией УТ. Расширение, написанное под УТ 11.4, может не заработать или работать с ошибками на УТ 11.5, если разработчик не учёл изменения типовых объектов. Уточните у поставщика расширения, для каких релизов оно предназначено, и сверьте с текущей версией конфигурации (раздел «Администрирование — Обслуживание — Результаты обновления» или сведения «О программе»).

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

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

Где находится механизм управления расширениями

В УТ 11 список расширений открывается двумя путями. Первый: «НСИ и администрирование — Печатные формы, отчеты и обработки — Расширения» — этот пункт доступен, если включена соответствующая функциональная опция. Второй, универсальный: меню «Все функции» (или «Функции для технического специалиста») — «Стандартные — Управление расширениями конфигурации».

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

Пошаговая установка расширения

Откройте список расширений и нажмите «Добавить из файла». Укажите путь к файлу с расширением .cfe. Платформа загрузит расширение и покажет его в списке с именем, префиксом и версией.

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

Завершающий шаг — перезапуск сеанса. Платформа предложит перезапустить программу автоматически; если нет, закройте и откройте 1С вручную. Изменения из расширения применяются только после перезапуска сеанса.

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

Как проверить, что расширение работает

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

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

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

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

Статус в списке расширений

Норма

Расширение активно, флажок «Отключено» снят

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

Строка помечена как отключённая или с ошибкой

Новая функциональность

Норма

Кнопки, формы или отчёты появились и работают

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

Элемент отсутствует или выдаёт ошибку при открытии

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

Норма

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

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

Ошибки обращения к объектам метаданных

Типичные ошибки и их устранение

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

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

Третья ошибка — конфликт нескольких расширений, изменяющих один и тот же объект. Платформа применяет расширения в порядке списка, и поведение может отличаться от ожидаемого. В этом случае меняйте порядок расширений или объединяйте доработки в одно расширение.

Управление, обновление и удаление расширений

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

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

Расширение или внешняя обработка: что выбрать

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

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

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

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

Нужна дополнительная печатная форма или отчёт без изменения документовИспользуйте внешнюю обработку через «Дополнительные отчеты и обработки»

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

Расширение вызывает ошибки после обновления УТОтключите его флажком и запросите адаптированную версию у разработчика

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

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

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

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

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

Пропадёт ли расширение при обновлении УТ?

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

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

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

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

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