Установка расширений конфигурации 1С 8.3: от файла .cfe до работы пользователей

Расширение в 1С ставится двумя способами: через Конфигуратор (Конфигурация → Расширения конфигурации → Добавить) или из обычного режима, если в программе есть раздел администрирования с расширениями. Главная ошибка новичка — менять типовую конфигурацию напрямую. Так вы получаете «снятие с поддержки» и боль при каждом обновлении. Расширение живёт отдельно и обновления типовой не ломает.

Файл расширения имеет формат .cfe. Его присылает разработчик, скачивают с сайта поставщика или выгружают из другой базы. Установка занимает минуты, но именно вокруг неё копятся вопросы: права, режим безопасности, порядок применения, поведение после обновления конфигурации. Разберём всё по порядку.

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

Сначала убедитесь, что расширение вообще подойдёт вашей базе.

1. Версия платформы. Расширения конфигурации появились в платформе 8.3.6, а расширения с собственными данными (справочниками, документами, реквизитами) — в 8.3.11. Откройте окно «О программе» и посмотрите номер релиза.
2. Конфигурация и релиз. Расширение пишут под конкретную конфигурацию. Файл для «Бухгалтерии предприятия» в «Зарплате и управлении персоналом» не заработает. Посмотрите описание от разработчика: для каких конфигураций и с какого релиза оно предназначено.
3. Источник файла. Расширение может содержать код, который читает данные базы и обращается к файловой системе. Берите только у проверенных авторов.
4. Резервная копия. Выгрузите информационную базу в .dt через Конфигуратор: Администрирование → Выгрузить информационную базу. Для файловой базы можно просто скопировать каталог при закрытых сеансах.

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

Чек-лист подготовки

Установка расширения в файловой базе

Файловая база хранится в каталоге на диске, и сервера 1С между вами и данными нет. Установка здесь самая простая.

Через Конфигуратор

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

Кнопка «Добавить» без загрузки файла создаёт новое пустое расширение — так начинают собственную разработку: создают расширение и наполняют его объектами.

Через обычный режим работы

Во многих типовых конфигурациях есть раздел с подключаемыми расширениями. Ищите его в Администрирование — внутри раздела, посвящённого печатным формам, отчётам и обработкам. Там может быть команда «Расширения» со списком подключённых и кнопкой «Добавить из файла». Название зависит от версии БСП (библиотеки стандартных подсистем), точный пункт покажет поиск по форме.

Этот способ удобен: Конфигуратор не нужен, а права на установку получает пользователь с ролью администратора.

Флаги безопасности при загрузке

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

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

Не отключайте безопасный режим для расширения «от неизвестного автора» ради того, чтобы «просто заработало».

Особенности установки в клиент-серверной базе

В клиент-серверном варианте данные лежат в СУБД (PostgreSQL, MS SQL Server и др.), а работу ведёт кластер серверов 1С. Сама загрузка .cfe та же. Различия в другом.

Что меняется

• Сеансы. На сервере одновременно работает множество пользователей. Расширение подхватится у каждого при следующем входе. Те, кто уже в базе, увидят изменения после перезапуска клиента.
• Серверный контекст. Если расширение содержит серверный код, он выполняется в рабочих процессах кластера. Ошибка в таком коде затронет всех, поэтому тестируйте на копии.
• Доступ. Конфигуратор нужно открывать от имени пользователя информационной базы с правом администрирования.
• Резервирование. Копируйте не каталог, а выгрузку или бэкап средствами СУБД.

Порядок действий

1. Предупредите пользователей, назначьте окно (вечер или выходные).
2. Сделайте бэкап базы средствами СУБД и/или выгрузку .dt.
3. Загрузите расширение через Конфигуратор тем же способом, что и в файловой базе.
4. Проверьте работу на одном пользователе, прежде чем объявлять об окончании работ.

Права доступа: почему расширение есть, а пользователь его не видит

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

Расширение может приносить собственные роли. Они не включаются сами. Вам нужно:

1. Открыть список профилей групп доступа (в типовых конфигурациях — Администрирование → Настройки пользователей и прав) и найти, куда добавить роль расширения.
2. Назначить пользователю профиль, в который входит нужная роль.
3. Перезапустить сеанс пользователя.

Если конфигурация не использует профили БСП, роли назначают в Конфигураторе: Администрирование → Пользователи, вкладка «Прочее».

Проверьте также состав ролей пользователя и ограничения доступа на уровне записей (RLS): иногда расширение работает, но нужные данные или объект скрыты настройками доступа. Зайдите под администратором и сравните интерфейс.

Конфликты расширений и отладка

Расширение изменяет поведение типовых объектов: переопределяет форму, перехватывает процедуру, добавляет реквизит. Два расширения могут править одно и то же. Результат зависит от порядка.

Порядок применения

Вручную переставить расширения в списке нельзя. Порядок применения задаёт свойство расширения «Назначение»: сначала применяются расширения с назначением «Исправление», затем «Адаптация», затем «Дополнение». Внутри одного назначения расширения идут в порядке регистрации в базе. Если два расширения перехватывают одну и ту же процедуру, учитывайте этот порядок и проверяйте результат на копии.

Признаки конфликта

• форма открывается с ошибкой, хотя до установки второго расширения всё работало;
• одна и та же печатная форма ведёт себя по-разному на разных базах;
• после отключения одного расширения проблема исчезает.

Как найти виновника

1. Отключите все расширения, снимите флаг «Активно» у каждого.
2. Включайте по одному и проверяйте воспроизведение ошибки.
3. Когда ошибка появилась, вы нашли пару.
4. Свяжитесь с автором расширения, чтобы устранить конфликт.

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

Обновление и удаление расширений

После обновления конфигурации

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

Что делать:

1. Не затирайте расширение, не разобравшись, прочитайте текст ошибки.
2. Запросите у разработчика версию, совместимую с новым релизом.
3. Загрузите новую версию тем же способом: система предложит заменить существующее расширение.

Обновление типовой конфигурации стоит планировать так: сначала копия базы, там обновление, там проверка расширений, и только потом боевая база.

Отключение и удаление

Отключить расширение можно, сняв флаг «Активно». Данные при этом остаются, расширение лежит в базе и готово к повторному включению. Полезно, чтобы проверить, виновато ли оно в проблеме.

Удалить совсем: в окне расширений выделите его и нажмите «Удалить». Предварительно:

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

Расширение или доработка конфигурации

Для большинства задач учётной системы расширения хватает.

Как убедиться, что расширение заработало

Загрузка без ошибок ещё не значит, что всё в порядке. Проверьте три вещи.

1. Список расширений. В окне Конфигурация → Расширения конфигурации у расширения нет пометок об ошибках, флаг «Активно» стоит.
2. Пользовательский сценарий. Откройте базу под обычным сотрудником, а не под администратором, и повторите то действие, ради которого ставили расширение.
3. Соседние функции. Расширение могло задеть то, что рядом: откройте пару частых документов и отчётов, проведите тестовый документ.

Мини-кейс: расширение для печатной формы

Бухгалтерия получила от программиста файл с доработанной печатной формой счёта. Порядок действий был такой:

• сделали копию базы и развернули её на тестовом месте;
• загрузили .cfe с включённым безопасным режимом, форма заработала;
• открыли счёт под рядовым менеджером: кнопки печати не было, не хватало роли расширения;
• добавили роль в профиль менеджеров, перезапустили сеанс, печать появилась;
• ту же последовательность повторили на рабочей базе вечером, когда сотрудников не было.

На тестовой копии вся история заняла около получаса. На рабочей базе, где сценарий уже отработан, хватило десяти минут.

Когда расширение ставить не нужно

• Вам нужна одна несложная настройка, которая уже есть в типовых параметрах учёта. Загляните в Администрирование и в настройки раздела, прежде чем заказывать доработку.
• Файл прислали без описания и без контактов автора.
• У базы нет свежей резервной копии, а на проверку времени нет.

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