Подключение расширения конфигурации к базе 1С 8.3: от файла .cfe до первого запуска

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

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

Что даёт расширение и чем оно лучше доработки типовой

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

Что умеет расширение:

• 📄 добавлять новые отчёты, обработки, печатные формы и документы;
• 🧩 добавлять реквизиты и табличные части к существующим справочникам и документам;
• 🔧 менять формы и перехватывать процедуры типовых модулей;
• 🛠 исправлять ошибки типовой конфигурации до выхода нового релиза.

Платформа делит расширения по назначению. Это свойство видно в Конфигураторе:

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

Откуда берут файл расширения

Готового «магазина расширений» внутри программы нет. Файл .cfe приходит из одного из источников:

1. Разработчик или франчайзи. Пишет доработку под вашу задачу и передаёт файл.
2. Сторонний поставщик. Продаёт тиражное расширение: интеграцию с маркетплейсом, банком, ТСД. Обычно вместе с инструкцией и требованиями к релизу.
3. Исправления от разработчика типовой конфигурации. В типовых на БСП они ставятся через Администрирование → Интернет-поддержка и сервисы, в блоке обновления программы. Это тоже расширения с назначением «Исправление».
4. Собственный программист. Выгружает расширение из своей базы через Конфигуратор в файл.

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

Перед покупкой уточните у поставщика:

• 🔹 на каких конфигурациях и релизах проверено расширение;
• 🔹 нужна ли минимальная версия платформы;
• 🔹 требуется ли снимать безопасный режим и зачем;
• 🔹 как поставщик выпускает обновления под новые релизы типовой.

Подготовка базы перед подключением расширения

На подготовку уходит десять минут, а экономит она откат базы в рабочий день.

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

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

Сверьте релиз. Откройте Справка → О программе (кнопка с буквой «i» или меню ≡). Там видны версия платформы и релиз конфигурации. Сравните их с требованиями поставщика.

Включите «Все функции», если раздела «Расширения» нет. Нажмите меню ≡ (три полоски в левом верхнем углу), откройте Сервис → Параметры и поставьте флажок «Отображать команду “Все функции”». Команда появится в том же меню.

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

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

Способ 1. Подключение расширения в пользовательском режиме

1. Запустите базу в режиме «1С:Предприятие» под администратором.
2. Откройте окно управления расширениями:
   • в БП 3.0, ЗУП 3.1, УТ 11: Администрирование → Печатные формы, отчеты и обработки → Расширения;
   • в любой конфигурации: Все функции → Стандартные → Управление расширениями конфигурации.
3. Нажмите Добавить из файла… (в форме БСП кнопка может называться просто Добавить).
4. Согласитесь с предупреждением о безопасности, если программа его покажет.
5. Укажите файл .cfe на диске.
6. Расширение появится в списке. Проверьте флажок «Безопасный режим» (подробнее ниже).
7. Завершите работу и запустите программу заново. Изменения применяются только после перезапуска сеанса.

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

Способ 2. Подключение расширения через Конфигуратор

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

Безопасный режим, роли и проверка после подключения

Подключили и перезапустили — дальше три проверки.

Безопасный режим

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

В безопасном режиме код расширения не может:

• 🚫 работать с файлами на диске сервера или компьютера;
• 🚫 запускать внешние программы и COM-объекты;
• 🚫 подключать внешние компоненты и обращаться к привилегированным операциям.

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

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

Роли и доступ пользователей

Расширение часто приносит свои роли. Если их не назначить, пользователи не увидят новые команды. Варианты:

1. Разработчик включил в свойствах расширения использование основных ролей для всех пользователей — тогда ничего делать не нужно.
2. Роли расширения добавляют в профили групп доступа: Администрирование → Настройки пользователей и прав → Группы доступа или Профили групп доступа.

Тест на реальной операции

Проверьте то, ради чего расширение ставили:

• 🔸 открылся ли новый отчёт или обработка в нужном разделе;
• 🔸 появилось ли новое поле в карточке или документе;
• 🔸 проводится ли изменённый документ, совпадают ли движения с ожидаемыми;
• 🔸 работает ли расширение под обычным пользователем, а не только под администратором.

Ошибки при подключении расширения и их причины

Большинство проблем связаны с несовпадением версий и правами. Выберите симптом:

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

Обновление на новую версию

Поставщик выпустил новую версию, или вы обновили типовую и старое расширение перестало применяться. Порядок:

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

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

Удаление расширения

1. Выделите расширение в списке.
2. Нажмите Удалить и подтвердите.
3. Перезапустите программу.

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

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

Как работать с расширениями без проблем

Несколько правил, которые сокращают число сюрпризов после обновлений:

• 📌 Ведите реестр. Простая таблица: имя расширения, поставщик, версия, для какого релиза, кто отвечает. Через год никто не вспомнит, зачем в базе пять расширений.
• 📌 Одна задача — одно расширение. Если в одном расширении и печатная форма, и интеграция, и исправление проведения, обновлять и отключать их по отдельности не выйдет.
• 📌 Проверяйте расширения перед каждым обновлением типовой. Ставьте новый релиз на копию, запускайте её и открывайте ключевые документы.
• 📌 Не держите безопасный режим снятым «на всякий случай». Снимайте его только тем расширениям, которым он реально мешает.
• 📌 Храните исходные .cfe. Если база повредится, расширение можно будет подключить заново за минуту.
• 📌 Следите за порядком применения. Если два расширения перехватывают одну процедуру, результат зависит от порядка. Конфликт ищет программист, пользователю достаточно знать, что после нового расширения «сломалось старое» — повод отключить новое и проверить.

Частые вопросы о расширениях 1С