Подключаем файлы .epf и .erf к базе 1С:Предприятие 8.3 — разово и насовсем
Содержание
Загрузить файл внешнего отчета или обработки в 1С:Предприятие можно двумя путями. Разово — через главное меню Файл → Открыть (или Ctrl+O). Постоянно — через Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки, кнопка «Добавить из файла…».
Первый способ подходит для разовой задачи: открыли, выполнили, закрыли. Второй — для всего, чем пользуется отдел каждый день: печатных форм, загрузок из Excel, сервисных обработок. Если файл не принимается, почти всегда виноваты права пользователя или отсутствие регистрационных сведений в самой обработке.
Файл → Открыть. В базу ничего не записывается, после закрытия программы файл снова придется выбирать с диска.Какие файлы можно загрузить и как их проверить заранее
Внешние объекты 1С бывают двух типов:
- 📄
.epf— внешняя обработка. Выполняет действие: загружает данные, меняет реквизиты, печатает документ. - 📊
.erf— внешний отчет . Собирает и показывает данные, обычно на системе компоновки.
Оба файла — это исполняемый код. Он работает с правами пользователя, который его запустил. Обработка может изменить или удалить документы, отправить данные в интернет, запустить программу на компьютере. Поэтому файл из почты или с форума сначала проверяют.
Что проверить до загрузки
- Источник. Файл от вашего программиста, от разработчика конфигурации или от известного партнера — норма. Файл «с полезного сайта» без автора — повод остановиться.
- Совместимость с конфигурацией. Обработка пишется под конкретное решение: БП 3.0, ЗУП 3.1, УТ 11. Печатная форма для Бухгалтерии в Управлении торговлей, скорее всего, не заработает.
- Тип форм. Обработки на «обычных» формах писались для старых интерфейсов. В Такси на тонком клиенте они не откроются.
- Код. Откройте файл в Конфигураторе:
Файл → Открыть, затем модуль объекта и модули форм. Ищите вызовы, которые не нужны для заявленной задачи:ЗапуститьПриложение,КомандаСистемы,COMОбъект,HTTPСоединение,УдалитьФайлы. - Тест на копии. Выгрузите базу в
.dtили скопируйте каталог файловой базы, подключите копию и запустите обработку там.
Обработку, которая меняет или удаляет данные, запускайте в рабочей базе только после резервной копии. Откатить массовое изменение документов кнопкой «Отмена» нельзя.
Как понять, подойдет ли файл для справочника
Чтобы обработку можно было зарегистрировать в справочнике, в ее модуле объекта должна быть экспортная функция СведенияОВнешнейОбработке(). Она сообщает программе вид обработки, версию, команды и объекты, к которым та подключается.
Нет этой функции — файл откроется через Файл → Открыть, но в справочник не встанет. Добавить регистрационные сведения может программист за несколько минут: это шаблонный код из Библиотеки стандартных подсистем.
Загрузка обработки в справочник «Дополнительные отчеты и обработки»
Справочник есть во всех типовых решениях на Библиотеке стандартных подсистем. Пути к нему:
| Конфигурация | Где включить и открыть |
|---|---|
| Бухгалтерия предприятия 3.0 | Администрирование → Печатные формы, отчеты и обработки |
| Зарплата и управление персоналом 3.1 | Администрирование → Печатные формы, отчеты и обработки |
| Управление торговлей 11 | НСИ и администрирование → Администрирование → Печатные формы, отчеты и обработки |
На этой странице сначала установите флажок «Дополнительные отчеты и обработки». Пока он снят, ссылка на справочник неактивна.
Пошагово
- Откройте ссылку «Дополнительные отчеты и обработки».
- Нажмите «Добавить из файла…».
- Программа покажет предупреждение о безопасности. Прочитайте его и нажмите «Продолжить», если файл проверен.
- Выберите файл
.epfили.erfна диске. - Откроется карточка. Поля «Наименование», «Вид» и «Версия» заполнятся из регистрационных сведений файла.
- Проверьте поле «Публикация». Для работы нужно значение «Используется».
- Настройте размещение — об этом ниже.
- Нажмите «Записать и закрыть».
После записи файл хранится в базе. Удалять его с диска можно: другим пользователям и на других компьютерах он уже не нужен.
Вид обработки определяет, где ее искать
| Вид в карточке | Где появится команда |
|---|---|
| Дополнительная обработка | В выбранных разделах, в группе команд дополнительных обработок |
| Дополнительный отчет | В выбранных разделах, рядом с отчетами |
| Печатная форма | В меню «Печать» документов, указанных разработчиком |
| Заполнение объекта | В командах заполнения указанных документов |
| Отчет (к объекту) | В формах указанных объектов |
| Создание связанных объектов | В команде «Создать на основании» указанных объектов |
Вид задает разработчик в коде. Поменять его в карточке нельзя.
Размещение и быстрый доступ
Для глобальных обработок и отчетов в карточке есть поле «Размещение». Нажмите на него и отметьте разделы, где команда должна появиться: например, «Банк и касса» или «Зарплата и кадры».
На вкладке «Команды» можно настроить быстрый доступ. Отметьте пользователей, которым команда нужна в первую очередь, — она будет видна им без лишних переходов.
Если после записи команда не видна, закройте форму раздела и откройте ее снова. В части случаев помогает только перезапуск сеанса.
Режим «Отладка»
Значение публикации «Отладка» показывает команду только администраторам. Удобно, когда новую обработку нужно проверить в рабочей базе до того, как ее увидят бухгалтеры. После проверки переключите на «Используется».
Разовое открытие: меню Файл и Ctrl+O
Когда обработка нужна один раз, регистрировать ее не обязательно.
- Откройте главное меню программы — кнопку с тремя полосками в левом верхнем углу окна.
- Выберите
Файл → Открытьили нажмитеCtrl+O. - Укажите файл
.epfили.erf. - Подтвердите предупреждение о безопасности, если оно появится.
Форма обработки откроется сразу. В базе не останется ни записи, ни команды.
Чем этот путь отличается от справочника
Файл → Открыть | Справочник | |
|---|---|---|
| Файл хранится | На диске пользователя | В базе |
| Доступно другим | Нет, каждому нужен свой файл | Да, по настройкам размещения |
| Печатные формы в документах | Нет | Да |
| Регламентный запуск по расписанию | Нет | Да, если обработка это поддерживает |
| Нужные права | Интерактивное открытие внешних файлов | Право добавлять и изменять дополнительные обработки |
| Требование к коду | Любая совместимая обработка | Функция СведенияОВнешнейОбработке() |
Открытие в веб-клиенте и через RDP
В веб-клиенте файл выбирают через окно браузера, и он передается на сервер. На терминальном сервере файл должен лежать на диске, который виден в сеансе: копируйте его на сетевую папку или пробрасывайте локальный диск.
В облачных сервисах открытие произвольных файлов часто запрещено. Там обработку обычно передают провайдеру на проверку, а он подключает ее сам. Порядок уточняйте у своего провайдера.
Права пользователей и защита от опасных действий
Ошибка «Нарушение прав доступа» при открытии внешнего файла — самый частый вопрос от бухгалтеров. Дело в правах, а не в файле.
Какие права нужны
- 🔓 Для
Файл → Открытьнужно право интерактивного открытия внешних обработок и отчетов. В типовых конфигурациях оно выдается ролью с таким названием через группу доступа. - 🗂️ Для справочника нужно право добавлять и изменять дополнительные отчеты и обработки. По умолчанию оно есть у администраторов.
- 👀 Для запуска зарегистрированной обработки отдельных прав почти не требуется: команду видят пользователи разделов, куда она размещена.
Права настраивают в Администрирование → Настройки пользователей и прав → Группы доступа. Создайте отдельную группу, например «Запуск внешних обработок». Включите в нее только тех, кому это реально нужно, а не весь отдел.
Хорошая практика: обычные пользователи работают только с зарегистрированными обработками, а Файл → Открыть оставляют администратору и программисту. Так в базу не попадает непроверенный код «с флешки».
Защита от опасных действий
В платформе 8.3 есть механизм защиты от опасных действий. Когда он включен, при открытии внешнего файла появляется окно с предупреждением: файл может содержать вредоносный код. Пользователь подтверждает действие или отказывается.
Флажок «Защита от опасных действий» находится в карточке пользователя в Конфигураторе: Администрирование → Пользователи. Снимать его стоит только для технических учетных записей, через которые обработки запускаются автоматически.
Для автоматизации на конкретном компьютере есть еще параметр DisableUnsafeActionProtection в файле conf.cfg каталога платформы. В нем указывают шаблон строк подключения баз, для которых предупреждение не показывается:
DisableUnsafeActionProtection=.*test.*
Отключение защиты для рабочих баз оставляет пользователя без последнего барьера перед вредоносной обработкой. Ограничьтесь тестовыми базами и служебными пользователями.
Безопасный режим обработок
Зарегистрированные обработки по умолчанию работают в безопасном режиме: без доступа к файлам, внешним программам и интернету. Если обработке нужен такой доступ, она запрашивает разрешения при регистрации. Администратор видит список запросов и решает, выдавать их или нет.
Если обработка просит доступ к интернету, а должна только печатать накладную, — это повод разобраться с кодом.
Обновление загруженных файлов и работа в нескольких базах
Новая версия обработки вышла — старую удалять не нужно.
Замена версии в карточке
- Откройте справочник «Дополнительные отчеты и обработки».
- Откройте карточку нужной обработки.
- Нажмите «Загрузить из файла…» и выберите новый файл.
- Проверьте номер в поле «Версия» и нажмите «Записать и закрыть».
Настройки размещения, быстрого доступа и расписания сохранятся. Перед заменой сохраните текущую версию через «Выгрузить в файл…» — так будет к чему откатиться, если новая окажется с ошибкой.
Распределенные базы
Если у вас распределенная информационная база (центр и филиалы), справочник дополнительных обработок участвует в обмене. Загрузите или обновите обработку в главном узле, и после синхронизации она появится в подчиненных. В каждой базе отдельно ничего делать не нужно.
Для баз без обмена (например, несколько независимых организаций) обновление придется повторить в каждой. Ведите список: какая обработка, какой версии, в каких базах.
Регламентный запуск
Обработки вида «Дополнительная обработка», которые поддерживают серверный вызов, можно ставить на расписание. В карточке на вкладке «Команды» у таких команд есть колонка с расписанием. Задайте периодичность, и обработка будет выполняться сама, например загружать курсы или прайс поставщика по ночам.
Запуск из командной строки
Обработку можно запускать при старте сеанса через параметр /Execute:
"C:\Program Files\1cv8\common\1cestart.exe" ENTERPRISE /F"D:\Base\Buh" /N"Robot" /P"pass" /Execute "D:\Obr\Zagruzka.epf"
Сеанс откроется, и обработка запустится сразу. Так автоматизируют задачи через планировщик Windows. Учетной записи Robot нужно право интерактивного открытия внешних обработок, иначе запуск остановится на ошибке прав.
Пароль в bat-файле лежит открытым текстом. Ограничьте доступ к файлу и дайте служебному пользователю минимум прав.
Почему 1С не загружает файл: ошибки и как их устранить
Если не помогло
- Запустите обработку под пользователем с полными правами. Если работает — проблема в правах, а не в коде.
- Откройте файл в Конфигураторе и выполните синтаксический контроль модулей. Ошибки компиляции покажут, на какие объекты конфигурации ссылается обработка.
- Если обработку нужно встроить глубоко в типовую форму документа, внешний файл может не подойти. Для таких доработок используют расширение конфигурации — оно переживает обновления типовой конфигурации.