Своя печатная форма или отчёт в облачной 1С: подключаем файл .epf/.erf в сервисе
Содержание
Чтобы установить обработку в 1С:Фреш, откройте приложение, перейдите в Администрирование → Печатные формы, отчеты и обработки, включите флажок «Дополнительные отчеты и обработки», откройте одноимённый список и нажмите «Добавить из файла». Дальше система проверяет файл, а в облаке обработка работает только в безопасном режиме — на этом спотыкается большинство файлов, написанных «под коробку».
Типичная ситуация: бухгалтер перешёл из локальной базы в облачную 1С, программист прислал привычную печатную форму счёта, а в сервисе она не открывается через меню «Файл». Это нормально. В 1С:Фреш внешние файлы подключаются не «на лету», а регистрируются в базе как дополнительные отчёты и обработки — с размещением, правами и проверкой.
Чем дополнительная обработка отличается от обычной внешней
Внешняя обработка — это файл .epf (обработка) или .erf (отчёт), который живёт отдельно от конфигурации. В локальной базе его можно открыть через Файл → Открыть и сразу запустить. В облаке так не получится: у пользователей сервиса нет права интерактивно открывать внешние файлы.
Поэтому в 1С:Фреш работает только один путь — дополнительная обработка. Это тот же файл .epf/.erf, но:
- 📌 в его модуле объекта есть экспортная функция
СведенияОВнешнейОбработке(), которая сообщает программе вид, версию и команды обработки; - 📌 он загружается в справочник базы и хранится внутри неё, а не на диске;
- 📌 он запускается из нужного раздела, из формы документа или по расписанию.
Виды дополнительных обработок, которые встречаются чаще всего:
| Вид | Где появляется | Пример |
|---|---|---|
| Печатная форма | Кнопка «Печать» в документе или справочнике | Свой бланк счёта или накладной |
| Дополнительная обработка | Раздел программы, пункт «Дополнительные обработки» | Групповая загрузка цен |
| Дополнительный отчёт | Раздел программы, пункт «Дополнительные отчеты» | Анализ продаж по менеджерам |
| Заполнение объекта | Кнопка заполнения в форме документа | Заполнить табличную часть из файла |
| Отчёт объекта | Команда в форме документа | Отчёт по одному договору |
| Связанные объекты | Форма объекта | Создание документов на основании |
Если программист говорит «обработка без регистрации», в облаке она не заработает. Попросите его добавить функцию СведенияОВнешнейОбработке() по стандарту Библиотеки стандартных подсистем (БСП) — для типовых конфигураций это 10–15 минут работы.
Подготовка: какой файл подойдёт для 1С:Фреш
Перед загрузкой проверьте файл по четырём пунктам. Если хотя бы один не выполнен, обработку лучше вернуть разработчику, а не пытаться установить.
Формы только управляемые
Сервис работает через тонкий и веб-клиент. Обработка с обычными формами в нём не откроется. Разработчик должен собрать её на управляемых формах.
Совместимость с версией платформы сервиса
Обработка, сохранённая в Конфигураторе более новой платформы, чем стоит в сервисе, не загрузится. Версию платформы видно в приложении: меню с тремя полосками или значок «i» → О программе. Файл нужно собрать на платформе с номером не выше этого.
Безопасный режим
В облаке дополнительные обработки выполняются в безопасном режиме. Это значит, что код не может:
- ⛔ обращаться к файлам на диске сервера;
- ⛔ создавать COM-объекты и запускать внешние программы;
- ⛔ подключать внешние компоненты и ходить в интернет без разрешения.
Если обработке всё это нужно, при загрузке она запросит разрешения. В облаке такие запросы не одобряются автоматически, решение принимает поставщик сервиса.
Права того, кто устанавливает
Загружать обработки может только пользователь с полными правами в приложении (роль администратора). Обычный бухгалтер увидит раздел, но кнопки добавления у него не будет. Администратор абонента назначает права в личном кабинете сервиса или в самом приложении в разделе пользователей.
Пошаговая установка обработки в 1С:Фреш
Порядок одинаков для Бухгалтерии предприятия 3.0, ЗУП 3.1, УНФ и других типовых решений на БСП. Различаются только названия разделов, где потом появится команда.
Шаг 1. Включите функцию в настройках
- Откройте нужное приложение из личного кабинета сервиса.
- Перейдите в
Администрирование → Печатные формы, отчеты и обработки. - Установите флажок «Дополнительные отчеты и обработки».
Если флажок уже стоит, сразу переходите к шагу 2. Если флажка нет вовсе, у вас нет прав администратора приложения.
Шаг 2. Загрузите файл
- В той же форме щёлкните по ссылке «Дополнительные отчеты и обработки» — откроется список.
- Нажмите «Добавить из файла».
- Подтвердите предупреждение о безопасности: система напомнит, что код из внешнего файла получает доступ к данным базы.
- Выберите файл
.epfили.erfна компьютере.
В веб-клиенте браузер может попросить установить расширение для работы с файлами. Согласитесь — без него выбор файла иногда не срабатывает.
Шаг 3. Проверьте карточку
После загрузки откроется карточка обработки. Программа заполнит её сама из функции СведенияОВнешнейОбработке():
- 🔹 Наименование и Версия — можно переименовать для удобства пользователей;
- 🔹 Вид — печатная форма, обработка, отчёт и т. д.;
- 🔹 Публикация — «Используется», «Режим отладки» или «Отключена»;
- 🔹 Команды — список действий, которые умеет обработка.
Если программа запросила дополнительные разрешения, в сервисе появится отдельное окно со списком запрошенных прав. Без их одобрения обработка будет сохранена, но работать не сможет.
Шаг 4. Укажите, где обработка появится
Для печатной формы, заполнения или отчёта объекта на вкладке размещения отметьте документы и справочники, к которым она относится. Например, свой бланк счёта привязывают к документу «Счет покупателю».
Для дополнительной обработки или отчёта выберите разделы программы: «Продажи», «Покупки», «Банк и касса» и т. д. Именно там пользователи найдут пункт «Дополнительные обработки» или «Дополнительные отчеты».
Шаг 5. Сохраните
Нажмите «Записать и закрыть». Обработка сразу доступна, перезапуск приложения не нужен. Если команда не появилась, закройте и заново откройте форму документа или раздел.
Права пользователей на дополнительные обработки
Сама загрузка ещё не значит, что обработку увидят все. Доступ складывается из трёх условий.
| Условие | Где настраивается | Что будет, если не выполнено |
|---|---|---|
| Публикация «Используется» | Карточка обработки | Видит только администратор («Режим отладки») или никто («Отключена») |
| Пользователь в быстром доступе | Карточка, кнопка «Быстрый доступ» у команды | Команда не выведена на панель, искать в общем списке раздела |
| Право на использование дополнительных обработок | Группы доступа пользователя | Пункт меню не виден совсем |
Быстрый доступ
У обработок вида «Дополнительная обработка» и «Дополнительный отчёт» каждая команда имеет настройку быстрого доступа. Откройте карточку, выделите команду и задайте список пользователей. У них команда будет на панели раздела, у остальных — только внутри общего списка «Дополнительные обработки».
Группы доступа
В БП 3.0 права раздаются профилями групп доступа: Администрирование → Настройки пользователей и прав → Группы доступа. В типовых профилях бухгалтера право запускать дополнительные отчёты и обработки уже есть. Если вы делали свой урезанный профиль, проверьте, что роль на использование дополнительных отчётов и обработок в нём оставлена. Удобнее всего найти её поиском по слову «дополнительн» в списке ролей профиля.
Не выдавайте полные права только ради одной обработки. Достаточно, чтобы пользователь входил в группу с ролью на использование дополнительных обработок, а публикация стояла «Используется».
Режим отладки для проверки
Удобный приём: после загрузки сразу поставьте публикацию «Режим отладки». Обработку увидит только администратор. Он проверит её на реальных данных, и лишь потом переключит на «Используется» для всех.
Тестирование обработки после установки
Проверка зависит от вида обработки. Не ограничивайтесь тем, что команда появилась в меню.
Печатная форма. Откройте 2–3 реальных документа с разным составом: с одной строкой, с двадцатью строками, со скидкой и без. Нажмите «Печать» и выберите свою форму. Проверьте переносы на вторую страницу, итоги и суммы прописью.
Обработка заполнения. Создайте новый документ, не записывайте его, запустите заполнение. Сверьте количество строк и суммы с исходным файлом.
Групповая обработка. Сначала выберите в списке 1–2 элемента, а не все сразу. Изменения, сделанные групповой обработкой, в облаке так же необратимы, как в коробке.
Перед запуском обработки, которая меняет данные массово, сделайте резервную копию приложения в личном кабинете сервиса. В 1С:Фреш копию можно выгрузить или запросить у сервиса. Откат из копии вернёт всю базу, а не отдельные документы, — учитывайте работу коллег за это время.
Регламентная обработка. Если обработка запускается по расписанию, откройте её карточку и убедитесь, что расписание включено. Результат проверяйте после первого срабатывания, а не сразу.
Обновление новой версией и отключение
Как обновить обработку
Не загружайте новую версию как новый элемент списка — получите две одинаковые команды и путаницу у пользователей.
- Откройте
Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки. - Откройте карточку нужной обработки.
- Найдите команду загрузки из файла в командной панели карточки (обычно в меню «Ещё») и выберите новый
.epf. - Проверьте номер версии в карточке — он должен измениться.
- «Записать и закрыть».
Размещение, быстрый доступ и расписания сохраняются. Если в новой версии появились новые команды, им настройки нужно задать заново.
Перед заменой выгрузите текущую версию из карточки в файл. Если новая окажется с ошибкой, вернуть старую можно за минуту.
Как отключить или удалить
| Задача | Действие | Можно вернуть? |
|---|---|---|
| Временно убрать у пользователей | Публикация «Отключена» | Да, сменой публикации |
| Оставить только себе | Публикация «Режим отладки» | Да |
| Удалить совсем | Пометка на удаление в списке, затем удаление помеченных объектов | Только повторной загрузкой файла |
Для печатных форм отключение безопаснее удаления. Документы, напечатанные раньше, это не затрагивает, но если на обработку ссылаются настройки или расписания, удаление может оставить «висящие» ссылки.
Почему обработка не загружается или не работает в облаке
Эти симптомы характерны именно для сервиса: в локальной базе многие из них не проявляются.
Если обработку не удаётся адаптировать
Бывает, что задача в принципе требует того, что безопасный режим запрещает: прямой обмен с торговым оборудованием, чтение файлов из сетевой папки, вызов локальной программы. Варианты:
- 🔁 Перенести операцию на сторону пользователя. Файл выбирается на компьютере и передаётся в базу через стандартный диалог — так работают загрузки из Excel.
- 🔁 Использовать типовые механизмы. Загрузка из табличного документа, обмены и интеграции через интернет-сервисы часто закрывают задачу без своего кода.
- 🔁 Оформить доработку расширением. Некоторые сервисы 1С:Фреш принимают расширения конфигурации, но они тоже проходят проверку и работают с теми же ограничениями.
- 🔁 Перейти на аренду базы с полными правами. Если без нестандартного кода не обойтись, облако с доступом к Конфигуратору даст больше свободы, чем 1С:Фреш.