Установка расширения конфигурации в 1С 8.3: из программы, через Конфигуратор и в облаке

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

Второй путь — Конфигуратор: Конфигурация → Расширения конфигурации. Он нужен, когда в программе нет формы «Расширения», когда расширение надо отладить или поставить на десяток баз скриптом. Оба способа работают на платформе 8.3 начиная с версии 8.3.6, в которой расширения и появились. Инструкция общая для типовых конфигураций на БСП: Бухгалтерии, ЗУП, Управления торговлей, Комплексной автоматизации.

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

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

Что обычно приходит в виде расширения:

• 🖨️ доработанная или новая печатная форма;
• 📊 свой отчёт с нужными колонками;
• 🔁 обмен с сайтом, складской программой, банком;
• 🧩 новые реквизиты в справочниках и документах;
• 🩹 «заплатка» от разработчика, которая исправляет ошибку в релизе до выхода исправленной версии.

У расширения есть свойство «Назначение». От него зависит порядок применения, если расширений несколько:

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

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

Расширение пишут под конкретную конфигурацию и, как правило, под её конкретный релиз. Оно «цепляется» к объектам основной конфигурации по именам. Если имени нет или у объекта другие свойства, расширение не применится.

Перед подключением проверьте пять вещей:

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

Откуда брать расширения

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

Как добавить расширение в 1С из пользовательского режима

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

Где находится список расширений

Если ссылки «Расширения» на странице нет, используйте стандартную форму платформы:

1. Включите меню «Все функции»: Главное меню → Сервис → Параметры, флажок «Отображать команду “Все функции”».
2. Откройте Главное меню → Все функции → Стандартные → Управление расширениями конфигурации.

Эта форма есть в любой конфигурации на 8.3, включая нетиповые.

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

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

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

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

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

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

Как установить расширение конфигурации через Конфигуратор

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

Загрузка файла .cfe вручную

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

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

В списке расширений у каждой строки есть флажки:

• ✅ Активно — расширение применяется к базе;
• 🔒 Безопасный режим — ограничения, описанные выше;
• 🛡️ Защита от опасных действий — платформа предупреждает пользователя, если код пытается сделать потенциально опасную операцию;
• 🔗 Использовать в распределённой ИБ — расширение передаётся в подчинённые узлы обмена.

Установка на несколько баз командной строкой

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

"C:\Program Files\1cv8\8.3.24.1691\bin\1cv8.exe" DESIGNER /F "D:\Bases\Buh" /N "Администратор" /P "пароль" ^
  /LoadCfg "D:\Ext\PechatnyeFormy.cfe" -Extension "PechatnyeFormy" ^
  /UpdateDBCfg -Extension "PechatnyeFormy" ^
  /Out "D:\Ext\log.txt"

Что здесь важно:

• путь к 1cv8.exe подставьте свой — он зависит от установленной версии платформы;
• для серверной базы вместо /F "путь" используйте /S "сервер\имя_базы";
• имя после -Extension — это имя расширения в базе; если такого нет, оно будет создано, если есть — заменено содержимым файла;
• журнал выполнения пишется в файл из параметра /Out, туда смотрите при ошибке.

Управление подключёнными расширениями: обновить, отключить, поменять порядок

Список расширений — это не только кнопка «Добавить». В нём же расширения обновляют и временно выключают.

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

Временное отключение. Снимите флажок подключения (в Конфигураторе — «Активно») и перезапустите программу. Расширение и его данные остаются в базе, но не применяются. Так удобно проверять, виновато ли расширение в странном поведении программы.

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

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

Расширения в облаке: 1С:Фреш и 1С:Линк

Здесь два сервиса устроены принципиально по-разному.

1С:Линк

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

1С:Фреш и другие сервисы на технологии 1cFresh

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

• 📦 расширения из каталога сервиса подключаются в один клик в настройках приложения;
• 🔍 собственное расширение загружается через форму расширений в приложении, после чего проходит проверку у провайдера сервиса;
• ⏳ после успешной проверки расширение становится доступным в приложении, при отказе провайдер сообщает причину;
• 🔒 расширения в облаке работают в безопасном режиме, доступ к файлам и внешним программам им недоступен.

Условия проверки, сроки и возможную плату уточняйте у своего провайдера: в 1С:Фреш, у партнёра, который держит сервис на 1cFresh, они могут различаться. Если провайдер не принимает собственные расширения, остаётся перенос доработки во внешнюю обработку или переход на аренду сервера, где база ведёт себя как локальная.

Расширение не работает или его нужно удалить

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

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

Из программы: откройте форму «Расширения», выделите строку, нажмите Удалить и перезапустите 1С. Из Конфигуратора: Конфигурация → Расширения конфигурации, выделите расширение и удалите его.

Перед удалением полезно выгрузить расширение в файл: в Конфигураторе это Конфигурация → Сохранить конфигурацию в файл… в дереве расширения. Вернуть его тогда можно за минуту.

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