Как организовать выполнение одного и того же кода на клиенте и на сервере в зависимости от условий в 1С?

В процессе разработки в системе 1С:Предприятие часто возникает задача унификации кода. Например, когда алгоритм расчета должен запускаться интерактивно пользователем (с данными, которые еще не записаны в базу и находятся на клиенте) и одновременно с этим — автоматически при старте системы или по регламентному заданию (полностью на стороне сервера). Рассмотрим подробнее, как реализовать такую логику, какие инструменты предоставляет платформа и какие "подводные камни" могут встретиться на пути.

Разбор ситуации: Директивы компиляции против инструкций препроцессора

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

Директивы компиляции (начинаются с символа &) используются в модулях управляемых форм и команд. Они указывают платформе, в какой контекст "поместить" процедуру или функцию при компиляции модуля.

1. &НаКлиенте — процедура доступна только на стороне клиента.
2. &НаСервере — процедура выполняется на сервере с передачей всего контекста формы.
3. &НаСервереБезКонтекста — серверный вызов без передачи данных формы (наиболее производительный вариант).
4. &НаКлиентеНаСервереБезКонтекста — специальная директива, которая создает две копии метода: одну для клиента, другую для сервера.

Инструкции препроцессора (начинаются с символа #) работают на этапе предварительной сборки кода. Они буквально вырезают или оставляют куски текста программы в зависимости от среды исполнения. Они чаще всего применяются в общих модулях.

#Если Сервер Тогда
    // Этот код попадет только в серверную сборку
    Результат = ВыполнитьРасчетНаСервере();
#ИначеЕсли НаКлиенте Тогда
    // Этот код будет доступен только клиенту
    Результат = ВыполнитьРасчетНаКлиенте();
#КонецЕсли

Метод 1: Использование директивы &НаКлиентеНаСервереБезКонтекста

Если ваша задача — написать математический расчет, обработку строки или заполнение структуры, которая не требует обращения к базе данных напрямую, этот метод идеален. Рассмотрим, как это работает в модуле формы. Проанализируем пример кода:

&НаКлиентеНаСервереБезКонтекста
Процедура РассчитатьПоказатели(ПараметрыРасчета) Экспорт
    // Данный код будет скомпилирован и для клиента, и для сервера
    ПараметрыРасчета.Результат = ПараметрыРасчета.Цена * ПараметрыРасчета.Количество;
КонецПроцедуры

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

Метод 2: Работа с общими модулями

Когда расчет должен инициироваться и при запуске системы (в МодулеУправляемогоПриложения), и в процессе работы из формы, правильнее всего вынести логику в Общий модуль. Выясним причину, по которой в общих модулях не работают директивы типа &НаСервере. В общих модулях управление средой выполнения осуществляется через свойства самого модуля (флажки в конфигураторе).

Рассмотрим по шагам настройку такого модуля:

1. Создаем общий модуль (например, ОбщийРасчетСервер).
2. В свойствах модуля устанавливаем флаги "Сервер" и "Вызов сервера".
3. Если нам нужно, чтобы этот же модуль был доступен на клиенте без обращения к серверу, можно поставить флаг "Клиент (управляемое приложение)".

Однако здесь кроется нюанс: если у модуля включены флаги и "Клиент", и "Сервер", то при вызове его метода с клиента, 1С попытается выполнить его именно на клиенте. Чтобы гарантировать выполнение на сервере, лучше разделять модули на чисто серверные и клиентские, либо использовать инструкции препроцессора внутри методов.

Проблема доступа из Модуля Приложения

Иногда разработчики сталкиваются с тем, что МодульУправляемогоПриложения "не видит" процедуру, даже если она помечена правильной директивой. Разберем основные причины:

• Отсутствие ключевого слова Экспорт: Любая процедура, вызываемая извне модуля, должна заканчиваться словом Экспорт.
• Тип приложения: В настройках общего модуля должен быть включен флаг, соответствующий среде вызова (например, "Клиент (управляемое приложение)" для тонкого клиента).
• Компиляция: Если процедура находится в модуле формы, она не может быть вызвана из модуля приложения напрямую. Логику нужно выносить в общие модули.

Передача данных с клиента на сервер через Временное хранилище

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

1. На клиенте помещаем данные (например, массив структур или таблицу значений) во временное хранилище с помощью функции ПоместитьВоВременноеХранилище().
2. Получаем Адрес (навигационную ссылку).
3. Передаем этот Адрес в серверную процедуру общего модуля.
4. На сервере извлекаем данные функцией ПолучитьИзВременногоХранилища(Адрес).

Пример реализации передачи данных:

// На клиенте
АдресДанных = ПоместитьВоВременноеХранилище(МояТаблицаДанных, ЭтаФорма.УникальныйИдентификатор);
ОбщийРасчетСервер.ВыполнитьОбработкуНаСервере(АдресДанных);

// В общем модуле (Сервер, Вызов сервера)
Процедура ВыполнитьОбработкуНаСервере(АдресДанных) Экспорт
    Данные = ПолучитьИзВременногоХранилища(АдресДанных);
    // Теперь данные доступны для серверных запросов и расчетов
КонецПроцедуры

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