Установка расширения конфигурации: Конфигуратор и пользовательский режим

Добавить расширение в 1С можно двумя путями. В типовых конфигурациях на БСП (Бухгалтерия 3.0, ЗУП 3.1, УТ 11) откройте Администрирование → Печатные формы, отчеты и обработки → Расширения и нажмите «Добавить из файла». В Конфигураторе — Конфигурация → Расширения конфигурации, затем загрузка файла .cfe и обновление конфигурации базы данных для этого расширения.

Механизм работает на платформе 8.3 с номером не ниже 8.3.6, интерфейс описан для «Такси» на платформе 8.3.2x. Пошаговая инструкция ниже подходит и для файловой, и для клиент-серверной базы. Отличия по правам, безопасному режиму и обновлению версий разобраны в отдельных разделах.

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

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

Перед загрузкой файла пройдите короткий список:

• 📦 Файл. Расширение поставляется одним файлом с расширением .cfe. Файлы .epf и .erf — это внешние обработки и отчёты, они подключаются в другом месте. Файл .cf — полная конфигурация, его загружать как расширение нельзя.
• 🔢 Версия конфигурации. Узнайте релиз базы: Справка → О программе (иконка с буквой «i» или меню «шестерёнка»). Сравните с тем, для какого релиза разработчик собирал расширение. Если в описании указан релиз выше вашего — сначала обновите базу.
• 🧩 Версия платформы. У расширения есть режим совместимости. Если он новее, чем ваша платформа, загрузка завершится ошибкой.
• 👤 Права. Для установки нужны полные права или право «Администрирование». У обычного пользователя команды добавления не будет.
• 💾 Резервная копия. Расширение может менять логику проведения и записи документов. Перед первой установкой в рабочую базу сделайте выгрузку .dt или копию каталога файловой базы.

Какой способ выбрать

Способ 1. Добавление расширения в режиме Предприятия

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

Типовая конфигурация на БСП

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

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

Нетиповая конфигурация

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

1. Включите отображение команды «Все функции»: меню «шестерёнка» → Параметры → флажок «Отображать команду Все функции».
2. Откройте Все функции → Стандартные → Управление расширениями конфигурации.
3. Нажмите «Добавить» и укажите файл .cfe.
4. Перезапустите сеанс.

Способ 2. Установка расширения через Конфигуратор

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

Загрузка готового файла .cfe

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

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

Создание нового расширения

Создают расширение кнопкой «Добавить» в том же окне. В его свойствах задают:

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

Дальше в дерево расширения заимствуют нужные объекты основной конфигурации (контекстное меню объекта → «Добавить в расширение») и переопределяют формы и процедуры.

Пакетная установка из командной строки

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

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

"C:\Program Files\1cv8\8.3.24.1586\bin\1cv8.exe" DESIGNER /F"D:\Bases\Buh" /N"Администратор" /P"пароль" /UpdateDBCfg -Extension MyExt /Out "D:\Logs\update.log"

Для клиент-серверной базы вместо /F указывают /S"сервер\имя_базы". Номер платформы в пути замените на свой. Имя после -Extension должно совпадать с именем расширения внутри файла.

Права пользователей и безопасный режим расширения

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

Роли расширения

Если расширение добавляет свои объекты (справочники, отчёты, обработки), разработчик обычно включает в него собственные роли. Эти роли надо выдать пользователям:

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

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

Безопасный режим и защита от опасных действий

У каждого расширения два флажка, которые влияют на работу.

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

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

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

Как обновить расширение до новой версии

Устанавливать новую версию рядом со старой не нужно — будет два расширения с конфликтом имён. Обновление делается поверх:

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

Порядок при обновлении самой конфигурации

1. Узнайте у разработчика, совместимо ли расширение с новым релизом.
2. Обновите конфигурацию в копии базы и запустите её. Если расширение не применилось — ждите новую версию.
3. В Конфигураторе после обновления откройте дерево расширения: проблемные заимствованные объекты будут отмечены, а при обновлении конфигурации базы данных платформа выведет список несоответствий.
4. Когда версия расширения готова, обновляйте рабочую базу и расширение в одно окно, пока пользователи не работают.

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

Если после установки что-то пошло не так, расширение не обязательно удалять сразу. Сначала его отключают.

Временно отключить

• В форме БСП: снимите флажок подключения в строке расширения и перезапустите сеанс.
• В Конфигураторе: в окне Расширения конфигурации снимите флажок в колонке «Активно».

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

Удалить полностью

• В режиме Предприятия: выделите расширение в списке и нажмите «Удалить».
• В Конфигураторе: выделите строку в окне расширений и нажмите «Удалить».

Расширение мешает войти в базу

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

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