Расширение, внешняя обработка или файл .cf: подключаем доработку к базе 1С
Содержание
Чтобы установить модуль
в 1С:Предприятие 8.3, сначала посмотрите на расширение файла. Расширение конфигурации
.cfe добавляют прямо в программе: Администрирование → Печатные формы, отчеты и обработки → Расширения → Добавить из файла, затем перезапускают 1С. Внешнюю обработку
.epf или отчёт .erf подключают там же, в списке «Дополнительные отчеты и обработки». Файл .cf ставят только через Конфигуратор и только с объединением конфигураций.
Пользовательский режим подходит для одной базы и одного модуля — это пять минут без Конфигуратора. Конфигуратор нужен, когда расширение меняет структуру данных или поставщик требует снять защитные флажки. Командная строка выручает, если модуль надо раскатать на десяток баз за вечер.
Что проверить перед установкой модуля
«Модулем» поставщики называют разные вещи. От формата файла зависит и способ установки, и риск для базы.
| Файл | Что это | Где ставится | Риск для типовой |
|---|---|---|---|
.cfe | Расширение конфигурации | Пользовательский режим или Конфигуратор | Низкий: типовая не меняется |
.epf | Внешняя обработка (в т.ч. печатная форма, заполнение) | Пользовательский режим | Низкий |
.erf | Внешний отчёт | Пользовательский режим | Низкий |
.cf | Конфигурация или её часть | Только Конфигуратор, объединение | Высокий: правится типовая, сложнее обновлять |
Перед установкой пройдите короткий список.
- 🔢 Версия конфигурации. Поставщик обычно пишет, под какие релизы собран модуль. Откройте
Справка → О программе(кнопка с вопросительным знаком в правом верхнем углу) и сравните номер релиза. - 🧩 Версия платформы. Расширения появились в 8.3.6, а добавлять в них свои справочники и документы стало можно в более поздних версиях. Номер платформы в базе должен быть не ниже указанного в требованиях модуля.
- 👤 Права. Добавлять расширения и дополнительные обработки может пользователь с полными правами или с отдельной ролью на администрирование расширений.
- 💾 Резервная копия. Нужна, если модуль добавляет свои данные или ставится через
.cf. Для внешнего отчёта, который только читает данные, копию можно не делать.
Сначала поставьте модуль в копию базы. В файловом варианте это копия папки с 1Cv8.1CD, в клиент-серверном — выгрузка .dt и загрузка в отдельную тестовую базу.
Как установить расширение в режиме 1С:Предприятие
Это основной путь для .cfe. Конфигуратор не нужен, базу не надо выгонять в монопольный режим.
Где находится список расширений
Путь зависит от конфигурации, но раздел один и тот же — «Печатные формы, отчеты и обработки».
| Конфигурация | Путь |
|---|---|
| Бухгалтерия предприятия 3.0 | Администрирование → Печатные формы, отчеты и обработки → Расширения |
| ЗУП 3.1 | Администрирование → Печатные формы, отчеты и обработки → Расширения |
| Управление торговлей 11 | НСИ и администрирование → Печатные формы, отчеты и обработки → Расширения |
| Любая конфигурация | Главное меню → Все функции → Стандартные → Управление расширениями конфигурации |
Последняя строка — универсальный вариант платформы. Если пункта «Все функции» нет в главном меню, включите его: Главное меню → Сервис → Параметры, флажок «Отображать команду “Все функции”».
Пошагово
- Откройте список расширений по пути из таблицы.
- Нажмите Добавить из файла и выберите файл
.cfe. - Программа покажет предупреждение о безопасности. Прочитайте его и подтвердите, если файл получен от известного поставщика.
- Расширение появится в списке. Проверьте колонку «Активно» — флажок должен стоять.
- Нажмите Перезапустить или закройте 1С и откройте снова. Без перезапуска сеанса расширение не подключится.
После перезапуска новые команды появятся в тех разделах, которые указал разработчик. Если модуль меняет печатные формы, откройте любой документ и проверьте меню «Печать».
Флажки «Безопасный режим» и «Защита от опасных действий»
По умолчанию расширение, добавленное из файла, работает в безопасном режиме. Ему запрещены операции вне базы: запись файлов на диск, COM-объекты, запуск внешних программ, обращения к интернету без разрешения.
Многим модулям этого хватает. Но если расширение загружает выписки из папки, обменивается с сайтом или работает с оборудованием, поставщик попросит снять флажок «Безопасный режим». Делайте это осознанно:
Расширение без безопасного режима получает те же возможности, что и код типовой конфигурации. Снимайте флажок только для модулей из проверенного источника, и лучше после проверки в копии базы.
Флажок «Защита от опасных действий» отвечает за предупреждение при открытии потенциально опасного кода. Снимать его без требования поставщика незачем.
Подключение внешних обработок и отчётов (.epf и .erf)
Внешние файлы можно открыть разово или подключить постоянно. Разовое открытие — для проверки, постоянное — для ежедневной работы.
Разовое открытие
Главное меню → Файл → Открыть, выберите файл .epf или .erf. Обработка откроется в отдельном окне и будет доступна до закрытия сеанса.
Так удобно проверить обработку от коллеги. Но у пользователей без административных прав этот путь чаще всего закрыт: в типовых конфигурациях право на интерактивное открытие внешних файлов выдают только администраторам.
Постоянное подключение через «Дополнительные отчеты и обработки»
- Откройте
Администрирование → Печатные формы, отчеты и обработки(в УТ 11 —НСИ и администрирование). - Включите флажок «Дополнительные отчеты и обработки», если он снят.
- Перейдите по одноимённой ссылке и нажмите Создать (или Добавить из файла, в зависимости от релиза).
- Выберите файл. Программа сама прочитает вид модуля: печатная форма, заполнение табличной части, дополнительный отчёт, глобальная обработка.
- На вкладке «Размещение» или в поле разделов укажите, где показывать команду. Для печатных форм выберите документы, к которым она относится.
- В блоке «Быстрый доступ» отметьте пользователей, у которых команда появится сразу.
- Нажмите Записать и закрыть.
Печатная форма появится в меню «Печать» нужного документа. Глобальная обработка — в разделе, который вы указали, в подменю дополнительных обработок.
Если программа пишет, что файл не совместим с механизмом дополнительных обработок, значит, разработчик не встроил в него регистрационные сведения. Такой файл можно открыть только разово через Файл → Открыть.
Установка модуля через Конфигуратор
Конфигуратор нужен в трёх случаях: модуль поставляется как .cf, поставщик требует настройки свойств расширения, которых нет в пользовательском режиме, или в базе не работает
пользовательский интерфейс расширений.
Расширение .cfe
- Запустите базу в режиме «Конфигуратор» и откройте конфигурацию:
Конфигурация → Открыть конфигурацию. - Выберите
Конфигурация → Расширения конфигурации. - В окне списка нажмите Добавить, задайте имя расширения. Имя берите из инструкции поставщика: некоторые модули проверяют его при обновлении.
- Выделите новое расширение и загрузите в него файл
.cfe: в меню действий окна расширений есть команда загрузки конфигурации расширения из файла. - Обновите конфигурацию базы данных для расширения:
Конфигурация → Конфигурация расширения → Обновить конфигурацию базы данныхилиF7в открытом дереве расширения. - В свойствах расширения в списке проверьте «Активно», «Безопасный режим», «Защита от опасных действий».
Загрузка файла и обновление конфигурации БД — разные шаги. Если пропустить второй, расширение будет в списке, но в режиме Предприятия не применится.
Модуль в формате .cf
Файл .cf с доработкой встраивают в основную конфигурацию через Конфигурация → Сравнить, объединить с конфигурацией из файла. Для этого типовую придётся снять с полной поддержки или включить возможность изменения.
После объединения каждое обновление типовой будет проходить через сравнение и ручной разбор конфликтов. Если поставщик предлагает тот же модуль в виде расширения .cfe — берите расширение.
Если .cf — это целая отраслевая конфигурация, а не доработка, речь уже не об установке модуля, а о переходе на другую конфигурацию. Это отдельный проект с переносом данных.
Автоматическая установка расширения из командной строки
Пакетный режим Конфигуратора позволяет загрузить одно расширение в несколько баз без ручных кликов. Ключ -Extension указывает, что команда работает с расширением, а не с основной конфигурацией.
Пример для клиент-серверной базы:
set V8="C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe"
set BASE=/S"srv1c\buh"
set USR=/N"Администратор" /P"пароль"
%V8% DESIGNER %BASE% %USR% /DisableStartupDialogs /LoadCfg "D:\modules\Dorabotki.cfe" -Extension "Доработки" /Out "D:\modules\load.log"
%V8% DESIGNER %BASE% %USR% /DisableStartupDialogs /UpdateDBCfg -Extension "Доработки" /Out "D:\modules\update.log"
Для файловой базы замените /S"srv1c\buh" на /F"D:\Bases\Buh". Путь к 1cv8.exe подставьте свой: номер версии в нём — это каталог установленной платформы.
Что важно в скрипте:
- 📝
/Outпишет журнал. После прогона откройте его: пустой журнал или сообщения без ошибок — признак успешной загрузки. - 🔁 Для нескольких баз оберните команды в цикл
forпо списку строк подключения. - 🔐 Пароль в bat-файле храните только на защищённом сервере и удаляйте скрипт после использования.
- 🕗 Запускайте вне рабочего времени. Сеансы пользователей увидят расширение только после перезапуска.
Выгрузить установленное расширение обратно в файл можно командой /DumpCfg "файл.cfe" -Extension "Имя". Это полезно, чтобы сохранить работающую версию перед обновлением модуля.
Права пользователей и лицензия модуля
Кому что разрешено
| Действие | Кто может |
|---|---|
| Добавить, удалить, отключить расширение | Администратор (полные права или роль администрирования расширений) |
| Подключить дополнительную обработку | Администратор или пользователь с ролью на добавление дополнительных отчётов и обработок |
| Пользоваться командами расширения | Все, кому разработчик выдал роли расширения |
| Пользоваться дополнительной обработкой | Пользователи из списка «Быстрый доступ» или те, кто добавил команду себе сам |
Если расширение принесло свои роли, их надо назначить. В БП 3.0 и ЗУП 3.1 это делается через группы доступа: Администрирование → Настройки пользователей и прав → Группы доступа, а нужные роли добавляют в профиль группы. В режиме «Полные права» роли расширений обычно не требуются, но обычный бухгалтер без них команд не увидит.
Лицензия на сторонний модуль
Лицензия платформы 1С и лицензия на сторонний модуль — разные вещи. Платформа без своей лицензии базу не запустит (кроме учебной версии), а модуль защищает уже его разработчик.
Встречаются три схемы:
- 🔑 Система лицензирования и защиты конфигураций (СЛК). На сервер ставится отдельный сервер лицензий, модуль получает лицензию от него. Без доступного сервера СЛК защищённые функции не работают.
- 📄 Активация ключом или кодом. После первого запуска модуль просит ввести регистрационный номер или пин-код из письма поставщика.
- 🌐 Онлайн-проверка. Модуль сверяет подписку с сервером разработчика. Ему нужен доступ в интернет и, как правило, снятый безопасный режим.
Код ключа, сервер лицензий и порядок переноса на новый компьютер уточняйте у поставщика. Эти параметры нигде в типовой конфигурации не описаны.
Если модуль не установился или не работает
Большинство проблем видно сразу после перезапуска: команды нет, расширение выключено или 1С выдаёт сообщение об ошибке.
Как обновлять типовую без поломки модулей
Главная беда расширений — обновление основной конфигурации. Модуль собран под конкретные формы и объекты, а новый релиз их меняет.
- Перед обновлением типовой выгрузите расширения в файлы, чтобы иметь рабочую копию.
- Обновите копию базы и проверьте, применяются ли расширения после обновления.
- Если расширение не применилось, запросите у поставщика версию под новый релиз и только потом обновляйте рабочую базу.
Такой порядок занимает лишний вечер, зато бухгалтерия не остаётся без привычной печатной формы в день сдачи отчётности.