Внешние обработки, отчёты и расширения: три способа подключить файл к базе 1С

Чтобы установить обработку в 1С 8.3 на один раз, откройте файл .epf через главное меню: Файл → Открыть (или Ctrl+O). Чтобы обработка осталась в программе насовсем и была доступна всем пользователям, добавьте её в Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки кнопкой «Добавить из файла». Если вам прислали файл .cfe, это не обработка, а расширение — оно ставится в соседнем пункте того же раздела.

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

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

Сначала определите, что у вас в руках. От расширения файла зависит способ установки.

Дальше короткий список проверок.

• 🔐 Права. Нужна роль, разрешающая интерактивное открытие внешних обработок и отчётов. В типовых конфигурациях она есть у профиля «Администратор». У бухгалтера с урезанным профилем её обычно нет.
• 🧩 Источник файла. Обработка выполняет код в вашей базе. Она может изменить и удалить данные. Берите файлы только у разработчика, которому доверяете, или у поставщика сервиса (банк, маркетплейс, оператор ЭДО).
• 📌 Совместимость. Разработчик обычно указывает, для какой конфигурации и с какого релиза работает обработка. Печатная форма для БП 3.0 не заработает в УТ 11.
• 🖥️ Тип формы. Файлы, сделанные под обычные формы (старый интерфейс 8.2), в управляемом интерфейсе «Такси» не откроются или откроются без формы. Нужна версия под управляемые формы.
• 💾 Копия базы. Если обработка массово меняет документы или справочники, сделайте резервную копию перед первым запуском. Для отчёта или печатной формы копия не нужна — они ничего не записывают.

Разовый запуск: открыть обработку через меню «Файл»

Этот способ подходит, когда обработку нужно выполнить один-два раза: загрузить остатки, исправить реквизиты, выгрузить список.

1. Запустите базу в режиме 1С:Предприятие.
2. Нажмите кнопку главного меню — значок с тремя полосками в левом верхнем углу окна.
3. Выберите Файл → Открыть или нажмите Ctrl+O.
4. Укажите файл .epf или .erf и нажмите «Открыть».
5. Платформа покажет предупреждение безопасности: файл может содержать опасный код. Если источник проверенный — подтвердите открытие.
6. Откроется форма обработки. Дальше работайте по инструкции разработчика.

Обработка не сохраняется в базе. После закрытия окна её снова придётся открывать из файла.

Что меняется в свежих релизах

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

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

Как открыть файл в веб-клиенте и через RDP

• 🌐 Веб-клиент и 1С:Фреш. Файл сначала загружается на сервер. В облачных сервисах открытие произвольных внешних файлов обычно запрещено, обработку подключают только через справочник дополнительных обработок, и часто она проходит проверку провайдера.
• 🖧 Терминальный сервер . Путь к файлу указывается на сервере, а не на вашем ноутбуке. Скопируйте файл в папку, видимую из сеанса, иначе в диалоге открытия его не будет.

Постоянная установка: справочник дополнительных отчётов и обработок

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

Шаг 1. Включите дополнительные обработки

Откройте Администрирование → Печатные формы, отчеты и обработки. Поставьте флажок «Дополнительные отчеты и обработки». Под ним станет активной ссылка на одноимённый список.

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

1. Перейдите по ссылке «Дополнительные отчеты и обработки».
2. Нажмите «Добавить из файла».
3. Подтвердите предупреждение безопасности.
4. Выберите файл .epf или .erf.

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

Шаг 3. Настройте, где появится команда

Вид обработки определяет, что заполнять в карточке.

У печатных форм и команд заполнения объекты часто уже указаны разработчиком. Проверьте список и уберите лишнее.

Шаг 4. Выдайте доступ и запишите

В карточке есть настройка быстрого доступа к командам — укажите пользователей, у которых команда будет видна. Нажмите «Записать и закрыть». Перезапускать программу не нужно, но открытые формы документов лучше закрыть и открыть заново.

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

• 🖨️ Печатная форма: откройте любой документ нужного вида → кнопка «Печать» — в списке должна быть новая форма.
• 📊 Отчёт или обработка: зайдите в раздел, выбранный в «Размещении», и найдите в панели навигации пункт «Дополнительные отчеты» или «Дополнительные обработки».
• 🧾 Заполнение: в форме документа появится команда в меню заполнения.

Встроенные обработки конфигурации: режим «Все функции»

Не всякая обработка — внешний файл. В каждой типовой конфигурации есть десятки встроенных: «Групповое изменение реквизитов», «Удаление помеченных объектов», «Поиск и удаление дублей», «Универсальный обмен данными». Их не нужно устанавливать, достаточно включить расширенное меню.

1. Главное меню → Сервис → Параметры.
2. Поставьте флажок «Отображать команду “Все функции”».
3. Нажмите «Применить».
4. В главном меню появится пункт «Все функции». В нём — ветка «Обработки» со всеми встроенными обработками конфигурации.

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

Расширение конфигурации: когда обработки недостаточно

Внешняя обработка не может добавить реквизит в документ, поменять форму или поведение проведения. Для этого разработчики делают расширение — файл .cfe. Механизм расширений появился в платформе 8.3.6 и позволяет дорабатывать типовую базу, не снимая её с поддержки.

Установка расширения в режиме Предприятия

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

В списке расширений у каждой строки есть флажки «Безопасный режим» и «Защита от опасных действий». Если разработчик пишет, что расширению нужен небезопасный режим (например, оно работает с файлами на диске или внешними компонентами), снимайте флажок только после проверки источника.

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

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

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

Встраивать обработку в саму конфигурацию — почти никогда

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

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

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

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

Почему обработка не устанавливается: ошибки и решения

«Нарушение прав доступа» при открытии файла

У пользователя нет права на интерактивное открытие внешних обработок и отчётов. Решение — открыть файл под администратором или добавить обработку в справочник дополнительных обработок и выдать быстрый доступ конкретному сотруднику. Расширять права всей группы ради одной обработки не стоит.

Файл открывается, но вместо формы — пустое окно или ошибка формы

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

«Добавить из файла» отказывается подключать обработку

Причины три:

• в файле нет программного интерфейса регистрации БСП — такую обработку можно открыть только через меню «Файл»;
• обработка написана для другой конфигурации или для более раннего релиза БСП;
• файл повреждён при пересылке (архив распакован не полностью, почтовый фильтр обрезал вложение).

Проверьте размер файла и попросите прислать его заново, упакованным в zip.

Команда добавлена, но её не видно

• Не заполнено размещение — обработка зарегистрирована, но ни в одном разделе не показана.
• Пользователь не отмечен в быстром доступе.
• Форма документа была открыта до регистрации — закройте её и откройте снова.
• Карточка обработки в состоянии «Отключена».

После обновления конфигурации печатная форма перестала работать

Внешняя обработка обращается к реквизитам документов по именам. Если в новом релизе реквизит переименовали, она падает с ошибкой «Поле объекта не обнаружено». Нужна обновлённая версия файла от разработчика, после неё — «Обновить из файла» в карточке.

Расширение не применилось

Не перезапущен сеанс, либо в списке расширений снят флажок «Активно», либо после загрузки в Конфигураторе не выполнено обновление конфигурации базы данных. Если расширение было сделано под другой релиз, платформа покажет ошибку применения при запуске — нужна новая версия .cfe.

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