Почему расширение не видит общий модуль основной конфигурации в толстом клиенте?

← На главную

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

Причина проблемы: разница контекстов компиляции

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

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

Кроме того, имеет значение режим работы толстого клиента: «Управляемое приложение» или «Обычное приложение». Если модуль основной конфигурации скомпилирован с признаком Клиент (управляемое приложение), а запуск выполняется в обычном приложении без флага Клиент (обычное приложение), платформа также не предоставит доступ к данному общему модулю.

Способ 1. Использование директив препроцессора

Рассмотрим самое надежное и быстрое решение, если вызов серверного модуля расположен в расширяемом модуле объекта или менеджера. Необходимо явно ограничить компиляцию этого блока инструкциями препроцессора, исключив его компиляцию в контексте толстого клиента управляемого приложения на стороне клиента.

Обернем вызовы процедур и функций в следующую конструкцию:


#Если Сервер Или ТолстыйКлиентОбычноеПриложение Или ВнешнееСоединение Тогда
    // Вызов серверного общего модуля основной конфигурации
    ИмяСерверногоМодуля.ИмяПроцедуры();
#КонецЕсли

Если логика должна гарантированно выполняться исключительно на сервере, применим более строгое условие компиляции:


#Если Сервер Тогда
    ИмяСерверногоМодуля.ВыполнитьДействие();
#КонецЕсли

При таком подходе платформа просто пропустит эти строки при сборке клиентского контекста толстого клиента, что предотвратит возникновение ошибки.

Способ 2. Создание прокси-модуля в расширении

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

Разберем по шагам алгоритм настройки:

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


Процедура ВызватьМетодОсновнойКонфигурации(Параметр1) Экспорт
    ИмяСерверногоМодуляКонфигурации.НужнаяПроцедура(Параметр1);
КонецПроцедуры

Перенаправим вызов из клиентских процедур формы или модуля на наш новый общий модуль:


&НаКлиенте
Процедура КомандаОбработки(Команда)
    МойПроксиМодульСервер.ВызватьМетодОсновнойКонфигурации(Истина);
КонецПроцедуры

Способ 3. Перенос вызова в серверный контекст формы

Если ошибка возникает при обращении из модуля формы расширения, выясним контекст выполнения процедуры. Прямой вызов серверного общего модуля из метода с директивой &НаКлиенте в толстом клиенте завершится ошибкой, если у модуля нет флага клиентского вызова.

Организуем переход на сервер штатным механизмом формы:


&НаКлиенте
Процедура ДействиеНаКлиенте()
    ВыполнитьДействиеНаСервере();
КонецПроцедуры

&НаСервереБезКонтекста
Процедура ВыполнитьДействиеНаСервере()
    // В данном контексте серверный общий модуль доступен всегда
    ИмяСерверногоМодуля.ВыполнитьДействие();
КонецПроцедуры

Способ 4. Проверка параметров безопасного режима

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