К статье
Практический материал

Другое · 6 мин

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

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

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

Самый прямой способ создать такую переменную — объявить её на уровне модуля, то есть вне любого описания процедуры или функции. Тогда она будет доступна всем процедурам этого модуля.

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

Что понимают под глобальной переменной в 1С

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

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

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

Откройте нужный модуль в Конфигураторе, поместите курсор в начало или в конец файла, но вне границ любой процедуры или функции, и напишите описание переменной, например: Переменная МояГлобальнаяПеременная;

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

Порядок объявления
  1. 1
    Откройте модуль в Конфигураторе
  2. 2
    Напишите описание переменной вне процедур
  3. 3
    Сохраните модуль и проверьте синтаксис
  4. 4
    Используйте переменную в процедурах этого модуля

Проверьте, что синтаксическая проверка не выдаёт ошибок. Если переменная нужна только в одном модуле, этого достаточно.

Как сделать переменную доступной из других модулей

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

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

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

Альтернативы: константы, переменные сеанса и хранилище значений

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

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

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

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

Как проверить результат и избежать ошибок

После создания переменной запустите проверку синтаксиса модуля, затем выполните процедуру, которая записывает значение, и другую процедуру, которая читает его.

Если вторая процедура видит ожидаемое значение, область видимости настроена верно. Если значение не сохраняется или равно неопределённому, проверьте, не объявлена ли переменная заново внутри процедуры.

Типичные ошибки
01
Объявление переменной внутри процедуры делает её локальной
02
Использование одного и того же имени в разных модулях не создаёт общую переменную
03
Изменение глобального значения без учета многопользовательского режима

Помните, что имя переменной в одном модуле не автоматически становится общим для другого модуля с таким же именем.

Когда самостоятельная правка может быть небезопасной

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

Контрольные точки

Как проверить результат

Значение записано в одной процедуре
Норма

Другая процедура того же модуля читает то же значение

Тревожный признак

Значение равно неопределённому или отличается

Доступ из другого модуля
Норма

Экспортная функция или константа возвращает актуальное значение

Тревожный признак

Ошибка компиляции или переменная не видна

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

Если после изменений работают не все формы или отчёты, откатите правку и обратитесь к разработчику.

Итог

Что важно запомнить

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

Можно ли создать глобальную переменную без программирования?

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

Видна ли переменная модуля в других формах?

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

Сохраняется ли значение после перезапуска 1С?

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

Можно ли использовать одну переменную для всех пользователей?

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

Что делать, если значение не передаётся между процедурами?

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