Свой файл .cfe в облачной базе: подключение, права и обновление в 1С:Фреш
Содержание
Расширение в 1С:Фреш загружают не через Конфигуратор, а прямо из приложения: Администрирование → Печатные формы, отчеты и обработки → Расширения, затем команда добавления из файла и выбор файла .cfe. После загрузки программа попросит перезапуститься, и доработка начнёт работать у всех пользователей этой базы.
Загрузить расширение в облачный сервис может только пользователь с полными правами в приложении. Само расширение должно работать в безопасном режиме и быть собрано под тот же релиз конфигурации, что крутится в облаке. Если хотя бы одно из этих условий не выполнено, файл либо не загрузится, либо загрузится, но не применится.
Что сервис требует от расширения и от пользователя
В облаке у вас нет доступа к Конфигуратору и к серверу. Поэтому всё, что в локальной базе решается правкой настроек, в сервисе решается только подготовкой самого файла. Требования удобно разделить на две группы.
Требования к файлу расширения
- 📦 Формат — файл конфигурации расширения
.cfe. Внешние обработки.epfи отчёты.erfподключаются в другом месте, через дополнительные отчёты и обработки, и это другой порядок. - 🔒 Безопасный режим. Код расширения не должен работать с локальными файлами сервера, COM-объектами, внешними компонентами, запускать внешние программы. В сервисной модели расширения подключаются в безопасном режиме, и отключить его со стороны абонента нельзя.
- 🔢 Режим совместимости расширения не выше, чем у основной конфигурации.
- 🧩 Под конкретный релиз. Расширение, которое заимствует формы, модули и реквизиты, привязано к их состоянию в определённой версии конфигурации.
- 🏷️ Префикс в именах собственных объектов (например,
мк_), чтобы не пересекаться с типовыми объектами и с другими расширениями.
Требования к пользователю
- 👤 Роль с полными правами в самом приложении (профиль администратора).
- 🔑 Если пользователь в облаке приглашён без административных прав, раздел с расширениями ему не откроется. Права выдаёт владелец или администратор абонента.
| Что проверяем | Где смотреть | Что должно быть |
|---|---|---|
| Релиз конфигурации в облаке | Окно «О программе» в приложении | Совпадает с релизом, на котором собран .cfe |
| Режим совместимости | Свойства расширения в Конфигураторе | Не выше режима конфигурации |
| Безопасный режим | Свойства расширения, код | Нет вызовов к файлам, COM, внешним компонентам |
| Права пользователя | Карточка пользователя в приложении | Полные права |
Расширение в сервисе действует в пределах вашей области данных, то есть только для вашего приложения. Другие абоненты его не видят, и ваши доработки не влияют на чужие базы.
Подготовка .cfe перед загрузкой в облако
Писать и отлаживать расширение в облаке негде. Его готовят на локальной копии той же конфигурации, а в сервис загружают уже готовый файл.
Соберите локальную копию нужного релиза
- В облачном приложении откройте окно «О программе» и запишите точный номер релиза конфигурации, например
3.0.xxx.yy. - Разверните локально файловую базу той же конфигурации того же релиза. Удобнее всего сделать копию вашего приложения: тогда тестировать будет на чём.
- Используйте платформу с номером версии не ниже, чем в сервисе. Если в Конфигураторе стоит более старая платформа, часть свойств может быть недоступна.
Создайте и проверьте расширение
- Откройте базу в Конфигураторе:
Конфигурация → Расширения конфигурации. - Добавьте новое расширение, задайте имя, синоним и префикс.
- Укажите назначение: исправление, адаптация или дополнение. На работу в облаке это не влияет, но помогает понять, что делает файл, через год.
- В свойствах расширения проверьте флаг безопасного режима: он должен быть включён.
- Внесите доработки, запустите базу в режиме 1С:Предприятие с этим расширением и проверьте все сценарии. Отдельно запустите проверку под обычным пользователем, а не под администратором.
- Сохраните расширение в файл
.cfeчерез меню расширения в окне списка расширений.
Если расширение добавляет свои справочники или документы с данными, при удалении расширения эти данные пропадут. Решите заранее, нужен ли вам такой вариант, или достаточно доработки форм и печати.
Что проверить в коде до выгрузки
- 🚫
Новый COMОбъект(...)— в облаке не сработает. - 🚫 Запись файлов на диск сервера через
ЗаписьТекста,КопироватьФайли подобные — запрещено безопасным режимом. Работайте через временное хранилище и диалог передачи файла на клиент. - 🚫 Подключение внешних компонент и запуск внешних программ.
- ✅ HTTP-запросы к внешним сервисам требуют отдельного разрешения в безопасном режиме. Если без них никак, узнайте у провайдера сервиса, допустимы ли они.
Загружаем расширение в 1С Фреш по шагам
Порядок показан для приложений на Библиотеке стандартных подсистем: 1С:Бухгалтерия 3.0, ЗУП 3.1, УНФ и других типовых, которые доступны в сервисе. Раздел расширений в них устроен одинаково.
Шаг 1. Откройте список расширений
Войдите в приложение через личный кабинет сервиса. Перейдите в Администрирование → Печатные формы, отчеты и обработки. На странице раздела найдите ссылку «Расширения» и откройте список.
Шаг 2. Добавьте файл
В списке нажмите команду добавления из файла. В браузере откроется стандартный диалог выбора: укажите файл .cfe на своём компьютере. Сервис может показать предупреждение о безопасности: прочитайте его и подтвердите, если файл получен из надёжного источника.
Шаг 3. Дождитесь проверки
Сервис проверит, применимо ли расширение к текущей конфигурации. Если проверка прошла, расширение появится в списке с включённым флажком использования. Если нет, вы увидите сообщение с причиной: его разбор ниже.
Шаг 4. Перезапустите приложение
Изменения вступают в силу после перезапуска. Программа сама предложит это сделать. Другим пользователям, которые сейчас работают в базе, тоже нужно выйти и зайти заново, иначе они продолжат работать без доработки.
Шаг 5. Проверьте результат
Откройте ту форму, отчёт или печатную форму, которую меняло расширение. Проверьте её под администратором и под обычным пользователем.
Загружайте расширение в начале или в конце рабочего дня. Работающие пользователи не потеряют данные, но доработка у них появится только после перезапуска, и в базе какое-то время будут люди с разным поведением программы.
Права доступа и видимость доработки для пользователей
Загрузка — только половина дела. Если расширение добавляет собственные объекты, их надо ещё открыть пользователям.
Как работают права в расширении
Расширение, которое только меняет типовые формы и модули, обычно не требует настройки прав: пользователи видят изменения в тех объектах, к которым у них уже есть доступ.
Если же в расширении есть свои справочники, документы, отчёты или обработки, к ним нужны права. Их задают ролями внутри расширения. Есть два рабочих способа:
- Заимствовать типовую роль и добавить в неё права на новые объекты. Тогда все, у кого эта роль, получат доступ автоматически.
- Создать свою роль в расширении. Тогда её нужно включить в профиль групп доступа.
Включение роли в профиль групп доступа
- В приложении откройте
Администрирование → Настройки пользователей и прав → Профили групп доступа. - Типовые профили менять нельзя, поэтому скопируйте нужный профиль.
- В копии отметьте роль из расширения.
- Назначьте новый профиль группе доступа и включите в неё нужных пользователей.
| Способ | Когда удобен | Минус |
|---|---|---|
| Заимствованная типовая роль | Доработка нужна всем, у кого есть этот участок | Права выдаются всем владельцам роли сразу |
| Своя роль + профиль | Доступ нужен только части сотрудников | Нужно поддерживать копию профиля |
Видимость в командном интерфейсе
Если новый отчёт или справочник не виден в разделе, проверьте два места. Первое: включён ли объект в подсистему в расширении. Второе: не скрыт ли пункт в настройке навигации раздела у пользователя. Открыть её можно через значок настроек в правом верхнем углу формы раздела.
Почему расширение не загружается или не работает
Большинство отказов в облаке связаны с тремя вещами: релизом, безопасным режимом и правами.
Расширение перестало работать после обновления сервиса
Провайдер обновляет конфигурации в облаке централизованно. Вы не выбираете момент обновления. Если в новом релизе изменились объекты, которые заимствует ваше расширение, оно может отключиться с предупреждением.
Что делать:
- Узнайте новый релиз в окне «О программе».
- Обновите локальную копию до этого релиза.
- Откройте расширение, проверьте заимствованные объекты и ошибки при проверке конфигурации.
- Исправьте и сохраните новый
.cfe. - Обновите расширение в облаке (порядок ниже).
Чем больше заимствовано типовых объектов, тем чаще расширение ломается при обновлениях. Заимствуйте только то, что реально меняете, и не тяните в расширение целые формы ради одного поля.
Обновление, отключение и удаление расширения в облачной базе
Как обновить версию расширения
- Откройте тот же список расширений.
- Выделите строку с вашим расширением.
- В командах формы выберите обновление из файла и укажите новую версию
.cfe. - Перезапустите приложение.
Не удаляйте расширение ради обновления, если в нём есть свои объекты с данными. При удалении данные этих объектов пропадут, а при обновлении из файла сохранятся, если структура объектов не сломана.
Как временно отключить
Снимите флажок использования в строке расширения и перезапустите приложение. Расширение останется в базе, но не будет применяться. Это удобно, когда нужно понять, виновато ли расширение в ошибке: отключили, проверили, включили обратно.
Как удалить
Выделите расширение и выберите команду удаления. Программа предупредит о последствиях. После удаления перезапустите приложение.
Перед удалением расширения со своими справочниками или документами выгрузите копию приложения через личный кабинет сервиса. Вернуть данные удалённого расширения из самой программы не получится.
Сохранить копию расширения из облака
Если исходник потерян, а расширение в облаке работает, выделите его в списке и сохраните в файл. Получите .cfe, который можно открыть в локальном Конфигураторе и доработать.
Когда своё расширение в облаке — не лучший вариант
Иногда задачу проще решить без расширения:
- 🖨️ Нужна только своя печатная форма. В типовых конфигурациях есть редактирование макетов печатных форм прямо в программе. Поправить надпись или подвинуть поле можно без файла
.cfe. - 📊 Нужен отчёт по существующим данным. Часто хватает настроек универсального отчёта или варианта типового отчёта.
- 🔌 Нужна интеграция с оборудованием или локальными программами. В облаке это упирается в безопасный режим. Такие задачи решают через локальную базу или через провайдера сервиса.
- 🧱 Глубоко переделываете учёт. Если доработок много и они ломаются каждое обновление, посчитайте, не дешевле ли перейти на локальную или арендованную базу с собственным Конфигуратором.