Какие бывают директивы в 1С и как их применять

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

В платформе 1С:Предприятие существует три большие группы директив: директивы компиляции (окружающие процедуры и функции в модулях форм и команд), инструкции препроцессора (условная компиляция через #Если) и аннотации методов (например, &Перед, &После, &ИзменениеИКонтроль в расширениях). Каждая группа решает свою задачу и имеет собственный синтаксис.

Понимание директив критично при работе с управляемыми формами, потому что именно там код распределяется между клиентом и сервером. В обычных формах и толстом клиенте большинство директив компиляции просто не имеет смысла — весь код выполняется на клиенте.

Директивы компиляции: где выполняется код

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

Всего существует четыре директивы компиляции:

• &НаКлиенте — метод компилируется и выполняется на клиенте. Доступны интерактивные действия: вопросы пользователю, открытие форм, работа с файловой системой клиента. Недоступны прямые запросы к базе данных и серверный контекст.
• &НаСервере — метод выполняется на сервере с доступом к данным формы. Можно работать с запросами, объектами базы данных, при этом реквизиты формы доступны через контекст.
• &НаСервереБезКонтекста — метод выполняется на сервере, но данные формы в него не передаются. Такой вызов дешевле по ресурсам, потому что не требует сериализации всей формы.
• &НаКлиентеНаСервереБезКонтекста — метод компилируется и на клиенте, и на сервере, без контекста формы. Используется для общих вспомогательных алгоритмов, например расчётов или форматирования, которые одинаково нужны с обеих сторон.

&НаКлиенте
Процедура РассчитатьИтог(Команда)
	РассчитатьИтогНаСервере();
КонецПроцедуры

&НаСервереБезКонтекста
Процедура РассчитатьИтогНаСервере()
	// работа с данными без контекста формы
КонецПроцедуры

Важно помнить: директива &НаКлиентеНаСервереБезКонтекста в модуле формы по факту работает только на сервере при вызове из серверного кода и только на клиенте при вызове из клиентского — переключения контекста она не выполняет. Для вызова сервера из клиента нужен именно серверный метод.

Как выбрать правильную директиву компиляции

Выбор директивы определяется двумя вопросами: нужны ли данные формы и где должны выполняться действия. Если метод работает с СКД, запросами или объектами базы — это сервер. Если метод открывает диалоги, работает с элементами формы или файлами пользователя — это клиент.

Частая ошибка — помечать &НаСервере методы, которым достаточно передать два-три параметра. Каждый такой вызов сериализует всю форму, пересылает её на сервер и обратно, что при большом числе реквизитов и табличных частей заметно тормозит интерфейс. Перепишите метод на &НаСервереБезКонтекста и передавайте только нужные данные параметрами.

Инструкции препроцессора: условная компиляция

Вторая группа директив — инструкции препроцессора. Они работают на этапе компиляции модуля и позволяют включать или исключать фрагменты кода в зависимости от среды исполнения. Синтаксис строится на конструкциях #Если ... #ИначеЕсли ... #Иначе ... #КонецЕсли.

Доступные символы препроцессора:

• Клиент — код компилируется для любого клиентского приложения;
• ТонкийКлиент, ВебКлиент, ТолстыйКлиентУправляемоеПриложение, ТолстыйКлиентОбычноеПриложение — конкретные виды клиентов;
• Сервер — код компилируется на сервере;
• ВнешнееСоединение — код выполняется в режиме внешнего соединения (COM);
• МобильныйКлиент, МобильноеПриложениеКлиент, МобильноеПриложениеСервер — для мобильной платформы.

#Если Сервер Тогда
	Сообщить("Выполняется на сервере");
#ИначеЕсли ВебКлиент Тогда
	// ограниченная функциональность веб-клиента
#Иначе
	// тонкий или толстый клиент
#КонецЕсли

Ключевое отличие от директив компиляции: препроцессор работает внутри тела метода и позволяет одному и тому же методу иметь разное поведение в разных средах. Это особенно полезно в общих модулях с включёнными флагами «Клиент» и «Сервер» одновременно.

Аннотации методов в расширениях конфигурации

Третья группа директив появилась вместе с механизмом расширений. Аннотации указывают, как заимствованный метод соотносится с методом основной конфигурации. Они ставятся перед процедурой или функцией в модуле расширения.

• &Перед("ИмяМетода") — метод расширения выполняется до метода конфигурации;
• &После("ИмяМетода") — выполняется после метода конфигурации;
• &Вместо("ИмяМетода") — полностью замещает метод конфигурации; вызвать исходный можно через ПродолжитьВызов();
• &ИзменениеИКонтроль("ИмяМетода") — метод копируется в расширение целиком с вставками-изменениями; при обновлении конфигурации платформа помогает отследить расхождения с новой версией исходного метода.

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

Правила вызова между клиентом и сервером

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

Также существуют ограничения на передаваемые типы. В &НаСервереБезКонтекста нельзя передать данные формы напрямую — только сериализуемые значения: примитивы, структуры, массивы, ссылки. Попытка передать, например, ДанныеФормы приведёт к ошибке исполнения.

Где какие директивы применяются

Не все модули поддерживают все директивы. В модуле объекта, модуле менеджера и модуле набора записей директивы компиляции не используются вовсе — эти модули всегда исполняются на сервере (или в толстом клиенте в режиме обычного приложения). Директивы нужны там, где модуль компилируется в нескольких контекстах.

В общих модулях распределение по контекстам задаётся не директивами, а свойствами самого модуля: флаги «Клиент (управляемое приложение)», «Сервер», «Внешнее соединение», «Вызов сервера». Флаг «Вызов сервера» особенно важен — без него клиентский код не сможет обратиться к процедурам серверного общего модуля.

Практические рекомендации по оформлению кода

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

Минимизируйте количество серверных вызовов из клиентских обработчиков. Если при изменении поля нужно выполнить три проверки на сервере, объедините их в один серверный метод вместо трёх отдельных вызовов. Каждый вызов — это сетевой обмен, и в веб-клиенте или при медленном канале разница ощутима.

Частые вопросы о директивах 1С