Как загрузить обработку в 1С Розница

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

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

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

Что нужно проверить перед загрузкой обработки

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

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

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

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

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

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

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

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

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

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

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

Как открыть обработку для разового запуска

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

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

Как настроить доступ и размещение обработки

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

Для обработок, привязанных к объектам (печатные формы, заполнение, создание связанных объектов), важна таблица «Принадлежность» — в ней перечислены виды документов и справочников, для которых обработка доступна. Обычно она заполняется из самого файла, но при ручной доработке проверьте, что указаны именно розничные объекты: «Чек ККМ», «Поступление товаров», «Установка цен номенклатуры» и другие.

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

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

Для обработки, изменяющей данные, сначала выполните операцию на одном тестовом объекте и проверьте результат: проводки документа, значения реквизитов, цены. Только после успешной проверки запускайте массовую обработку. Для печатной формы сформируйте пробный документ и сверьте вывод с ожидаемым макетом.

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

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

Обработка в списке

Норма

Отображается в разделе «Дополнительные обработки» и открывается без ошибок

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

Элемента нет в списке или при открытии ошибка компиляции модуля

Права пользователей

Норма

Нужные пользователи видят обработку после добавления в «Быстрый доступ»

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

Пользователь не видит обработку при корректных правах — проверьте настройку доступа

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

Норма

Тестовый объект изменён корректно, данные согласованы

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

Ошибки записи, частичные изменения — откатите данные из копии

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

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

Если обработка добавлена, но не появляется в интерфейсе, проверьте три вещи: включён ли механизм дополнительных обработок, заполнен ли «Быстрый доступ» и указан ли раздел размещения в карточке элемента. В базах РИБ дополнительно убедитесь, что изменения дошли до периферийного узла после обмена.

Часто задаваемые вопросы

Можно ли загрузить обработку в облачную 1С Розница (сервис)?

Можно, но с ограничениями: в режиме сервиса обработки выполняются в безопасном режиме, и часть функций (доступ к файловой системе, COM-объекты) в них недоступна. Некоторые сервисы дополнительно требуют, чтобы обработка прошла проверку. Уточните условия у оператора сервиса.

Чем отличается файл .epf от .erf?

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

Обработка открылась, но кнопки и поля работают неправильно. Что делать?

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

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

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

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

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

Можно ли запускать обработку по расписанию?

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