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

Другое · 7 мин

Переменные в 1С: виды, область видимости и ошибки

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

Переменная в 1С — именованная ячейка, в которой хранятся данные во время выполнения скрипта. Тип не объявляется явно: значение может быть числом, строкой, датой, объектом или неопределённым, и тип определяется присваиваемым значением.

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

Что считать переменной в 1С

Переменная отличается от констант и реквизитов тем, что она существует только во время выполнения кода и не сохраняется в базе автоматически. Присваивание выполняется оператором равно, например: Сумма = 100;.

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

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

Модуль объекта и модуль формы

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

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

Общий модуль

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

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

Переменная не видна в другом модулеНарушена область видимости

Проверьте, описана ли переменная в нужном модуле и экспортирована ли она

Значение равно НеопределеноПеременная не присвоена

Убедитесь, что выполнен ход присваивания перед использованием

Данные отличаются между пользователямиПеременная хранит состояние сеанса

Проверьте, не смешиваются ли сеансовые и общие данные

Параметры процедур и функций

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

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

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

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

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

Переменные, константы и свойства объектов

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

ПризнакПеременнаяКонстантаРеквизит объекта
Где хранитсяВ памяти выполненияВ базе конфигурацииВ записи объекта
Время жизниПока существует контекстПока не удалена константаПока существует объект
ДоступТолько в модуле или через экспортИз любого модуля по имениЧерез объект или выборку
Сохранение при закрытииНе сохраняетсяСохраняетсяСохраняется с объектом

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

Частые ошибки и границы самостоятельной правки

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

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

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

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

Как проверить поведение переменных

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

Порядок действий
  1. 1
    Описать переменную в подходящем модуле с учетом области видимости
  2. 2
    Присвоить значение перед первым чтением
  3. 3
    Проверить значение в отладчике или сообщении
  4. 4
    Проверить на копии базы при нескольких сценариях

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

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

Итог

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

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

Нужно ли объявлять тип переменной в 1С?

Нет, тип не объявляется явно. Переменная принимает тип того значения, которое ей присвоено, и может менять тип в процессе выполнения.

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

Опишите её в общем модуле с ключевым словом Экспорт. Тогда другие модули смогут обращаться к ней через имя этого общего модуля.

Чем переменная отличается от константы?

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

Может ли изменение переменной повредить данные учета?

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