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