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