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