Как настроить расширение в 1С

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

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

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

Что такое расширение и когда его стоит использовать

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

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

Сравнение вариантов доработки

Расширение конфигурации

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

Внешняя обработка или отчёт

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

Доработка основной конфигурации

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

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

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

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

Загрузка расширения в режиме «Предприятие»

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

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

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

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

Загрузка через Конфигуратор

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

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

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

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

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

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

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

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

Норма

Применяется: Да, без предупреждений

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

Применяется: Нет или значок ошибки

Работа доработанной формы

Норма

Форма открывается, новые элементы отображаются и работают

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

Ошибка при открытии или отсутствие ожидаемых элементов

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

Норма

Нет ошибок, связанных с расширением

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

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

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

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

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

Управление несколькими расширениями

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

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

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

Расширение загружено, но статус «Не применяется». Что делать?

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

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

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

Что произойдёт с расширением при обновлении конфигурации?

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

Безопасно ли снимать флажок «Безопасный режим»?

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

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

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

Конфликтуют два расширения, изменяющие одну форму. Что делать?

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