К статье
Практический материал

Администрирование · 10 мин

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

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

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

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

Что понадобится перед загрузкой обработки

Перед началом работы убедитесь, что у вас есть сам файл обработки — он имеет расширение .epf (внешняя обработка) или .erf (внешний отчет). Файл должен быть совместим с управляемым приложением и режимом «Такси», в котором работает 1С:ЗУП 3.1. Обработки, написанные под обычные формы 1С:ЗУП 2.5, в тройке не откроются.

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

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

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

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

Последовательность действий в 1С:ЗУП 3.1:

Разовый запуск обработки
  1. 1
    Откройте главное меню (кнопка с оранжевым логотипом в левом верхнем углу)
  2. 2
    Выберите пункт «Файл» → «Открыть»
  3. 3
    Укажите путь к файлу с расширением .epf и нажмите «Открыть»
  4. 4
    Если появится предупреждение безопасности, подтвердите открытие при доверенном источнике файла
  5. 5
    Дождитесь появления формы обработки и выполните нужные действия

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

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

Как включить механизм дополнительных отчетов и обработок

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

Перейдите в раздел Администрирование → Печатные формы, отчеты и обработки. Найдите группу «Дополнительные отчеты и обработки» и установите одноименный флажок. После этого в том же разделе появится гиперссылка «Дополнительные отчеты и обработки», ведущая к одноименному справочнику.

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

Как зарегистрировать обработку в справочнике

Откройте справочник: Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки. Нажмите кнопку «Добавить из файла» (в некоторых версиях — «Создать» с последующим выбором файла) и укажите epf-файл обработки.

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

После загрузки откроется карточка элемента справочника. Здесь важно проверить и при необходимости заполнить:

  • Команды — как обработка будет вызываться: из раздела, из формы документа или списка;
  • Размещение — в каких разделах интерфейса (Зарплата, Кадры, Отчеты и справки) появится команда;
  • Быстрый доступ — каким пользователям команда видна сразу, а кто добавит её через «Ещё»;
  • Ответственный — пользователь, отвечающий за обработку.

Нажмите «Записать и закрыть». Обработка сохранена в базе и доступна пользователям согласно настройкам.

Если обработка должна заполнять табличные части документов (например, начисления в «Начислении зарплаты»), в карточке укажите вид «Заполнение объекта» и в поле «Назначение» выберите нужные типы документов — тогда кнопка появится в меню «Заполнить» этих документов.
ПЗ
Практическое замечание

Как проверить, что обработка загрузилась и работает

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

Запустите обработку в тестовом режиме: если она изменяет данные, сначала выполните её на копии базы или на одном тестовом документе. Проверьте, что результат соответствует ожиданиям — проведенные документы, заполненные табличные части, сформированные отчеты.

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

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

Элемент в справочнике
Норма

Обработка есть в списке, у неё заполнены наименование и версия

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

Элемент отсутствует или поля пустые — файл не загрузился

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

Кнопка видна в указанном разделе или форме документа

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

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

Запуск
Норма

Форма открывается, действия выполняются без ошибок

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

Ошибка модуля или защиты от опасных действий

Типичные ошибки при загрузке и их решение

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

Типичные ошибки
01
Открытие обработки от 1С:ЗУП 2.5 — обычные формы не запускаются в управляемом приложении, нужна адаптация файла
02
Загрузка без включенного флажка «Дополнительные отчеты и обработки» — справочник просто не отображается в меню
03
Игнорирование предупреждения о небезопасных действиях — обработка регистрируется, но при запуске выдает ошибку защиты
04
Отсутствие заполнения размещения — команда нигде не появляется, и пользователи считают, что обработка не загрузилась
05
Запуск обработки, изменяющей данные, без резервной копии — при ошибке в коде данные восстановить не из чего

Если при добавлении файла появляется сообщение «Невозможно подключить дополнительный отчет из файла», причина обычно в том, что обработка не содержит экспортной функции сведений и при этом выбран вид, требующий строгой регистрации. Решение — зарегистрировать её как простую дополнительную обработку или доработать модуль объекта.

Ошибка «Нарушение прав доступа» при открытии файла означает, что у пользователя нет права интерактивного открытия внешних файлов. Право назначается через профили групп доступа в разделе «Администрирование → Настройки пользователей и прав».

Разовое открытие или регистрация: что выбрать

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

Сравнение способов подключения

Открытие через Файл → Открыть

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

Регистрация в справочнике дополнительных обработок

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

Внедрение через расширение конфигурации

Подходит, когда обработку нужно глубоко встроить в интерфейс. Требует навыков разработки и Конфигуратора

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

Итог

Что важно запомнить

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

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

Можно ли загрузить обработку в 1С:ЗУП без прав администратора?

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

Почему обработка загрузилась, но не видна в меню?

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

Подойдет ли обработка от 1С:ЗУП 2.5 для версии 3.1?

Нет, если она построена на обычных формах: 1С:ЗУП 3.1 работает только в управляемом приложении. Такую обработку нужно переписывать под управляемые формы. Иногда алгоритмы переносятся, но интерфейсную часть придется создавать заново.

Что делать, если при запуске появляется ошибка «Режим безопасности запрещает выполнение операции»?

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

Опасно ли открывать внешние обработки в рабочей базе?

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

Как обновить уже загруженную обработку на новую версию?

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