Как добавить обработку в 1С ЗУП

Внешние обработки в 1С:ЗУП позволяют расширить функциональность программы без изменения конфигурации: загружать данные из файлов, массово изменять кадровые документы, формировать нестандартные отчеты. Это безопасный способ доработки, поскольку типовая конфигурация остается на поддержке и продолжает штатно обновляться.

Добавить обработку можно двумя способами: подключить её через механизм «Дополнительные отчеты и обработки», чтобы она была доступна пользователям прямо из интерфейса ЗУП, или просто открыть файл обработки через меню «Файл — Открыть» для разового запуска. Первый вариант удобен для регулярной работы, второй — для разовых задач администратора.

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

Какие обработки бывают и какую выбрать

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

Обработки заполнения табличных частей привязываются к конкретным документам и добавляют кнопку в форму документа. Обработки печати расширяют список печатных форм объекта. Отдельно выделяются внешние отчеты (файлы .erf), которые подключаются тем же механизмом, но выводят результат в виде отчетной формы.

Перед загрузкой уточните у разработчика обработки, для какого назначения она предназначена. Эта информация обычно зашита в модуле объекта в функции «СведенияОВнешнейОбработке», и механизм дополнительных обработок считает её автоматически при регистрации.

Подготовка: включение механизма и проверка прав

По умолчанию в 1С:ЗУП механизм дополнительных отчетов и обработок может быть отключен. Чтобы включить его, перейдите в раздел «Администрирование» — «Печатные формы, отчеты и обработки» и установите флаг «Дополнительные отчеты и обработки». После этого в интерфейсе появится ссылка на одноименный справочник.

Работа с этим справочником требует соответствующих прав. Обычно подключение обработок выполняет пользователь с ролью администратора или с правом «Добавление и изменение дополнительных отчетов и обработок». Если вы работаете под ограниченной учетной записью расчетчика или кадровика, кнопка добавления может быть недоступна.

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

Пошаговое добавление обработки в 1С ЗУП

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

Откройте «Администрирование» — «Дополнительные отчеты и обработки» и нажмите «Создать». В форме нового элемента нажмите кнопку загрузки из файла и выберите файл обработки с расширением .epf. Программа считает сведения из модуля обработки: наименование, версию, вид и безопасный режим.

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

1. 1
   Откройте «Администрирование» — «Печатные формы, отчеты и обработки» и включите флаг «Дополнительные отчеты и обработки»
2. 2
   Перейдите в справочник «Дополнительные отчеты и обработки» и нажмите «Создать»
3. 3
   Загрузите файл .epf кнопкой загрузки и проверьте автоматически заполненные сведения
4. 4
   На вкладке размещения укажите разделы, где обработка будет доступна пользователям
5. 5
   Настройте быстрый доступ: укажите, каким пользователям видна команда
6. 6
   Нажмите «Записать» и при необходимости снимите пометку «Черновик», опубликовав обработку
7. 7
   Откройте указанный раздел и проверьте запуск обработки

Настройка размещения и доступа пользователей

После регистрации обработка по умолчанию может быть сохранена как черновик — в этом состоянии её видит только автор. Чтобы обработка стала доступна коллегам, переведите её в состояние «Публикация» или снимите соответствующий флаг в карточке элемента.

Размещение определяет, в каких разделах интерфейса появится команда запуска. Для обработки, связанной с расчетом зарплаты, логично выбрать раздел «Зарплата», для кадровых операций — раздел «Кадры». Команда появится в подменю «Дополнительные обработки» выбранного раздела.

Быстрый доступ настраивается списком пользователей или групп. Ограничивайте доступ к обработкам, изменяющим данные: массовая обработка кадровых документов в руках неопытного пользователя способна испортить сотни записей за один запуск. Для таких инструментов оставляйте доступ только администраторам и опытным расчетчикам.

Разовый запуск без регистрации

Если обработка нужна один раз — например, для диагностики данных или разовой выгрузки — регистрировать её в справочнике необязательно. Достаточно открыть файл через меню «Файл — Открыть» и выбрать .epf-файл. Обработка запустится в текущем сеансе и не оставит следов в настройках.

Этот способ подходит администраторам и программистам, но у него есть ограничения: команда не появится в интерфейсе других пользователей, а при каждом запуске файл придется открывать заново. Для регулярных операций регистрация в справочнике удобнее.

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

Сравнение вариантов

Регистрация в справочнике

Подходит для регулярной работы: команда в интерфейсе, настройка прав, централизованное обновление. Требует прав администратора и обработки со сведениями о регистрации.

Открытие через «Файл — Открыть»

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

Встраивание в конфигурацию

Вариант для постоянных доработок с участием программиста. Дает максимальную интеграцию, но снимает объект с поддержки и усложняет обновления.

Проверка результата и типичные ошибки

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

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

Контрольные точки

Как проверить результат

Команда в интерфейсе

Норма

Команда видна в разделе из настроек размещения

Тревожный признак

Команды нет — проверьте публикацию, размещение и быстрый доступ

Запуск обработки

Норма

Форма открывается без сообщений об ошибках

Тревожный признак

Ошибка компиляции или «Метод не обнаружен» — версия не совместима с конфигурацией

Результат работы

Норма

Данные обработаны корректно, тестовый пример совпадает с ожиданием

Тревожный признак

Изменения применились не к тем объектам — остановите использование и откатите данные из копии

Обновление и удаление подключенной обработки

Когда разработчик присылает новую версию обработки, не создавайте новый элемент справочника. Откройте существующую карточку и загрузите файл повторно — версия обновится, а настройки размещения и доступа сохранятся. Это исключает дубли команд в интерфейсе.

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

При обновлении самой конфигурации 1С:ЗУП дополнительные обработки сохраняются автоматически — они хранятся в базе данных, а не в конфигурации. Однако после крупных обновлений релиза стоит проверить работоспособность критичных обработок: изменения в структуре данных могут нарушить их логику.

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

Обработка загрузилась, но команда не появилась в интерфейсе. Что делать?

Проверьте три вещи: снят ли статус черновика (обработка должна быть опубликована), указаны ли разделы в настройках размещения и добавлены ли нужные пользователи в быстрый доступ. После изменений перезапустите сеанс или обновите интерфейс.

Можно ли добавить обработку, если нет прав администратора?

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

Чем обработка отличается от расширения конфигурации?

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

Безопасно ли подключать обработки из интернета?

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

Почему обработка выдает ошибку после обновления ЗУП?

В новом релизе могли измениться имена объектов, реквизитов или методов, к которым обращается код. Запросите у разработчика обновленную версию обработки или передайте текст ошибки программисту для адаптации.

Как узнать, какие обработки уже подключены в базе?

Откройте «Администрирование» — «Дополнительные отчеты и обработки»: список покажет все зарегистрированные элементы с версиями, авторами и состоянием публикации. Оттуда же можно открыть карточку и посмотреть историю изменений.