1С Расширения: как удалить и очистить кэш

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

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

Процесс деинсталляции зависит от того, работаете ли вы в режиме обычного пользователя с полными правами или имеете доступ к режиму Конфигуратор. Также важно учитывать тип базы данных — файловый вариант или клиент-серверный SQL-сервер, так как это влияет на права доступа и способы выполнения операций.

Анализ установленных расширений перед удалением

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

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

Обратите внимание на колонку «Версия» и «Поставщик». Часто в системе могут висеть несколько версий одного и того же продукта от разных разработчиков, например, от фирмы 1С и стороннего вендора. Удаление дубликатов может освободить ресурсы сервера и ускорить запуск платформы.

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

Удаление через интерфейс режима Предприятия

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

Зайдите в систему под пользователем с полными правами. Перейдите в раздел НСИ и администрирование, затем выберите пункт Печатные формы, отчеты и обработки. В открывшемся списке найдите нужное расширение. Если оно активно, рядом с ним будет стоять галочка или индикатор.

Выделите строку с расширением и нажмите кнопку Еще в нижней панели списка. В выпадающем меню выберите пункт Удалить. Система запросит подтверждение действия. После согласования расширение будет помечено на удаление и исчезнет из списка активных модулей после перезапуска сеанса или обновления списка.

• 🗑️ Этот способ автоматически обновляет таблицу метаданных конфигурации.
• 🔒 Требуется наличие права Администрирование у текущего пользователя.
• 🔄 Изменения вступают в силу немедленно для новых сеансов.

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

Деинсталляция в режиме Конфигуратор

Для более глубокого управления метаданными необходимо использовать режим Конфигуратор. Этот метод дает прямой доступ к дереву объектов и позволяет видеть скрытые зависимости, которые не отображаются в пользовательском интерфейсе. Запустите платформу в режиме конфигуратора с правами администратора.

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

После удаления объекта из дерева метаданных необходимо выполнить обновление конфигурации базы данных. Нажмите комбинацию клавиш Ctrl+U или выберите в меню Конфигурация -> Обновить конфигурацию базы данных. Система предложит завершить обновление, согласитесь с предложением.

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

Если система сообщает, что объект заблокирован другими пользователями, необходимо завершить все активные сеансы в консоли управления кластером серверов или попросить пользователей выйти из системы.

Существует нюанс с расширениями, которые были установлены «только для чтения». Такие объекты нельзя модифицировать или удалять напрямую, если они получены из файла поставки с соответствующим флагом. В этом случае требуется сначала снять флаг защиты или удалить всё расширение целиком как контейнер.

⚠️ Внимание: При удалении расширений в конфигураторе обязательно создайте резервную копию файла конфигурации (.cf) перед началом работ. Откатить изменения метаданных без бэкапа крайне сложно.

Очистка кэша и временных файлов

Даже после корректного удаления расширения из метаданных, платформа 1С может продолжать использовать старые данные, хранящиеся в локальном кэше пользователя. Это часто приводит к ошибкам вида «Объект не найден» или появлению «призрачных» кнопок в интерфейсе.

Для очистки кэша необходимо найти директорию временных файлов на компьютере клиента. Путь к кэшу обычно выглядит как C:\Users\ИмяПользователя\AppData\Local\1C\1Cv8. Внутри этой папки находятся подкаталоги с хэш-суммами, соответствующим конкретным базам данных.

Самый надежный способ очистить кэш — использовать встроенные средства платформы. Запустите 1С в режиме предприятия с ключом командной строки /ClearCache. Это принудительно удалит все временные файлы и заставит систему заново скомпилировать формы и модули.

1cv8.exe /F"C:\BasePath" /ClearCache

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

Удаление через командную строку и консоль управления

В серверных вариантах установки, особенно в кластерах с несколькими рабочими серверами, удаление расширений часто выполняется централизованно. Для этого используется утилита командной строки ras или консоль управления кластером серверов 1С:Предприятие.

С помощью утилиты ras можно список расширений и удалить их по идентификатору. Команда имеет следующий синтаксис: ras cluster list extensions --cluster=UUID --base=UUID. Для удаления используется параметр delete extension с указанием имени или UID расширения.

Параметр	Описание	Пример значения
--cluster	Уникальный идентификатор кластера	1c83-cluster-uuid
--base	Уникальный идентификатор информационной базы	infobase-uuid-123
--name	Имя удаляемого расширения	MyExtension
--file	Путь к файлу расширения (для обновления)	C:\cf\ext.cfe

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

При работе с консолью управления помните, что изменения применяются к кластеру в целом. Если вы удалите расширение на центральном сервере, оно станет недоступным для всех подключенных рабочих серверов после синхронизации реестра кластера.

Типичные ошибки и способы их решения

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

Для решения этой проблемы необходимо завершить все сеансы. Зайдите в Администрирование -> Активные пользователи и завершите лишние подключения. Если это не помогает, перезапустите службу Агент сервера 1С:Предприятия на сервере.

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

⚠️ Внимание: Интерфейс и названия пунктов меню могут отличаться в зависимости от версии платформы 1С и используемой конфигурации (Бухгалтерия, УТ, ЗУП). Всегда сверяйтесь с документацией к вашей конкретной версии.

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

FAQ: Часто задаваемые вопросы

Можно ли удалить расширение, если база работает в файловом варианте?

Да, можно. В файловом варианте удаление происходит аналогично клиент-серверному, но требуется монопольный доступ к файлу базы данных. Убедитесь, что никто другой не открыл базу в этот момент.

Что будет, если просто удалить файл.cfe из папки?

Это не рекомендуется. Простое удаление файла не уберет ссылки на объекты расширения из метаданных базы. Это приведет к ошибкам при запуске и работе системы. Используйте штатные средства удаления.

Как узнать, кто установил расширение?

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

Нужно ли перезагружать сервер после удаления?

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