Как добавить обработку в 1С:Фреш — полное руководство с примерами

Работа с 1С:Фреш (облачной версией платформы 1С:Предприятие) имеет свои особенности, особенно когда речь идёт о добавлении внешних обработок. В отличие от локальных решений, здесь нет прямого доступа к файловой системе, а функциональность ограничена веб-интерфейсом и правилами безопасности облака. Это создаёт дополнительные сложности для администраторов и разработчиков, которые привыкли работать с классическими конфигурациями.

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

Материал будет полезен как начинающим пользователям, которые впервые сталкиваются с 1С:Фреш, так и опытным специалистам, ищущим оптимальные решения для автоматизации бизнес-процессов в облаке.

Что такое обработка в 1С и зачем она нужна во Фреш

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

• 📊 Формирование отчётов — создание кастомных аналитических форм, которых нет в стандартной поставке.
• 🔄 Обмен данными — интеграция с другими системами (например, CRM, ERP, банками).
• ⚙️ Автоматизация рутинных операций — массовое изменение справочников, загрузка данных из Excel.
• 🛠️ Исправление ошибок — обход багов платформы или доработка логики без изменения конфигурации.

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

Однако есть нюанс: не все обработки, работающие в локальной 1С, будут корректно функционировать во Фреш. Это связано с:

• 🔒 Ограничениями безопасности — облако блокирует потенциально опасные операции (например, доступ к файловой системе).
• 🌐 Отсутствием прямого доступа к серверу — нельзя просто скопировать файл в папку с базой.
• 📋 Версионностью платформы — 1С:Фреш обновляется автоматически, и старые обработки могут перестать работать.

Подготовка обработки к загрузке во Фреш

Прежде чем загружать обработку в 1С:Фреш, её нужно правильно подготовить. Это позволит избежать ошибок при добавлении и обеспечит корректную работу в облачной среде.

1. Проверка совместимости с облачной версией

Не все обработки, написанные для локальной 1С, будут работать во Фреш. Основные критерии совместимости:

• 📌 Версия платформы — обработка должна поддерживать ту версию 1С:Предприятие, которая используется во Фреш (узнать её можно в разделе Справка → О программе).
• 🚫 Запрещённые функции — облако блокирует операции с файловой системой (ЗаписатьФайл(), ПрочитатьФайл()), реестром Windows, COM-объектами.
• 🔌 Внешние зависимости — если обработка требует дополнительных библиотек или драйверов, их нужно заменить на облачные аналоги (например, использовать HTTP-сервисы вместо локальных DLL).

Как проверить обработку на совместимость?

1. Откройте её в Конфигураторе (если есть доступ к локальной версии 1С).
2. Запустите Проверку модулей (Конфигуратор → Администрирование → Проверка конфигурации).
3. Обратите внимание на предупреждения о нерекомендуемых методах или устаревших функциях.

2. Оптимизация кода для облака

Облачная среда накладывает ограничения на производительность. Чтобы обработка работала быстро:

• ⏳ Минимизируйте обращения к базе — используйте запросы с ПОМЕСТИТЬ ВО ВРЕМЕННУЮ ТАБЛИЦУ.
• 🗃️ Избегайте тяжелых операций — например, рекурсивных обходов справочников.
• 🔄 Используйте асинхронные методы, если обработка выполняет длительные операции (например, ЗапуститьОбработкуОжидания()).

Пример оптимизированного кода для выборки данных:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Номенклатура.Ссылка КАК Ссылка,
|   Номенклатура.Артикул КАК Артикул
|ИЗ
|   Справочник.Номенклатура КАК Номенклатура
|ГДЕ
|   Номенклатура.ПометкаУдаления = ЛОЖЬ
|УПОРЯДОЧИТЬ ПО
|   Артикул";
Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();

3. Форматы файлов обработок для Фреш

Во 1С:Фреш поддерживаются следующие форматы:

Формат файла	Расширение	Когда используется	Ограничения
Внешняя обработка	.epf	Для одноразовых задач (отчёты, загрузка данных)	Не сохраняется в базе, нужно загружать каждый раз
Внешняя печатная форма	.erf	Для кастомных печатных форм документов	Привязывается к конкретному виду документа
Конфигурационный файл	.cf	Для комплексных доработок (требует прав администратора)	Загружается только через техническую поддержку
Файл расширения	.cfe	Для добавления новых объектов без изменения конфигурации	Поддерживается не во всех тарифах 1С:Фреш

Способы добавления обработки во Фреш

В зависимости от типа обработки и ваших прав доступа во 1С:Фреш доступны разные способы её добавления. Рассмотрим каждый из них подробно.

1. Загрузка через веб-интерфейс (для пользователей)

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

Пошаговая инструкция:

1. Откройте 1С:Фреш в браузере и авторизуйтесь.
2. Перейдите в раздел Файл → Открыть.
3. Выберите файл обработки (.epf или .erf) на своём компьютере.
4. Нажмите Открыть — обработка загрузится во временное хранилище и станет доступна для выполнения.

Убедитесь, что файл имеет расширение .epf или .erf|

Проверьте размер файла (не более 50 МБ)|

Закройте все открытые документы в 1С|

Отключите блокировщики рекламы в браузере (они могут мешать загрузке)|-->

Ограничения метода:

• ⏳ Обработка доступна только в текущей сессии — после закрытия браузера её придётся загружать заново.
• 🔒 Нет возможности сохранить обработку в базе для постоянного использования.
• 📂 Нельзя загружать обработки, требующие прав администратора (например, для изменения конфигурации).

2. Добавление через "Мои обработки" (для постоянного использования)

Если обработка нужна регулярно, её можно сохранить в личном кабинете 1С:Фреш. Для этого:

1. Загрузите обработку через Файл → Открыть (как в предыдущем способе).
2. После открытия нажмите Сохранить в "Мои обработки" (кнопка появляется в верхнем меню).
3. Укажите название и, при необходимости, категорию для удобного поиска.

Теперь обработка будет доступна в разделе Файл → Мои обработки без повторной загрузки. Однако и здесь есть нюансы:

• 👥 Обработка сохраняется только для вашего пользователя — другие сотрудники её не увидят.
• 🔄 При обновлении 1С:Фреш некоторые обработки могут перестать работать (особенно если они используют недокументированные функции).

3. Установка через расширения конфигурации (для администраторов)

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

• 📋 Добавления новых отчётов в меню.
• 🔄 Изменения печатных форм документов.
• ⚙️ Интеграции с внешними сервисами (например, API банков или EDI-систем).

Как установить расширение:

1. Подготовьте файл расширения (.cfe) в Конфигураторе.
2. Перейдите в 1С:Фреш в раздел Администрирование → Расширения конфигурации.
3. Нажмите Добавить и выберите файл .cfe.
4. Активируйте расширение и перезапустите сеанс.

Что делать, если расширение не активируется?

Если после загрузки .cfe расширение не появляется в списке или не работает, проверьте:

1. Версию платформы — расширение должно быть совместимо с текущей версией 1С:Фреш.

2. Права доступа — у вашей роли должны быть права на установку расширений (Администрирование → Настройки пользователей).

3. Логи ошибок — откройте Журнал регистрации (Администрирование → Журналы → Журнал регистрации) и найдите записи об ошибках загрузки.

Если проблема сохраняется, обратитесь в техническую поддержку 1С:Фреш с логами ошибок.

4. Загрузка через техническую поддержку (для сложных случаев)

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

Какправильно оформить запрос:

1. Подготовьте файл обработки и её описание (что она делает, для чего нужна).
2. Укажите ID вашей базы (можно найти в Справка → О программе).
3. Опишите проблему, которую решает обработка, и почему её нельзя добавить стандартными способами.
4. Отправьте запрос через Помощь → Обратиться в поддержку или личный кабинет на сайте 1С.

Срок рассмотрения запроса — от нескольких часов до 3 рабочих дней (зависит от тарифа 1С:Фреш).

Типичные ошибки при добавлении обработок и как их исправить

Даже опытные пользователи 1С сталкиваются с проблемами при работе с обработками во Фреш. Рассмотрим самые распространённые ошибки и способы их решения.

1. "Файл имеет неверный формат"

Эта ошибка возникает, если:

• 📄 Файл повреждён (например, некорректно сохранён из Конфигуратора).
• 🔠 Используется неподдерживаемое расширение (например, .ert вместо .epf).
• 🔒 Файл заблокирован антивирусом или браузером.

Решение:

• Проверьте расширение файла — оно должно быть .epf, .erf или .cfe.
• Попробуйте сохранить обработку заново в Конфигураторе.
• Отключите блокировщики в браузере или попробуйте загрузить файл через другой браузер (например, Google Chrome вместо Mozilla Firefox).

2. "Недостаточно прав для выполнения операции"

Эта ошибка появляется, если:

• 👤 У вашей роли нет прав на загрузку обработок.
• 🔐 Обработка требует административных полномочий (например, изменяет конфигурацию).
• 📛 Лицензия 1С:Фреш не поддерживает расширения (актуально для базовых тарифов).

Решение:

• Обратитесь к администратору базы с просьбой выдать права (раздел Администрирование → Пользователи).
• Если нужны права администратора, но их нет — запросите повышение прав через техническую поддержку.
• Проверьте тариф 1С:Фреш — некоторые функции доступны только в ПРОФ или КОРП версиях.

Как проверить свои права во Фреш?

Откройте Справка → О программе и посмотрите раздел Права доступа. Если там нет пункта Администрирование расширений, значит, у вас недостаточно полномочий для установки обработок.

3. "Обработка несовместима с текущей версией платформы"

Эта проблема возникает, если:

• 📅 Обработка написана для старой версии 1С:Предприятие.
• 🔄 1С:Фреш обновился, а обработка нет.
• ⚙️ В обработке используются устаревшие методы или объекты.

Решение:

• Обновите обработку в Конфигураторе до актуальной версии платформы.
• Проверьте журнал ошибок (Администрирование → Журналы → Журнал регистрации) — там может быть указана конкретная причина несовместимости.
• Если нет доступа к исходникам обработки, обратитесь к её разработчику за обновлённой версией.

4. "Ошибка при выполнении обработки: доступ запрещён"

Эта ошибка связана с ограничениями безопасности 1С:Фреш. Она возникает, если обработка пытается:

• 📁 Работать с файловой системой (например, сохранять файлы на диск).
• 🌐 Подключаться к внешним ресурсам без HTTPS.
• 🖥️ Использовать COM-объекты или ActiveX.

Решение:

• Замените запрещённые функции на разрешённые аналоги. Например, вместо ЗаписатьФайл() используйте ПоместитьВоВременноеХранилище().
• Для работы с внешними сервисами используйте HTTP-соединения с протоколом HTTPS.
• Если обработка критически важна, но несовместима с облаком, рассмотрите вариант перехода на 1С:Предприятие в локальной или серверной версии.

Настройка прав доступа для обработок

Даже если обработка успешно загружена во 1С:Фреш, она может не работать из-за недостаточных прав пользователей. Разберём, как правильно настроить доступ.

1. Права на выполнение обработки

По умолчанию обработки, загруженные через Мои обработки, доступны только тому пользователю, который их добавил. Чтобы разрешить выполнение другим сотрудникам:

1. Перейдите в Администрирование → Пользователи.
2. Выберите роль, для которой нужно разрешить доступ (например, Бухгалтер или Менеджер по продажам).
3. В разделе Права найдите пункт Выполнение внешних обработок и установите флажок.
4. Сохраните изменения.

Если обработка добавлена как расширение конфигурации, права настраиваются отдельно:

1. Откройте Администрирование → Расширения конфигурации.
2. Выберите нужное расширение и нажмите Настройка прав.
3. Укажите роли, которым разрешено использовать объекты этого расширения.

2. Ограничения по тарифам 1С:Фреш

Функциональность обработок может зависеть от тарифного плана. Например:

Тариф	Поддержка расширений (.cfe)	Загрузка внешних обработок (.epf)	HTTP-соединения
Базовый	❌ Нет	✅ Да (только для текущего пользователя)	❌ Нет
ПРОФ	✅ Да (до 5 расширений)	✅ Да (для всех пользователей)	✅ Да (только HTTPS)
КОРП	✅ Да (неограниченно)	✅ Да (для всех пользователей)	✅ Да (HTTPS и FTP)

Если ваш тариф не поддерживает нужную функциональность, можно:

• 🔄 Обновить тариф (через личный кабинет на сайте 1С).
• 📞 Обратиться в поддержку с просьбой временно расширить возможности (иногда это делают бесплатно для тестирования).
• 🔧 Переписать обработку так, чтобы она работала в рамках ограничений текущего тарифа.

3. Безопасность: как защитить обработки от несанкционированного доступа

Во 1С:Фреш обработки могут содержать конфиденциальную логику (например, алгоритмы расчёта зарплаты или интеграции с банками). Чтобы защитить их:

• 🔐 Шифруйте исходный код — в Конфигураторе можно установить пароль на обработку (Файл → Установить пароль).
• 👥 Ограничивайте права — выдавайте доступ только тем ролям, которым он действительно нужен.
• 📡 Используйте журнал регистрации — настройте логирование выполнения обработок (Администрирование → Журналы → Настройки журнала).

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

// В модуле обработки добавьте запись в журнал регистрации
ЖурналРегистрации = Новый ЖурналРегистрации;
ЖурналРегистрации.Записать("Выполнение обработки: " + ИмяОбработки(),
УровеньЖурнала.Информация,
,
"ВыполнениеОбработки");

Примеры полезных обработок для 1С:Фреш

Чтобы проиллюстрировать возможности обработок во 1С:Фреш, рассмотрим несколько практических примеров, которые можно адаптировать под свои задачи.

1. Обработка для загрузки данных из Excel

Одна из самых востребованных задач — импорт данных из Excel в 1С. Во Фреш это можно сделать с помощью обработки, которая:

• 📑 Считывает данные из файла .xlsx или .xls.
• 🔄 Сопоставляет колонки Excel с полями справочников 1С.
• ✅ Проверяет данные на корректность перед загрузкой.

Пример кода для чтения Excel:

// Подключаем библиотеку для работы с Excel (требуется права на внешние компоненты)
Попытка
Excel = Новый COMОбъект("Excel.Application");
Книга = Excel.Workbooks.Open(ПутьКФайлу);
Лист = Книга.Worksheets(1);
Данные = Лист.UsedRange.Value;
Исключение
Сообщить("Ошибка при открытии файла: " + ОписаниеОшибки());
Возврат Ложь;
КонецПопытки;

Обратите внимание: во 1С:Фреш COM-объекты заблокированы, поэтому для работы с Excel придётся использовать альтернативные методы, например:

• 🌐 Загружать файл через HTTP-сервис и парсить его на стороне сервера.
• 📊 Использовать встроенный механизм ЗагрузкаДанныхИзТабличногоДокумента() (поддерживает .xlsx в новых версиях платформы).

2. Обработка для формирования кастомного отчёта

Если стандартных отчётов 1С:Фреш недостаточно, можно создать свою обработку. Например, отчёт по продажам с детализацией по менеджерам и клиентам.

Структура обработки:

• 📊 Параметры отчёта — период, менеджер, тип товаров.
• 🔍 Запрос к базе — выборка данных по продажам.
• 📈 Визуализация — построение диаграмм или таблиц.

Пример запроса для отчёта:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Продажи.Дата КАК Дата,
|   Продажи.Контрагент КАК Клиент,
|   Продажи.СуммаДокумента КАК Сумма,
|   Продажи.Ответственный КАК Менеджер
|ИЗ
|   Документ.РеализацияТоваровУслуг КАК Продажи
|ГДЕ
|   Продажи.Дата МЕЖДУ &НачалоПериода И &КонецПериода
|УПОРЯДОЧИТЬ ПО
|   Дата";
Запрос.УстановитьПараметр("НачалоПериода", НачалоДня(НачалоПериода));
Запрос.УстановитьПараметр("КонецПериода", КонецДня(КонецПериода));
Результат = Запрос.Выполнить();

3. Обработка для интеграции с банком (выгрузка платежей)

Многие компании нуждаются в автоматической выгрузке платежных поручений в банк-клиент. Во 1С:Фреш это можно реализовать через обработку, которая:

• 🏦 Формирует файл платежного поручения в формате 1CClientBankExchange.
• 🔒 Подписывает его электронной подписью (если есть доступ к сертификатам).
• 📤 Отправляет в банк через API