Подключаем файл .cfe к Управлению торговлей 11 без программиста

· 9 мин

Содержание

Установить расширение в 1С УТ 11 проще всего прямо из программы: НСИ и администрирование → Печатные формы, отчеты и обработки → Расширения, кнопка добавления из файла, выбрать файл .cfe и перезапустить 1С. Второй путь — Конфигуратор: Конфигурация → Расширения конфигурации, загрузить файл в новое расширение и обновить конфигурацию базы данных. Снимать конфигурацию с поддержки при этом не нужно.

Типичная ситуация: подрядчик прислал файл ДоработкаПечати.cfe с исправленной формой счёта для Управления торговлей 11 и короткой припиской «установите расширение». Ниже по шагам: что проверить до установки, какой способ выбрать, как раздать права менеджерам и что делать, если расширение не подключается.

Что проверить перед установкой расширения конфигурации

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

Механизм появился в платформе 8.3.6, но заметная часть возможностей добавлялась позже. Расширение, собранное разработчиком на свежей платформе, может не заработать на старой. Перед установкой проверьте пять вещей:

  1. 🔢 Версия платформы. Узнайте её в окне О программе (значок «i» или меню с тремя полосками). Номер должен быть не ниже того, на котором собрано расширение. Спросите его у разработчика.
  2. 📦 Релиз УТ 11. Расширение заимствует объекты типовой: документы, формы, модули. Если оно делалось под релиз 11.5.x, а у вас более старый, часть заимствованных объектов может не совпасть.
  3. ⚙️ Режим совместимости. У расширения есть свойство «Режим совместимости». Попросите разработчика выставить его под вашу конфигурацию, иначе платформа откажется применять расширение.
  4. 🛡️ Нужен ли небезопасный режим. Если расширение работает с файлами на диске, внешними компонентами или COM-объектами, ему нужно отключение безопасного режима. Это стоит знать заранее: решение о доверии принимаете вы.
  5. 💾 Копия базы. Для файловой базы — копия каталога с файлом 1Cv8.1CD или выгрузка .dt, для серверной — резервная копия средствами СУБД.

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

Новые расширения удобно сначала прогнать на копии базы. Сделали копию, подключили, провели пару документов, распечатали форму — и только потом в рабочую.

Способ 1. Установка расширения из пользовательского режима УТ 11

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

  1. Войдите в УТ 11 под пользователем с полными правами.
  2. Откройте НСИ и администрирование → Печатные формы, отчеты и обработки.
  3. Перейдите по ссылке Расширения. Откроется список уже подключённых расширений.
  4. Нажмите кнопку добавления из файла и выберите файл .cfe.
  5. Прочитайте предупреждение о безопасности и подтвердите загрузку.
  6. Проверьте флажок безопасного режима у нового расширения. Если разработчик сказал, что режим нужно отключить, снимите флажок.
  7. Закройте 1С и откройте снова: расширение подключается только в новых сеансах.

После перезапуска найдите доработку в интерфейсе. Например, новую печатную форму — в меню Печать нужного документа.

Если ссылки на расширения в разделе нет, откройте стандартную обработку: Все функции → Стандартные → Управление расширениями конфигурации. Пункт «Все функции» включается в настройках программы (меню с тремя полосками → Настройки → Параметры, флажок «Отображать команду «Все функции»»).

Как обновить уже установленное расширение

Новую версию от разработчика ставят поверх старой. В том же списке Расширения выделите расширение и выберите команду обновления из файла. Удалять старое расширение заранее не нужно.

Удаление, наоборот, может стоить данных. Если расширение добавляло свои реквизиты или справочники, значения в них хранятся в базе вместе с ним. Удалили расширение — потеряли эти данные.

Способ 2. Загрузка расширения в Конфигураторе

Через Конфигуратор удобно, когда расширение большое, меняет структуру данных или нужно сразу посмотреть его состав.

  1. Запустите 1С в режиме Конфигуратор под администратором.
  2. Откройте Конфигурация → Расширения конфигурации. Появится окно со списком расширений.
  3. Нажмите Добавить. Платформа создаст пустое расширение с именем вида Расширение1.
  4. Выделите его и загрузите файл: в меню Конфигурация окна расширений выберите Загрузить конфигурацию из файла… и укажите .cfe.
  5. Согласитесь на замену: имя пустого расширения поменяется на имя из файла.
  6. Выполните обновление конфигурации базы данных для расширения (подробнее в следующем разделе).

Свойства расширения меняются прямо в окне списка. Колонки «Активно», «Безопасный режим» и «Защита от опасных действий» видны в виде флажков.

Пакетная установка из командной строки

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

"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" DESIGNER /F"D:\Bases\UT11" /N"Администратор" /P"пароль" /LoadCfg "D:\Ext\ДоработкаПечати.cfe" -Extension "ДоработкаПечати" /UpdateDBCfg /Out "D:\Ext\log.txt"

Для серверной базы вместо /F укажите /S"сервер\имя_базы". Номер платформы в пути замените на свой. Результат смотрите в файле log.txt.

Какой способ выбрать

СпособКогда подходитНа что смотреть
Пользовательский режимПечатные формы, отчёты, мелкие правкиПерезапуск сеансов, флажок безопасного режима
КонфигураторКрупные расширения, новые справочники и реквизитыОбновление конфигурации БД, доступ к Конфигуратору
Командная строкаНесколько баз, установка по расписаниюЛогин с правами администратора, лог выполнения

Обновление конфигурации базы данных после загрузки

Загрузка файла и применение расширения к базе — разные шаги. Пока второй шаг не выполнен, пользователи доработку не увидят.

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

При загрузке из пользовательского режима отдельной команды нет: программа применяет расширение сама, а вам остаётся перезапустить сеанс.

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

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

Права пользователей на объекты расширения

Частая жалоба: администратор доработку видит, а менеджер — нет. Причина почти всегда в правах.

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

С новыми объектами иначе. Если расширение добавляет свой справочник, отчёт или обработку, права на них нужно дать отдельно. Разработчики решают это двумя способами:

  • 🔐 Своя роль в расширении. Её нужно включить в профиль группы доступа: НСИ и администрирование → Настройки пользователей и прав → Профили групп доступа. Откройте профиль менеджеров, найдите роль расширения в списке ролей, отметьте её и запишите.
  • 🔐 Права в заимствованной роли. Разработчик заимствует типовую роль и добавляет в неё права на новые объекты. Тогда настраивать ничего не нужно: права появятся у всех, у кого есть эта роль.

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

Как проверить права, не выпрашивая пароль у менеджера

Не нужно звонить сотруднику и просить проверить. Есть два быстрых приёма:

  1. Откройте карточку пользователя в НСИ и администрирование → Настройки пользователей и прав → Пользователи и посмотрите, в какие группы доступа он входит. Затем проверьте, есть ли роль расширения в профиле этих групп.
  2. Заведите тестового пользователя с тем же профилем, что у менеджера, и войдите под ним. Так вы увидите интерфейс его глазами и поймёте, хватает ли прав на новый отчёт или справочник.

После правки профиля пользователю тоже нужно перезайти в программу: права в открытом сеансе не обновляются.

Для установки расширений из программы пользователю нужно право администрирования. В платформе есть отдельное право «Администрирование расширений конфигурации»: его можно дать сотруднику, который ставит расширения, не выдавая полных прав.

Файловая и серверная база: в чём разница

Порядок действий один и тот же, отличаются детали.

Файловая база. Расширение сохраняется внутри файла 1Cv8.1CD. Копия каталога базы делается простым копированием, пока все вышли из программы. Если базу открывают по сети, у пользователя, который ставит расширение, должен быть доступ на запись в каталог базы.

Клиент-серверная база . Расширение хранится в базе СУБД и применяется на сервере 1С. Здесь есть два важных момента:

  • 🖥️ Расширение без безопасного режима может упереться в профиль безопасности кластера. Если для базы назначен профиль безопасности, расширения с доступом к файлам и внешним компонентам работают только в рамках этого профиля. Настраивает его администратор сервера в консоли кластера.
  • 🖥️ Чтобы новые сеансы подхватили расширение, пользователям достаточно перезайти. Перезапускать службу агента сервера 1С не нужно.

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

Почему расширение не подключается: разбор ошибок

Большинство отказов укладываются в несколько сценариев. Подберите свой симптом:

Диагностика: выберите симптом

Как проверить расширение перед обновлением УТ

Самая болезненная ситуация — обновили типовую, а утром печать накладных не работает. Чтобы этого избежать:

  1. Разверните копию рабочей базы.
  2. Обновите на копии УТ 11 до нового релиза.
  3. Запустите копию и откройте каждую доработку из расширения.
  4. Если что-то не работает, отправьте разработчику номер релиза до обновления рабочей базы.

В Конфигураторе расширение с конфликтом выделяется сообщением при обновлении конфигурации базы данных. Текст сообщения указывает конкретный объект — его и пересылайте разработчику.

Если ничего не помогло

Отключите расширение флажком «Активно» и перезапустите сеансы. Типовая УТ 11 продолжит работать без доработки, данные расширения при отключении не удаляются. Дальше разбирайтесь с разработчиком спокойно, без остановки продаж.

Частые вопросы

Слетит ли расширение при обновлении УТ 11?
Нет. Расширение хранится отдельно от типовой конфигурации и остаётся после обновления. Но если новый релиз изменил заимствованные объекты, расширение может перестать применяться и потребует адаптации.
Нужно ли снимать УТ 11 с поддержки, чтобы поставить расширение?
Нет. В этом главное преимущество расширений: типовая остаётся на полной поддержке и обновляется автоматически.
Сколько расширений можно подключить к одной базе?
Жёсткого лимита для практической работы нет. При нескольких расширениях следите, чтобы они не перехватывали одни и те же процедуры: порядок их срабатывания может дать неожиданный результат.
Чем расширение отличается от внешней обработки?
Внешняя обработка — отдельный файл .epf для печати или заполнения, она не меняет формы и логику документов. Расширение встраивается в конфигурацию: добавляет реквизиты, меняет формы и поведение объектов.
Как сохранить расширение из базы в файл?
В Конфигураторе откройте Конфигурация → Расширения конфигурации, выделите расширение и выберите сохранение конфигурации в файл. Получится тот же .cfe, который можно поставить в другую базу.