Расширение конфигурации 1С: загрузка, подключение и проверка

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

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

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

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

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

• 📦 Файл расширения. Нужен файл .cfe. Если расширение пришло архивом, распакуйте его. Откройте описание: для какой конфигурации и каких релизов оно сделано.
• 🔢 Версия платформы. У разработчика обычно указан минимальный номер платформы. Ваш должен быть не ниже указанного. Версию смотрите в окне «О программе».
• 🧩 Совпадение конфигурации. Расширение для Бухгалтерии предприятия не заработает в ЗУП, а для одного релиза может не подойти к другому. Сверяйте название и режим совместимости.
• 🔑 Права. Для установки через Конфигуратор нужны права администратора. Для работы в режиме Предприятие тоже нужна роль с правом администрирования.
• 💾 Копия базы. Выгрузите .dt или скопируйте файловую базу целиком.

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

Какими способами можно поставить расширение

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

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

Установка через Конфигуратор по шагам

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

Шаг 1. Откройте список расширений

В главном меню выберите Конфигурация → Расширения конфигурации. Откроется окно со списком. Для новой базы список пуст.

Шаг 2. Добавьте файл

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

Платформа создаст расширение в базе. Оно появится в списке с именем, версией и признаком активности.

Шаг 3. Проверьте свойства

Выделите расширение и откройте его свойства. Пока этого достаточно, чтобы увидеть:

1. имя расширения;
2. версию, если разработчик её указал;
3. флаг «Безопасный режим» и защиту от опасных действий.

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

Шаг 4. Обновите конфигурацию базы данных

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

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

Шаг 5. Запустите 1С:Предприятие

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

Как добавить расширение без Конфигуратора и из командной строки

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

Что важно в этом режиме:

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

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

1cv8.exe DESIGNER /F "C:\Bases\Buh" /N "Администратор" /LoadCfg "C:\Ext\Расширение.cfe" -Extension "ИмяРасширения" /UpdateDBCfg -Extension "ИмяРасширения" /Out "C:\Ext\log.txt"

Имя расширения в параметре задаёт то имя, под которым оно будет зарегистрировано в базе. Журнал в log.txt откройте после запуска: в нём видно, на каком шаге произошёл сбой. Параметры соединения для серверной базы замените на /S "сервер\база".

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

Одной галочки «активно» мало. Проверка занимает минут десять и состоит из трёх частей.

1. Список в Конфигураторе. Откройте Конфигурация → Расширения конфигурации: расширение есть, помечено как действующее.
2. Функциональность. Откройте объект, который меняет расширение: форму документа, отчёт, справочник. Проверьте новое поле, кнопку или команду. Ожидаемое поведение есть в описании от разработчика.
3. Журнал регистрации. Если что-то идёт не так, загляните в журнал: ошибки расширения идут с понятным текстом и с указанием модуля.

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

Мини-кейс: расширение для печатной формы

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

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

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

Типичные сбои делятся на три группы.

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

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

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

Что можно сделать самому:

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

Если текст ошибки упоминает конкретную процедуру, перешлите его разработчику целиком. По формулировке видно, какой объект не найден.

Обновление и удаление расширения

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

Порядок:

1. сделайте копию базы;
2. в окне расширений выделите нужное и загрузите новый файл;
3. нажмите F7 и дождитесь обновления;
4. проверьте основные сценарии.

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

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

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

Расширения в облачной версии 1С:Fresh

В облаке база работает под управлением сервиса, и права пользователя там ограничены. Самостоятельная загрузка .cfe для рядового пользователя обычно закрыта.

Что остаётся:

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

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

Безопасность при работе с расширениями

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

• 🛡️ Берите расширения у проверенных разработчиков и из официальных каталогов.
• 🔍 Просите описание изменений. Нормальный исполнитель расскажет, какие объекты затронуты.
• 🧪 Всегда проверяйте на копии, прежде чем ставить на рабочую базу.
• 🔒 Не отключайте безопасный режим и защиту от опасных действий без причины. Если отключить нужно, пусть разработчик объяснит зачем.
• 📝 Ведите список установленных расширений: название, версия, дата, кто ставил, зачем.

Расширение, которое просит выключить защиту и дать доступ к сети, требует отдельного разговора с разработчиком. Отказ от защиты оправдан редко.

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