Как объявить переменную в общем модуле 1С

В общем модуле 1С переменные объявляются в разделе описания переменных — до первого ключевого слова Процедура или Функция. Такие переменные называют переменными модуля, и они доступны всем процедурам и функциям внутри этого модуля. Если добавить к объявлению ключевое слово Экспорт, переменная станет доступна из других модулей конфигурации через имя общего модуля.

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

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

Где именно объявляются переменные в общем модуле

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

Минимальный синтаксис выглядит так:

Перем КэшСоответствий;
Перем СчетчикОбращений Экспорт;

Функция ПолучитьЗначение(Ключ) Экспорт
...
КонецФункции

Можно объявить несколько переменных в одной строке через запятую:

Перем ПервоеЗначение, ВтороеЗначение, ТретьеЗначение;

Обратите внимание: в 1С нет ключевого слова Var в русском синтаксисе — используется Перем. В английском синтаксисе применяется Var, но смешивать синтаксисы в одном модуле не рекомендуется.

Перем КэшДанных;
Перем ПризнакИнициализации Экспорт;

Процедура Инициализировать() Экспорт
    КэшДанных = Новый Соответствие;
    ПризнакИнициализации = Истина;
КонецПроцедуры

Область видимости: локальные, переменные модуля и экспортные

В 1С существует три уровня видимости переменных. Локальные переменные объявляются внутри процедуры или функции (или создаются неявно при первом присваивании) и живут только во время её выполнения. Переменные модуля видны всем процедурам и функциям этого модуля и сохраняют значение между вызовами. Экспортные переменные модуля дополнительно доступны извне через точку после имени общего модуля.

Обращение к экспортной переменной из другого модуля выглядит так:

ОбщегоНазначения.ПризнакИнициализации = Истина;
ТекущееЗначение = ОбщегоНазначения.ПризнакИнициализации;

Важное ограничение: экспортные переменные общего модуля доступны только на той стороне (клиент или сервер), где скомпилирован модуль. Если модуль серверный, обратиться к его переменной из клиентского кода нельзя — компилятор выдаст ошибку «Переменная не определена».

Инициализация переменных и тело модуля

При объявлении переменной ей нельзя сразу присвоить значение — конструкция Перем А = 5; вызовет ошибку компиляции. Инициализация выполняется либо в теле модуля (код после всех процедур и функций), либо в специальной процедуре инициализации, которую вызывают явно.

Перем КэшДанных;

Функция Получить(Ключ) Экспорт
Если КэшДанных = Неопределено Тогда
КэшДанных = Новый Соответствие;
КонецЕсли;
Возврат КэшДанных[Ключ];
КонецФункции

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

Особенности серверных и клиентских общих модулей

Общий модуль компилируется в тех контекстах, которые отмечены в его свойствах: «Сервер», «Толстый клиент», «Тонкий клиент», «Веб-клиент», «Внешнее соединение». Переменные модуля существуют отдельно в каждом контексте — значение, записанное на сервере, не будет видно на клиенте и наоборот.

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

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

Пошаговая инструкция: как объявить и использовать переменную

Последовательность действий в конфигураторе:

1. Откройте конфигурацию и найдите нужный общий модуль в ветке «Общие» → «Общие модули» (или создайте новый через контекстное меню).
2. Откройте текст модуля двойным щелчком.
3. В самом начале модуля, до первой процедуры, добавьте строку Перем ИмяПеременной; или Перем ИмяПеременной Экспорт;.
4. Добавьте инициализацию: в теле модуля в конце или внутри процедуры с проверкой на Неопределено.
5. Проверьте свойства модуля: убедитесь, что флажки контекстов (Сервер, Клиент) соответствуют тому, откуда будет обращение к переменной.
6. Выполните синтаксическую проверку модуля (меню «Конфигурация» → «Проверка конфигурации» или клавиша F7 в модуле).
7. Протестируйте обращение: из процедуры того же модуля и, если переменная экспортная, из внешнего кода через ИмяМодуля.ИмяПеременной.

1. 1
   Откройте общий модуль в конфигураторе
2. 2
   Добавьте «Перем ИмяПеременной;» до первой процедуры
3. 3
   При необходимости допишите «Экспорт» для внешнего доступа
4. 4
   Инициализируйте значение в теле модуля или лениво при первом обращении
5. 5
   Проверьте контексты компиляции модуля в его свойствах
6. 6
   Запустите синтаксическую проверку и протестируйте обращение

Типичные ошибки и как их избежать

Разработчики чаще всего сталкиваются с несколькими повторяющимися проблемами при работе с переменными общих модулей.

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

Альтернативы переменным общего модуля

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

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

Проверка результата

После объявления переменной убедитесь, что всё работает корректно. Синтаксическая проверка модуля не должна выдавать ошибок. При обращении из внешнего кода к экспортной переменной автоподстановка (Ctrl+Пробел) в модуле должна показывать её после имени общего модуля — это признак корректной компиляции в нужном контексте.

Частые вопросы