Другое · 7 мин
Переменная не определена в 1С: причины и порядок исправления
Разбираем причины ошибки «Переменная не определена» в 1С: область видимости, экспорт общих модулей, опечатки в именах и порядок исправления в конфигурации.
Ошибка «Переменная не определена» в 1С означает, что в текущем контексте исполнения нет имени, на которое ссылается код. Она может появиться при компиляции модуля или уже во время запуска обработки, отчёта или документа. Первым делом нужно определить, где именно возникает сообщение: в строке с объявлением, при вызове процедуры или при обращении к реквизиту.
Чаще всего проблема связана с областью видимости: переменная объявлена внутри одной процедуры, а используется в другой, или описана в модуле объекта, а обращение идёт из общего модуля. Также возможны опечатки в имени, разный регистр или отсутствие ключевого слова Экспорт при обращении из другого модуля.
Исправление зависит от типа конфигурации, клиента (толстый, тонкий, веб) и места кода: модуль формы, модуль объекта, общий модуль или менеджер сервера. Неправильное редактирование может привести к тому, что код перестанет компилироваться или начнёт работать некорректно в части пользователей.
Уточните, где именно возникает ошибка
Сообщение может выводиться в окне отладки, при синтаксической проверке конфигурации или непосредственно пользователю при выполнении команды. Если ошибка появляется при открытии формы, вероятнее всего причина в модуле формы или в модуле объекта. Если при проведении документа — проверьте модуль документа и общие модули, участвующие в проведении.
Обратите внимание на строку, указанную в тексте ошибки. Она указывает на место, где 1С не нашла описание имени. Это не всегда означает, что переменная вообще не объявлена: возможно, она объявлена, но недоступна именно в этом фрагменте кода.
Проверьте объявление в этом же модуле или подключение общего модуля
Проверьте порядок выполнения и условия ветвления
Убедитесь, что имя помечено как Экспорт
Проверьте объявление и область видимости переменной
Переменная, описанная в начале процедуры или функции, живет только внутри этой процедуры. Вы не сможете обратиться к ней из другой процедуры того же модуля, если не передать её в качестве параметра или не описать на уровне модуля. Переменные на уровне модуля доступны всем процедурам этого модуля, но не автоматически доступны в других модулях.
Если переменная описана в модуле формы, код модуля объекта к ней не имеет доступа, и наоборот. Для обмена данными между модулями используют параметры процедур, реквизиты объектов или общие модули с экспортируемыми функциями и переменными.
Когда переменная описана в условии или цикле
В некоторых случаях переменная может быть описана внутри ветви условия или цикла. Если код обращается к ней за пределами этой ветви, платформа может не найти имя. Убедитесь, что описание переменной находится на уровне, доступном для всех мест её использования.
Ищите опечатки и несоответствие имён
1С чувствительна к точному совпадению имён. Если переменная описана как СуммаЗаказа, а в коде используется суммазаказа или СуммаЗаказас, платформа выдаст ошибку. Проверьте регистр, лишние пробелы, опечатки и невидимые символы, которые могли попасть в текст при копировании.
Полезно открыть синтаксис-помощник или перейти к объявлению переменной через контекстное меню редактора кода. Если переход невозможен, имя скорее всего не описано в текущем контексте. Сравните описание и использование посимвольно.
Проверьте экспорт и подключение общих модулей
Если переменная или функция находится в общем модуле, она должна быть помечена ключевым словом Экспорт. Иначе модуль скомпилируется, но другие модули не увидят это имя. Также общий модуль должен быть подключен к объекту, где используется переменная: в свойствах конфигурации или программно через ПодключитьОбщийМодуль.
Проверьте, не переименован ли общий модуль и не изменён ли его набор экспортируемых объектов. После изменений в общем модуле необходимо обновить конфигурацию базы данных, иначе клиентские модули могут работать со старой версией описания.
Если переменная принадлежит объекту конфигурации
Иногда разработчики путают переменную модуля с реквизитом документа, справочника или регистра. Реквизит обращается через объект, например Объект.Сумма, а не просто Сумма. Если реквизит не создан в конфигурации, обращение к нему тоже приведёт к ошибке «Переменная не определена».
Учитывайте клиент-серверный контекст
Код, выполняющийся на сервере, не видит переменные, описанные только в клиентском модуле формы, и наоборот. Для передачи данных между клиентом и сервером используют параметры вызова серверных процедур, значения реквизитов или общие модули, выполнение которых разрешено на нужном уровне.
В тонком и веб-клиенте часть кода может выполняться на сервере автоматически. Если ошибка появляется только у некоторых пользователей или только в веб-интерфейсе, проверьте, не зависит ли переменная от клиентского окружения.
Если причина не находится: порядок действий
Начните с полной синтаксической проверки конфигурации. Платформа покажет все модули, где имена не разрешены. Откройте каждый указанный модуль и найдите строку из текста ошибки. Посмотрите, описана ли переменная выше по коду или в другом модуле.
- 1Определить модуль и строку ошибки
- 2Проверить описание переменной в этом и связанных модулях
- 3Сравнить написание имён и регистр
- 4Проверить ключевое слово Экспорт и подключение общего модуля
- 5Внести исправление и выполнить синтаксическую проверку
Используйте поиск по конфигурации по имени переменной. Это покажет все места описания и использования. Если имя встречается только в одном месте, скорее всего, оно не объявлено. Если встречается в нескольких, сравните контексты и определите, почему в проблемном модуле имя не видно.
После исправления обязательно обновите конфигурацию базы и проверьте работу на копии, а не сразу на производственной базе. Убедитесь, что ошибка исчезла для всех типов клиентов, где используется изменённый код.
Что важно запомнить
Ошибка обычно означает не отсутствие переменной вообще, а её недоступность в текущем контексте из-за области видимости, опечатки или отсутствия экспорта.
Нужно ли перезапускать 1С после исправления переменной?
После изменения кода и обновления конфигурации обычно достаточно переоткрыть форму или перезапустить сеанс, чтобы изменения вступили в силу. Полный перезапуск приложения требуется не всегда, но может помочь, если старый код остался в памяти клиента.
Может ли ошибка быть только у отдельных пользователей?
Да, если код выполняется по-разному в зависимости от прав доступа, ролей или типа клиента. Переменная может быть описана в модуле, доступном не всем, или использоваться в процедуре, которая вызывается только при определённых условиях.
Что делать, если переменная есть, но ошибка осталась?
Проверьте, не затеняется ли имя локальной переменной переменной модуля, и не находится ли описание в недостижимой части кода. Также убедитесь, что конфигурация обновлена после внесения изменений.
Отличается ли порядок для тонкого и толстого клиента?
Причины ошибки одинаковы, но место выполнения кода может различаться. Переменная клиентского модуля недоступна в серверной процедуре, поэтому данные нужно передавать через параметры или реквизиты объекта.