Автоматизация · 10 мин
Как подключить обработку в 1С: открытие файла и регистрация в базе
Как подключить обработку в 1С через «Дополнительные отчеты и обработки», открыть файл EPF вручную, настроить права и безопасный режим. Частые ошибки и решения.
Внешняя обработка в 1С — это файл с расширением EPF, который добавляет в программу новые функции: массовую загрузку данных, печатные формы, обмен с банком, свертку базы и другие операции, которых нет в типовой конфигурации. Подключить обработку можно двумя способами: просто открыть файл для разового использования или зарегистрировать его в базе, чтобы он стал постоянным инструментом с настраиваемыми правами доступа.
Разовое открытие подходит, когда обработку нужно запустить один раз — например, проверить данные или выполнить разовую загрузку. Регистрация через механизм «Дополнительные отчеты и обработки» нужна, если инструментом будут пользоваться регулярно несколько сотрудников: так обработка появится в интерфейсе программы, ей можно назначить права и расписание автоматического запуска.
Ниже разобраны оба способа, требования к правам, типичные ошибки при подключении и способы проверить, что обработка работает корректно. Инструкции применимы к конфигурациям на управляемых формах — «1С:Бухгалтерия 8», «1С:Управление торговлей 11», «1С:ERP», «1С:Зарплата и управление персоналом» и другим решениям на базе Библиотеки стандартных подсистем.
Что потребуется перед подключением
Для подключения обработки нужен сам файл с расширением EPF (для управляемого приложения) и права в базе 1С. Полные права или роль «Администратор системы» требуются для регистрации обработки в справочнике дополнительных отчетов и обработок. Для простого открытия файла достаточно обычных пользовательских прав, если администратор не запретил интерактивное открытие внешних файлов.
Проверьте источник обработки. Файл EPF содержит исполняемый код на встроенном языке 1С, и он выполняется с правами текущего пользователя базы. Обработка из непроверенного источника может изменить или удалить данные, отправить их наружу, если в базе не ограничены сетевые вызовы. Безопасные источники — официальный портал 1С, диск ИТС, разработчик, с которым у организации есть договор.
Перед любым подключением обработки, которая изменяет данные (групповая обработка документов, загрузка, свертка), сделайте резервную копию базы. Для файловой базы достаточно скопировать каталог или выгрузить базу через конфигуратор в файл DT. Для клиент-серверной базы резервную копию делает администратор средствами СУБД.
Способ 1. Открыть обработку для разового запуска
Самый быстрый способ — открыть файл напрямую из интерфейса программы. Зайдите в базу под своим пользователем, откройте главное меню (кнопка со значком стрелки в левом верхнем углу) и выберите «Файл → Открыть». Укажите путь к файлу EPF на диске или в сетевой папке и подтвердите открытие.
Обработка откроется в отдельном окне, и с ней можно работать как с обычным инструментом. После закрытия окна обработка из базы исчезает — никаких следов в конфигурации она не оставляет. Это удобно для диагностических и проверочных обработок, которые не изменяют данные.
- 1Сохраните файл EPF в доступную папку на компьютере или сетевом диске
- 2В 1С откройте главное меню и выберите «Файл → Открыть»
- 3Укажите файл обработки и нажмите «Открыть»
- 4При появлении предупреждения безопасности подтвердите открытие, если источнику доверяете
- 5Выполните нужные действия в окне обработки и проверьте результат
Если при открытии появляется сообщение о том, что открытие внешних файлов запрещено, значит администратор ограничил интерактивное открытие обработок через профили групп доступа или механизм защиты от опасных действий. В этом случае обратитесь к администратору или используйте регистрацию через справочник дополнительных обработок.
Способ 2. Зарегистрировать обработку в базе
Регистрация делает обработку постоянной частью программы: она появится в списке доступных инструментов, ей можно назначить права, разместить в разделах интерфейса и настроить автоматическое выполнение по расписанию. Сначала нужно включить сам механизм.
Перейдите в раздел «Администрирование → Печатные формы, отчеты и обработки» (в некоторых конфигурациях — «Администрирование → Общие настройки»). Установите флажок «Дополнительные отчеты и обработки». После этого в интерфейсе появится команда перехода к одноименному списку.
Откройте список «Дополнительные отчеты и обработки» и нажмите «Создать». Программа предложит выбрать файл — укажите EPF-файл обработки. 1С прочитает сведения из модуля обработки: наименование, версию, вид (заполнение объекта, печатная форма, дополнительная обработка и т.д.) и список команд. Если обработка написана по стандарту БСП, все поля заполнятся автоматически.
После записи элемента справочника назначьте размещение: в каких разделах интерфейса будет видна команда обработки и для каких объектов она доступна (если это обработка заполнения или печатная форма). Проверьте права: пользователи увидят обработку только в тех разделах, к которым у них есть доступ.
Настройка прав и безопасного режима
По умолчанию дополнительные обработки выполняются в безопасном режиме: в нем запрещены операции с файловой системой, COM-объектами, внешними компонентами и запуском приложений. Если обработка честно работает только с данными базы, безопасный режим ей не мешает. Если ей нужен доступ к файлам или внешним системам, при регистрации можно снять флажок безопасного режима — но делать это следует осознанно.
Как выбрать режим и способ
Права на запуск зарегистрированных обработок раздаются через профили групп доступа. Администратор может разрешить конкретной группе пользователей видеть и выполнять только определенные обработки, а остальные скрыть. Это стандартный способ разграничить, например, обработки загрузки банковских выписок для бухгалтерии и обработки ценообразования для менеджеров.
Как проверить, что обработка подключилась корректно
После регистрации откройте раздел, в который назначено размещение обработки, и убедитесь, что команда появилась в меню «Дополнительные обработки» или в списке команд объекта. Запустите обработку под обычным пользователем, а не под администратором: это покажет, хватает ли прав у целевой аудитории.
Если обработка изменяет данные, выполните тест на одном-двух объектах и проверьте результат вручную: откройте измененный документ или элемент справочника и сравните с ожидаемым. Только после успешного теста запускайте массовую обработку.
Как проверить результат
Обработка видна в назначенном разделе под обычным пользователем
Команды нет — не назначено размещение или не хватает прав
Форма открывается без ошибок, команды выполняются
Ошибка «Метод объекта не обнаружен» или отказ в безопасном режиме
Данные изменены как ожидалось, журнал регистрации без ошибок
Данные не изменились или изменились частично
Частые ошибки при подключении
Наиболее частая проблема — сообщение «Невозможно подключить дополнительный отчет из файла» при регистрации. Причина почти всегда одна: обработка не содержит функции СведенияОВнешнейОбработке(), то есть не адаптирована под механизм БСП. Такой файл можно только открывать вручную либо доработать в конфигураторе, добавив стандартный программный интерфейс.
Вторая типичная ситуация — обработка зарегистрирована, но пользователи ее не видят. Проверьте размещение по разделам в карточке обработки и профиль групп доступа пользователя. Третья ошибка — обработка падает с ошибкой привилегированных операций или доступа к файлам: значит ей нужен запуск вне безопасного режима, который включил не каждый администратор.
FAQ
Чем файл EPF отличается от расширения конфигурации CFE?
EPF — внешняя обработка, самостоятельный файл, который не меняет конфигурацию и работает со своей формой и кодом. CFE — расширение конфигурации: оно встраивается в базу, может изменять типовые формы, модули и роли. Для добавления разовых инструментов достаточно EPF; для изменения поведения типовых объектов нужно расширение.
Можно ли подключить обработку в базовой версии 1С?
Открытие внешних обработок через «Файл → Открыть» в базовых версиях обычно доступно, но механизм дополнительных отчетов и обработок и расширения конфигурации в базовых поставках ограничены или отсутствуют. Точные ограничения зависят от конкретной базовой конфигурации — проверьте документацию к своей поставке.
Почему обработка просит отключить защиту от опасных действий?
При открытии файлов платформа показывает предупреждение безопасности. Если пользователь нажимает «Нет», обработка не открывается. Отключать защиту глобально не стоит: достаточно подтверждать открытие для доверенных файлов. Администратор может настроить поведение через параметр конфигурации или реестр.
Как настроить автоматический запуск обработки по расписанию?
В карточке зарегистрированной дополнительной обработки для команды можно указать вариант запуска «Вызов серверного метода» и настроить расписание в разделе регламентных заданий. Это работает только для обработок, у которых команда предусматривает серверное выполнение без открытия формы.
Обработка открылась, но кнопки не работают. Что проверить?
Чаще всего обработка написана под другую версию конфигурации или обычные формы, а открыта в управляемом приложении. Проверьте, для какой конфигурации и режима она разработана. Также посмотрите журнал регистрации: там фиксируются ошибки выполнения с указанием строки модуля.
Нужно ли переподключать обработку после обновления конфигурации?
Зарегистрированные дополнительные обработки хранятся в базе и при обновлении конфигурации сохраняются. Однако после обновления стоит проверить их работоспособность: если в новой версии изменились объекты метаданных, к которым обращается обработка, она может начать выдавать ошибки и потребовать доработки.
Что важно запомнить
Разовый запуск — через «Файл → Открыть», постоянная работа — через регистрацию в «Дополнительных отчетах и обработках» с включенной опцией в администрировании. Регистрируются только обработки с функцией СведенияОВнешнейОбработке. Перед запуском обработок, меняющих данные, делайте резервную копию и проверяйте результат под обычным пользователем.