Глобальная переменная в 1С: как создать и правильно использовать

В платформе 1С:Предприятие нет отдельного объекта «глобальная переменная» в конфигураторе, как, например, у констант или справочников. Глобальная переменная создаётся программно — через объявление экспортной переменной в модуле приложения (управляемое приложение) или в модуле обычного приложения. Такая переменная доступна из любого модуля конфигурации в течение сеанса работы пользователя.

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

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

Где объявляется глобальная переменная

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

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

Перем ТекущийПользовательИмя Экспорт;

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

Пошаговое создание глобальной переменной

Процедура занимает несколько минут и не требует изменения структуры метаданных, только правку кода.

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

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

Перем ТекущийКоэффициент Экспорт;

Процедура ПриНачалеРаботыСистемы()
ТекущийКоэффициент = 1.5;
КонецПроцедуры

После этого в любом модуле — формы, документа, общем — можно писать ТекущийКоэффициент = 2; или читать значение напрямую. Переменная живёт до конца сеанса клиентского приложения.

Перем МояГлобальнаяПеременная Экспорт; // в модуле управляемого приложения

Ограничения в управляемом приложении

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

Второе ограничение — контекст серверных вызовов. Если клиентская процедура передаёт управление на сервер, значение глобальной переменной туда не «переезжает». Его нужно передавать явным параметром процедуры либо хранить на сервере другим способом.

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

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

В зависимости от задачи платформа предлагает несколько более надёжных механизмов. Выбор зависит от того, где нужно значение (клиент, сервер, между сеансами) и как долго оно должно жить.

Параметры сеанса

Параметр сеанса создаётся в конфигураторе: ветка «Общие» → «Параметры сеанса» → добавить новый, задать имя и тип. Значение устанавливается в модуле сеанса в обработчике УстановкаПараметровСеанса:

Процедура УстановкаПараметровСеанса(ТребуемыеПараметры)
ПараметрыСеанса.ТекущееПодразделение = Справочники.Подразделения.НайтиПоКоду("001");
КонецПроцедуры

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

Кэш в общем модуле

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

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

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

Типичные ошибки при работе с глобальными переменными

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

Как выбрать подходящий механизм

Короткий маршрут выбора помогает не ошибиться до начала доработки.

FAQ