Что такое глобальная переменная в 1С

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

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

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

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

Объявление выполняется в разделе переменных модуля управляемого приложения (или модуля обычного приложения для старых конфигураций). Ключевое слово Экспорт делает переменную видимой извне модуля:

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

После объявления обратиться к переменной можно из любого общего модуля, модуля объекта или формы — напрямую по имени. Инициализацию обычно выполняют в обработчике ПриНачалеРаботыСистемы или при первом обращении, чтобы гарантировать, что значение существует до момента чтения.

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

Перем ГлобальныйКэш Экспорт;

Процедура ПриНачалеРаботыСистемы()
    ГлобальныйКэш = Новый Соответствие;
КонецПроцедуры

Область видимости и время жизни

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

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

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

Чем глобальная переменная отличается от параметров сеанса и локальных переменных

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

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

Когда применять глобальные переменные, а когда отказаться

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

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

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

Главное правило — никогда не читать глобальную переменную без гарантии инициализации. Два рабочих подхода: инициализация в ПриНачалеРаботыСистемы либо ленивая инициализация через функцию-обёртку, которая проверяет значение на Неопределено и при необходимости заполняет его.

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

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

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

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

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

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

Как проверить, что всё работает правильно

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

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

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