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

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

Как добавить обработку в 1С 8.3

Как добавить внешнюю обработку в 1С 8.3: через дополнительные отчеты и обработки, открытие файла epf, регистрация в справочнике. Настройка прав и размещение.

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

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

Что такое внешняя обработка и когда она нужна

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

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

Подготовка: что проверить перед добавлением

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

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

Способ 1: разовое открытие файла обработки

Самый быстрый вариант — открыть файл напрямую. В клиенте 1С перейдите в меню «Файл» → «Открыть» (или нажмите Ctrl+O), укажите путь к файлу .epf и подтвердите открытие. Платформа может показать предупреждение о безопасности — оно появляется при открытии любых внешних файлов и требует осознанного подтверждения.

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

Разовый запуск обработки
  1. 1
    Откройте меню «Файл» → «Открыть» или нажмите Ctrl+O
  2. 2
    Выберите файл с расширением .epf на диске
  3. 3
    Подтвердите предупреждение безопасности, если оно появилось
  4. 4
    Проверьте, что форма обработки открылась без ошибок

Способ 2: регистрация в «Дополнительных отчетах и обработках»

Для постоянной работы обработку регистрируют в стандартной подсистеме БСП (библиотека стандартных подсистем), которая есть в большинстве типовых конфигураций: «Управление торговлей», «Бухгалтерия предприятия», «ERP», «Зарплата и управление персоналом».

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

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

Регистрация обработки в базе
  1. 1
    Администрирование → Печатные формы, отчеты и обработки → включить флаг «Дополнительные отчеты и обработки»
  2. 2
    Открыть справочник «Дополнительные отчеты и обработки»
  3. 3
    Нажать «Добавить из файла» и выбрать .epf
  4. 4
    Проверить автоматически заполненные сведения о регистрации
  5. 5
    Настроить размещение (разделы) или привязку к документам
  6. 6
    Записать элемент и проверить появление команды в интерфейсе

Настройка прав доступа и безопасный режим

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

Отдельного внимания заслуживает безопасный режим. При регистрации система может предложить запускать обработку в безопасном режиме — тогда код не сможет обращаться к файловой системе и выполнять потенциально опасные операции. Для обработок из непроверенных источников безопасный режим оставляйте включённым; отключайте его только если обработка заведомо требует доступа к файлам (например, загрузка из Excel) и источнику вы доверяете. В файловых базах также проверьте, не включён ли глобальный запрет на открытие внешних обработок у пользователя — в параметрах учётной записи есть соответствующая настройка защиты.

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

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

Если что-то пошло не так, сопоставьте симптом с причиной по таблице ниже.

СимптомВероятная причинаЧто сделать
Ошибка при открытии формыОбработка под обычные формы открыта в управляемом приложенииНайти версию под управляемые формы
Команда не видна пользователюНе настроено размещение или быстрый доступПроверить разделы публикации и список пользователей
«Операция не разрешена в безопасном режиме»Обработка обращается к файлам при включённой защитеОтключить безопасный режим для доверенного файла
Нет пункта «Дополнительные отчеты и обработки»Механизм не включён или конфигурация без БСПВключить флаг в настройках администрирования
Типичные ошибки
01
Регистрация обработки без настройки размещения — команда есть в справочнике, но пользователи её не видят
02
Тестирование только под администратором — у обычных пользователей обработка падает из-за нехватки прав на объекты данных
03
Отключение безопасного режима для файла из интернета — риск выполнения вредоносного кода
04
Добавление обработки в рабочую базу без теста на копии — ошибка в коде может повредить данные

Как обновить или удалить обработку

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

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

Итог

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

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

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

Чем обработка отличается от внешнего отчёта?

Технически — расширением файла (.epf против .erf) и назначением. Отчёт строится на СКД и выводит табличный документ, обработка выполняет произвольные действия. Регистрируются оба типа в одном справочнике «Дополнительные отчеты и обработки».

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

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

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

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

Что делать, если при открытии появляется предупреждение безопасности?

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

Как добавить обработку в 1С:Fresh или облачную базу?

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

Обработка требует отключить безопасный режим — это опасно?

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