Расширение, обработка или поставка: ставим модуль в 1С без поломки типовой
Содержание
Модуль в 1С 8.3 чаще всего ставят как расширение: файл .cfe загружают в Администрирование → Печатные формы, отчеты и обработки → Расширения кнопкой «Добавить из файла» и перезапускают программу. Внешнюю обработку
.epf подключают рядом, в разделе «Дополнительные отчеты и обработки». Конфигуратор нужен только для поставок в виде .cf.
Частая ошибка — сразу открывать Конфигуратор, снимать типовую с поддержки и вклеивать туда чужой код. Так поставить модуль в 1С можно, но каждое следующее обновление превратится в ручное сравнение. Правильный способ подключения зависит от того, в каком файле пришёл модуль.
Что называют модулем и какой способ выбрать
Слово «модуль» разработчики и продавцы используют широко. Под ним может скрываться три разных вещи, и устанавливаются они по-разному.
| Что прислали | Расширение файла | Где ставится | Трогает типовую? |
|---|---|---|---|
| Расширение конфигурации | .cfe | Режим «Предприятие» или Конфигуратор | Нет |
| Внешняя обработка или отчёт | .epf, .erf | Режим «Предприятие» | Нет |
| Поставка (доработанная конфигурация) | .cf, иногда .cfu | Только Конфигуратор | Да |
Расширения появились в платформе 8.3.6 и с тех пор стали основным способом дорабатывать типовые без вмешательства в их код. Если поставщик даёт выбор между .cfe и .cf, берите расширение.
Не знаете, что внутри архива? Посмотрите расширения файлов. Документация к модулю обычно лежит рядом и прямо говорит, куда его ставить.
Подготовка к установке модуля в базу 1С
Пять минут подготовки избавляют от отката базы из резервной копии.
- Проверьте версию платформы. Откройте
Справка → О программе(значок «i» в правом верхнем углу). Сравните номер с требованием из описания модуля: номер платформы должен быть не ниже указанного. - Проверьте релиз конфигурации. Там же, в окне «О программе», указан релиз. Расширение пишется под конкретный диапазон релизов: на сильно старой или новой типовой оно может не примениться.
- Узнайте, на поддержке ли типовая. В Конфигураторе:
Конфигурация → Поддержка → Настройка поддержки. Это важно для поставок.cf. - Сделайте резервную копию. В Конфигураторе:
Администрирование → Выгрузить информационную базу, получится файл.dt. Для клиент-серверной базы подойдёт и бэкап средствами СУБД. - Попробуйте на копии. Загрузите
.dtв пустую тестовую базу и поставьте модуль сначала туда.
Загрузку .dt выполняйте только в пустую тестовую базу: она полностью заменяет содержимое той базы, куда загружается.
Права тоже имеют значение. Добавлять расширения и дополнительные обработки может пользователь с ролью полных прав или администратора системы. Обычному бухгалтеру кнопка «Добавить из файла» будет недоступна.
Установка модуля-расширения из файла .cfe
Расширение ставится двумя путями. В режиме «Предприятие» это удобнее и не требует Конфигуратора.
Через режим «Предприятие»
- Зайдите в базу под администратором.
- Откройте
Администрирование → Печатные формы, отчеты и обработки. В БП 3.0, ЗУП 3.1 и УТ 11 раздел называется одинаково. - Если ссылки «Расширения» нет, включите одноимённый флажок на этой же странице.
- Перейдите по ссылке «Расширения» и нажмите «Добавить из файла».
- Укажите файл
.cfe. Программа покажет предупреждение о безопасности: если модуль из надёжного источника, подтвердите. - Проверьте в списке флажки «Активно» и «Безопасный режим» (о нём ниже).
- Перезапустите программу. Расширение начинает работать только в новых сеансах.
Если базой пользуются несколько человек, им тоже придётся перезайти. Предупредите коллег заранее, иначе часть из них будет работать без модуля до конца дня.
Через Конфигуратор
Этот путь нужен разработчику или когда в режиме «Предприятие» установка падает с непонятной ошибкой.
- Откройте
Конфигурация → Расширения конфигурации. - Нажмите «Добавить» и создайте пустое расширение. Имя можно оставить любое.
- Выделите его и через меню «Конфигурация» этого расширения выберите «Загрузить конфигурацию из файла
», указав
.cfe. - Выполните «Обновить конфигурацию базы данных» (клавиша F7) для расширения.
Монопольный доступ к базе для расширения обычно не нужен. Он понадобится, если вы меняете основную конфигурацию.
Безопасный режим и защита от опасных действий
У каждого расширения два флажка, о которых часто забывают:
- 🔒 Безопасный режим. Запрещает расширению работать с файлами на диске, COM-объектами и внешними программами. Модули обмена с сайтами, сканерами и банками в этом режиме падают.
- 🛡️ Защита от опасных действий. Показывает пользователю предупреждение при каждой потенциально опасной операции.
Снимайте «Безопасный режим» только у расширений, источнику которых вы доверяете. В описании модуля обычно сказано, нужен ли ему полный доступ.
Установка модуля через объединение с поставкой .cf
Если модуль пришёл как доработанная конфигурация, его ставят объединением. Это самый тяжёлый способ: после него типовая перестаёт обновляться «в один клик».
- Сделайте выгрузку
.dt(см. подготовку). - В Конфигураторе откройте
Конфигурация → Поддержка → Настройка поддержкии нажмите «Включить возможность изменения». Для объектов выберите режим «Объект поставщика редактируется с сохранением поддержки». - Выполните
Конфигурация → Сравнить, объединить с конфигурацией из файлаи укажите.cfпоставщика. - В окне сравнения отметьте только объекты модуля. Снимите галочки с типовых объектов, которые не должны меняться.
- Нажмите «Выполнить» и затем обновите конфигурацию базы данных (F7).
Для обновления конфигурации базы данных нужен монопольный доступ: все пользователи должны выйти из базы.
Перед шагом 5 сохраните отчёт о сравнении. Если через полгода придётся разбираться, что именно влили, он сэкономит много времени.
Если поставщик прислал полную .cf на другой релиз типовой, не загружайте её через «Загрузить конфигурацию из файла». Эта команда заменяет всю конфигурацию целиком, вместе с вашими доработками.
Модули при обновлении типовой конфигурации
Обновление типовой — момент, когда модули ломаются чаще всего. Поведение зависит от способа установки.
| Способ установки | Что происходит при обновлении |
|---|---|
Расширение .cfe | Типовая обновляется штатно. Расширение может перестать применяться, если изменились объекты, которые оно перехватывает |
| Внешняя обработка | Не затрагивается, но может сломаться, если в новом релизе переименованы реквизиты |
Объединение с .cf | Обновление идёт через сравнение и объединение, конфликты разбираются вручную |
Порядок действий при обновлении базы с расширениями:
- Перед обновлением сохраните текущий
.cfe: в Конфигураторе — команда «Сохранить конфигурацию в файл» для расширения. - Запросите у поставщика версию модуля под новый релиз типовой.
- Обновите программу: в режиме «Предприятие» через
Администрирование → Обслуживание → Обновление версии программыили в Конфигураторе черезКонфигурация → Поддержка → Обновить конфигурацию. - Запустите базу и проверьте, что расширение активно и не выдаёт предупреждений.
- Если старое расширение не применилось, загрузите новую версию поверх: в списке расширений есть команда обновления из файла.
Ставите модуль в базу, которую обновляли давно? Сначала обновите типовую до актуального релиза, потом ставьте модуль. Наоборот выйдет вдвое больше работы.
Подключение внешних обработок и отчётов
Внешние обработки — второй по популярности формат модулей. Это загрузка из Excel , печатные формы, сервисные утилиты.
Регистрация в программе
- Откройте
Администрирование → Печатные формы, отчеты и обработки. - Включите флажок «Дополнительные отчеты и обработки», если он снят.
- Перейдите по ссылке «Дополнительные отчеты и обработки» и нажмите «Добавить из файла».
- Укажите
.epfили.erf, подтвердите предупреждение о безопасности. - В карточке настройте размещение: в каких разделах появится команда.
- Для печатных форм укажите документы, к которым форма относится. Сохраните карточку.
После этого обработка появляется в разделе, например Продажи → Дополнительные обработки. Печатная форма — в меню «Печать» документа.
Без регистрации обработку никто не увидит. Это самая частая причина жалоб «поставили, а где она?».
Разовый запуск
Для обработки, которая нужна один раз, регистрация не обязательна. Откройте главное меню (кнопка с тремя полосками) → Файл → Открыть и выберите файл.
Но разовый запуск возможен, только если у пользователя есть право открывать внешние обработки. В типовых на БСП оно выдаётся отдельной ролью. В программе также появится предупреждение о защите от опасных действий.
Как проверить, что модуль подключён правильно
Проверка занимает пару минут и снимает половину будущих вопросов от пользователей:
- ✅ Модуль виден в списке расширений или дополнительных обработок, флажок «Активно» стоит.
- ✅ Его команды появились там, где обещает документация: в разделе, в меню «Печать», в форме документа.
- ✅ Тестовая операция прошла на копии базы, а не сразу на рабочей.
- ✅ Пользователь без прав администратора тоже видит команды модуля. Если не видит — дело в настройке размещения или в ролях.
- ✅ Файл модуля сохранён в папку с дистрибутивами вместе с номером версии и датой установки.
Последний пункт кажется мелочью, пока не понадобится откатиться на прошлую версию модуля после неудачного обновления.
Почему модуль не ставится или не работает
Большинство проблем после установки укладываются в несколько сценариев.
Два расширения конфликтуют
Если два модуля перехватывают одну и ту же процедуру типовой, второй может отменять действие первого. Признак: модуль работает, пока второй отключён. Порядок применения расширений задаётся в Конфигураторе. Если поменять его недостаточно, конфликт решает разработчик одного из модулей.
После установки всё зависает у одного пользователя
Иногда клиент держит старый кэш конфигурации. Закройте 1С на этом компьютере и запустите её с параметром /ClearCache в строке запуска. Кэш чистится только у этого пользователя, но его открытый сеанс при перезапуске закроется — сохраните документы перед этим.