Администрирование · 10 мин
Как загрузить внешнюю обработку в 1С
Как загрузить внешнюю обработку или отчёт в 1С: через меню Файл, справочник дополнительных отчётов и конфигуратор. Права, безопасный режим, ошибки.
Загрузка внешней обработки (файла с расширением .epf) или внешнего отчёта (.erf) в 1С — частая задача: так подключают печатные формы, загрузчики данных из Excel, обмены с банками и сервисные утилиты. Способ загрузки зависит от того, нужно ли просто один раз открыть файл или зарегистрировать обработку в базе, чтобы ею пользовались все сотрудники.
Есть три рабочих пути: открыть файл напрямую через меню «Файл», добавить обработку в справочник «Дополнительные отчеты и обработки» (в типовых конфигурациях на БСП) или встроить её в конфигурацию через конфигуратор. Первый вариант самый быстрый, второй — правильный для постоянного использования, третий — для разработчиков.
Перед загрузкой убедитесь, что файл получен из надёжного источника: внешняя обработка выполняет произвольный код внутри вашей базы и имеет доступ ко всем данным, к которым есть доступ у текущего пользователя.
Проверка прав и подготовка перед загрузкой
Для открытия внешнего файла достаточно обычных пользовательских прав — платформа не запрещает запускать .epf-файлы как обычное приложение. Однако регистрация обработки в справочнике дополнительных отчётов и обработок доступна только пользователям с правами администратора или ролью «Добавление и изменение дополнительных отчетов и обработок».
Если база работает в клиент-серверном режиме под управлением Windows с профилями безопасности, администратор кластера мог запретить запуск внешних обработок без безопасного режима. В этом случае при открытии файла появится предупреждение, а часть функций (доступ к файловой системе, COM-объектам) будет заблокирована.
Проверьте также совместимость: обработка, написанная для обычных форм (режим «Обычное приложение»), не откроется в тонком клиенте с управляемыми формами, и наоборот. Признак несовместимости — ошибка «Метод объекта не обнаружен» или пустое окно при открытии.
Способ 1. Открыть обработку через меню «Файл»
Этот вариант подходит, когда обработку нужно запустить один раз: например, выполнить разовую загрузку данных или проверить работу файла перед регистрацией в базе.
Порядок действий одинаков для большинства конфигураций на управляемых формах (УТ 11, ERP, Бухгалтерия 3.0, ЗУП 3.1):
- 1Сохраните файл .epf или .erf на компьютере в доступной папке.
- 2В окне 1С откройте меню «Файл» (в левом верхнем углу) и выберите пункт «Открыть».
- 3Укажите путь к файлу обработки и нажмите «Открыть».
- 4Если появилось предупреждение системы безопасности, подтвердите запуск, только если доверяете источнику файла.
- 5Проверьте, что форма обработки открылась и её команды выполняются без ошибок.
Открытая таким способом обработка живёт только в текущем сеансе: после закрытия окна её нужно открывать заново. Для удобства файл можно положить в общую сетевую папку, чтобы коллеги открывали его по тому же пути.
Способ 2. Зарегистрировать в «Дополнительных отчетах и обработках»
Это штатный механизм типовых конфигураций на базе Библиотеки стандартных подсистем. Зарегистрированная обработка хранится внутри базы, доступна всем пользователям с нужными правами, может быть привязана к конкретным документам и справочникам (например, дополнительная печатная форма появится в меню «Печать» конкретного документа).
Сначала включите сам механизм. Перейдите в раздел «Администрирование» → «Печатные формы, отчеты и обработки» и установите флажок «Дополнительные отчеты и обработки». После этого в том же разделе появится одноимённая команда открытия списка.
- 1Откройте «Администрирование» → «Печатные формы, отчеты и обработки» → «Дополнительные отчеты и обработки».
- 2Нажмите «Добавить из файла» (или «Создать» и укажите файл).
- 3Выберите файл .epf/.erf. Если обработка содержит встроенные сведения о регистрации, поля заполнятся автоматически.
- 4Проверьте вид обработки: «Дополнительная обработка», «Заполнение объекта», «Отчет» или «Печатная форма».
- 5На закладке «Размещение» укажите разделы или объекты, где обработка будет доступна.
- 6Нажмите «Записать и закрыть» и проверьте появление обработки в нужном разделе.
Если при добавлении файла появляется сообщение о том, что обработка не содержит сведений для регистрации, это значит, что разработчик не реализовал функцию «СведенияОВнешнейОбработке». Такой файл всё равно можно добавить, выбрав вид вручную, но часть возможностей (автоматическое размещение, команды) будет недоступна.
Способ 3. Встроить обработку в конфигурацию
Если обработка нужна постоянно и должна обновляться централизованно вместе с конфигурацией, её встраивают через конфигуратор. Это работа для разработчика или внедренца, особенно если конфигурация находится на поддержке без возможности изменения.
Действия: откройте конфигуратор, включите возможность изменения конфигурации (Конфигурация → Поддержка → Настройка поддержки), затем в дереве конфигурации найдите ветку «Обработки» (или «Отчеты»), вызовите контекстное меню и выберите «Добавить» → «Вставить внешнюю обработку (отчет)». Укажите файл — его модуль и формы будут перенесены в конфигурацию. После этого обновите конфигурацию базы данных (F7).
Учтите: встраивание снимает объект с полной поддержки, что усложнит будущие обновления конфигурации. Для типовых решений предпочтительнее способ 2 — дополнительные обработки не затрагивают конфигурацию и не мешают обновлению.
Сравнение способов загрузки
Быстро, без прав администратора. Подходит для разового запуска. Обработка не хранится в базе.
Штатный вариант для постоянной работы. Хранится в базе, доступна пользователям по правам, не мешает обновлениям. Требует прав администратора.
Для доработок на уровне конфигурации. Требует снятия с поддержки и навыков разработки.
Загрузка данных из Excel и других файлов через обработки
Частая ситуация, стоящая за запросом «загрузить в 1С», — это загрузка данных: номенклатуры, цен, контрагентов из Excel или CSV. Здесь внешняя обработка выступает инструментом: вы открываете её одним из способов выше, а уже внутри указываете файл с данными.
Многие типовые конфигурации имеют встроенные загрузчики: в УТ 11 и ERP это «Загрузка данных из файла» в карточке списка номенклатуры, в Бухгалтерии — загрузка выписки банка и номенклатуры из Excel. Сначала проверьте штатные возможности — они не требуют ни внешних файлов, ни дополнительных прав.
При использовании стороннего загрузчика обязательно проверьте результат на небольшой порции данных: загрузите 5–10 строк, убедитесь, что единицы измерения, ставки НДС и контрагенты сопоставились корректно, и только потом загружайте весь файл.
Как проверить результат загрузки
Записи заполнены, дубли не созданы, реквизиты на месте
Пустые наименования, задвоения, неверные единицы измерения
Документы проводятся, движения по регистрам корректны
Ошибки проведения, незаполненные счета учёта
Нет ошибок, связанных с обработкой
Серии ошибок «Ошибка выполнения» после запуска
Типичные ошибки и их решение
Большинство проблем при загрузке внешних обработок сводится к нескольким повторяющимся ситуациям. Ниже — самые частые.
Если при открытии файла появляется ошибка «Ошибка формата потока», файл повреждён при скачивании или создан в другой версии платформы. Скачайте его заново или запросите у разработчика сборку под вашу версию платформы.
Что важно запомнить
Разовый запуск — через «Файл → Открыть», постоянная работа — через «Дополнительные отчеты и обработки» с включённой опцией в «Администрировании». Встраивание в конфигурацию оставьте разработчику. Перед запуском любой внешней обработки проверяйте источник и делайте резервную копию базы.
Частые вопросы
Не вижу пункт «Дополнительные отчеты и обработки» в меню. Что делать?
Механизм выключен. Откройте «Администрирование» → «Печатные формы, отчеты и обработки» и установите флажок «Дополнительные отчеты и обработки». Если раздела «Администрирование» нет совсем — у вас недостаточно прав, обратитесь к администратору базы.
Можно ли загрузить обработку без прав администратора?
Открыть файл через «Файл → Открыть» можно с обычными пользовательскими правами. Зарегистрировать обработку в справочнике дополнительных обработок — нет, для этого нужны права администратора или специальная роль.
Обработка открылась, но окно пустое или появилась ошибка. В чём причина?
Чаще всего обработка написана под обычные формы, а вы работаете в управляемом приложении. Нужна версия обработки под управляемые формы либо запуск толстого клиента в режиме обычного приложения. Также проверьте совместимость с версией вашей конфигурации.
Безопасно ли открывать .epf-файлы из интернета?
Нет гарантий безопасности: внешняя обработка исполняет произвольный код с правами текущего пользователя. Загружайте файлы только от разработчиков, которым доверяете, и перед операциями, изменяющими данные, создавайте резервную копию базы.
Как удалить ранее загруженную обработку из базы?
Откройте «Администрирование» → «Дополнительные отчеты и обработки», найдите обработку в списке и пометьте её на удаление. Затем выполните «Операции» → «Удаление помеченных объектов», чтобы удалить её окончательно.
Обработка требует отключить безопасный режим. Это нормально?
Безопасный режим ограничивает доступ к файловой системе и внешним компонентам. Некоторым обработкам (например, загрузчикам файлов) он действительно мешает, но отключать его стоит только для проверенных файлов. В клиент-серверных базах это право настраивает администратор кластера.