Разработка и Конфигурация · 10 мин
Как установить доработку в 1С
Пошаговая инструкция по установке доработки в 1С: расширения конфигурации, внешние обработки и изменение конфигурации. Риски, проверка результата и типичные ошибки.
Доработка в 1С — это любое изменение штатного поведения программы: новый отчёт, дополнительная печатная форма, доработанный документ или целый блок функциональности. Способ установки зависит от того, в каком виде поставляется доработка: как расширение конфигурации (файл .cfe), как внешняя обработка или отчёт (.epf, .erf) либо как изменение самой конфигурации (.cf или поставка .cfu).
Выбор правильного механизма важен не только для установки, но и для дальнейшей жизни базы. Расширение можно отключить одной кнопкой, а внесённые напрямую в конфигурацию изменения усложняют обновления. Поэтому перед установкой нужно определить формат доработки и оценить, как она повлияет на поддержку типового решения.
Ниже разобраны три основных способа установки, подготовка базы, проверка результата и типичные ошибки, из-за которых доработка либо не работает, либо ломает обновление.
Определите формат доработки перед установкой
Формат файла определяет весь порядок действий. Расширение конфигурации (.cfe) — самый безопасный вариант: оно накладывается поверх типовой конфигурации и не изменяет её. Внешние обработки и отчёты (.epf, .erf) работают как отдельные файлы и подключаются к конкретным объектам. Файл конфигурации (.cf) или обновление (.cfu) требуют работы в конфигураторе и меняют саму структуру прикладного решения.
Если доработку разрабатывали под заказ, уточните у разработчика, для какой версии конфигурации она собрана. Расширение, написанное под старую версию, может отказаться подключаться или работать некорректно после обновления базы. Также уточните, требуется ли для работы доработки отключение безопасного режима — это влияет на настройки подключения.
Подготовьте базу: резервная копия и права
Любая установка доработки начинается с резервной копии. Для файловой базы достаточно скопировать каталог с файлом 1Cv8.1CD в отдельное место при закрытой программе. Для клиент-серверной базы штатный способ — выгрузка через конфигуратор: «Администрирование → Выгрузить информационную базу». Выгрузка в .dt пригодна для восстановления, хотя для больших баз администраторы обычно используют средства СУБД.
Для установки потребуются права: полные права в прикладном решении и право администрирования для работы с расширениями. В клиент-серверном варианте также проверьте, что у вас есть доступ к конфигуратору, а другие пользователи на время установки изменений в конфигурацию завершили сеансы — обновление структуры базы требует монопольного доступа.
Установка расширения конфигурации (.cfe)
Это основной и рекомендуемый способ. В пользовательском режиме откройте «Администрирование → Печатные формы, отчеты и обработки» (в некоторых конфигурациях путь называется «Настройки → Расширения» или находится в разделе «Администрирование → Расширения»). Если пункт недоступен, включите соответствующую функциональность в настройках программы.
В открывшемся списке расширений нажмите «Добавить из файла» и выберите файл .cfe. Программа загрузит расширение и покажет его в списке. Обратите внимание на колонки «Безопасный режим» и «Защита от опасных действий»: если разработчик подтвердил, что код безопасен, снимите флажки — иначе обращения к файловой системе или внешним компонентам будут блокироваться.
После добавления перезапустите сеанс: многие расширения активируются только при новом входе в программу. Проверьте, что расширение активно (флажок в списке установлен) и не имеет ошибок в колонке состояния.
- 1Сделайте резервную копию базы
- 2Откройте «Администрирование → Печатные формы, отчеты и обработки → Расширения»
- 3Нажмите «Добавить из файла» и выберите .cfe
- 4Настройте безопасный режим по рекомендации разработчика
- 5Перезапустите сеанс и проверьте работу доработки
Подключение внешних обработок и отчётов (.epf, .erf)
Разовую внешнюю обработку можно просто открыть через «Файл → Открыть» — она запустится без установки. Для постоянного использования подключите её через механизм «Дополнительные отчеты и обработки»: «Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки». Предварительно включите одноимённый флажок функциональности на той же форме.
При добавлении обработки программа прочитает её сведения: вид (печатная форма, заполнение, отчёт), объекты назначения и команды. Укажите, для каких документов или справочников она доступна, и настройте быстрый доступ — какие пользователи увидят команду. Для печатных форм проверьте, что команда появилась в меню «Печать» нужного документа.
Если обработка открывается с предупреждением о безопасности, это штатное поведение платформы при открытии файлов из внешних источников. Запускайте только обработки из доверенных источников: внешний код имеет полный доступ к данным базы.
Установка доработки через конфигуратор (.cf)
Изменения, поставляемые файлом конфигурации, устанавливаются только через конфигуратор. Откройте его, зайдите в базу под пользователем с правами администратора и выполните «Конфигурация → Загрузить конфигурацию из файла» для полной замены либо «Конфигурация → Поддержка → Настройка поддержки» и «Сравнить, объединить с конфигурацией из файла» для точечного переноса доработок.
Режим сравнения и объединения предпочтительнее: он показывает, какие объекты изменятся, и позволяет отметить только нужные. После объединения выполните «Конфигурация → Обновить конфигурацию базы данных». Если платформа сообщит об изменении структуры данных, потребуется монопольный режим — все пользователи должны выйти.
Учтите: объекты, изменённые напрямую, частично или полностью снимаются с поддержки поставщика. При следующем типовом обновлении эти объекты придётся сопоставлять вручную. Именно поэтому, если доработку можно реализовать расширением, выбирайте расширение.
Способы установки доработки
Подходит для большинства доработок. Не мешает обновлениям, легко отключается. Ограничение: не все объекты можно изменить расширением.
Подходит для печатных форм, отчётов, сервисных операций. Не изменяет конфигурацию вообще. Ограничение: не может менять штатные формы и проведение документов.
Позволяет любые изменения. Ограничение: усложняет обновления, требует конфигуратора и монопольного доступа.
Проверка результата после установки
После установки проверьте доработку на тестовых данных или на копии документов: откройте изменённую форму, выполните новую команду, сформируйте печатную форму или отчёт. Убедитесь, что штатные функции, которых коснулась доработка, продолжают работать — проведение документов, формирование стандартных отчётов, обмены данными.
Для расширений полезно проверить состояние в списке расширений: активное расширение без ошибок отображается с установленным флажком. Если после обновления конфигурации расширение отключилось, в списке появится соответствующая отметка — это сигнал, что доработку нужно адаптировать под новую версию.
Как проверить результат
Флажок установлен, ошибок нет
Расширение отключено или помечено как несовместимое
Команда появилась и выполняется без ошибок
Команды нет в интерфейсе или возникает ошибка при вызове
Проведение документов и отчёты работают как раньше
Ошибки при проведении, пропавшие кнопки, сбои обменов
Типичные ошибки и ограничения
Самая частая ошибка — установка без резервной копии. Даже «безобидное» расширение может содержать код, изменяющий данные при записи документов, и откатить последствия без копии будет нечем. Вторая типичная проблема — несоответствие версий: расширение, собранное под другой релиз конфигурации, отключается после обновления или вызывает ошибки в изменённых объектах.
Третья группа ошибок связана с безопасным режимом: обработка «не работает», потому что платформа блокирует обращение к файлам или интернету. Решение — осознанная настройка безопасного режима для доверенной доработки, а не глобальное отключение защиты. Также помните об ограничениях расширений: они не позволяют менять некоторые объекты (например, планы обмена в части состава, роли в полном объёме), и для таких задач потребуется доработка конфигурации.
Частые вопросы
Можно ли установить доработку без конфигуратора?
Да, если она поставляется как расширение (.cfe) или внешняя обработка (.epf, .erf) — оба механизма подключаются в пользовательском режиме через раздел администрирования. Конфигуратор нужен только для изменений самой конфигурации (.cf, .cfu).
Что делать, если расширение отключилось после обновления?
Откройте список расширений и посмотрите причину несовместимости. Обычно изменился объект, который расширение заимствует или изменяет. Потребуется адаптация расширения разработчиком под новую версию конфигурации — самостоятельно включать его принудительно не стоит.
Безопасно ли снимать флажок «Безопасный режим»?
Безопасный режим ограничивает доступ кода к файловой системе, внешним компонентам и сети. Снимать флажок допустимо только для доработок из доверенного источника, когда разработчик подтвердил необходимость таких обращений. Для неизвестных обработок защиту отключать нельзя.
Как удалить установленную доработку?
Расширение удаляется из списка расширений кнопкой удаления или просто отключается снятием флажка. Внешняя обработка удаляется из справочника дополнительных отчётов и обработок. Изменения, внесённые в конфигурацию через конфигуратор, откатываются только восстановлением из резервной копии или повторным объединением с типовой конфигурацией.
Нарушит ли доработка гарантию или поддержку 1С?
Расширения и внешние обработки не затрагивают типовую конфигурацию и не влияют на поддержку. Прямое изменение конфигурации снимает изменённые объекты с полной поддержки — обновления продолжат работать, но изменённые объекты придётся сопоставлять вручную при каждом обновлении.
Можно ли установить одну доработку сразу в несколько баз?
Да. Расширение или обработка подключаются в каждую базу отдельно тем же способом. При этом проверяйте совместимость с версией конфигурации каждой базы — если базы на разных релизах, доработка может потребовать адаптации.
Что важно запомнить
Сначала резервная копия, затем установка. Предпочтительный формат доработки — расширение конфигурации: оно не мешает обновлениям и легко отключается. Изменения через конфигуратор — только при невозможности решить задачу расширением и обязательно после теста на копии базы.