Привет! Каждый, кто пишет код в 1С, сталкивался с этой ситуацией. Жмешь кнопку «Проверить синтаксис» или пытаешься запустить отладку, и конфигуратор выдает до боли знакомое сообщение: «Переменная не определена (ИмяПеременной)».
Смысл ошибки прост: платформа встретила в коде слово, которое считает переменной, но понятия не имеет, откуда оно взялось и что в себе хранит. Давайте без лишней теории разберем 4 классические причины этой ошибки, посмотрим на примеры кода и разберемся, как писать правильно.
1. Банальные опечатки и коварная раскладка клавиатуры
Самая частая и обидная причина — вы просто ошиблись в написании имени переменной или случайно смешали русские и английские буквы (например, написали английскую «C» вместо русской «С»).
Как делать не надо (ошибка)
// Объявляем переменную КонтрагентСсылка = Справочники.Контрагенты.ПустаяСсылка(); // Ниже ошибаемся в имени переменной (пропустили букву «а») Если КонтргентСсылка = Неопределено Тогда // Компилятор выдаст: Переменная не определена (КонтргентСсылка) Возврат; КонецЕсли;
Как исправить
Проверьте написание. Самый простой способ — дважды кликнуть по объявленной переменной. В современном конфигураторе (или в EDT) все идентичные переменные на экране подсветятся. Если ваша «ошибочная» переменная не подсветилась — вы точно опечатались.
2. Область видимости переменных (Контекст)
Переменная, созданная внутри одной процедуры или функции, является локальной, и видна только в самой этой процедуре или функции. Другие методы модуля о ней ничего не знают.
Как делать не надо (ошибка)
Процедура РассчитатьСкидку() ПроцентСкидки = 5; // Переменная живет только внутри этой процедуры КонецПроцедуры Процедура ЗаполнитьДокумент() // Попытка обратиться к переменной из соседней процедуры ИтоговаяСкидка = ПроцентСкидки; // Ошибка: Переменная не определена (ПроцентСкидки) КонецПроцедуры
Как исправить
Передавайте нужные данные через параметры процедур и функций либо возвращайте их в качестве результата:
Функция ПолучитьПроцентСкидки() Возврат 5; КонецФункции Процедура ЗаполнитьДокумент() // Получаем значение функции в локальную переменную ПроцентСкидки = ПолучитьПроцентСкидки(); ИтоговаяСкидка = ПроцентСкидки; // Теперь всё работает корректно! КонецПроцедуры
Примечание: Если вам действительно нужна переменная, доступная во всем модуле, объявите её в самом верху модуля с помощью ключевого слова Перем ИмяПеременной;, но не злоупотребляйте этим инструментом без явной необходимости.
3. Проблемы контекста: Клиент и Сервер
В управляемом приложении 1С код четко делится на тот, который выполняется на клиенте (в браузере или тонком клиенте), и тот, который работает на сервере. Переменные, объявленные на клиенте, не переносятся на сервер «сами по себе».
Как делать не надо (ошибка)
&НаКлиенте Перем ИмяКомпьютераКлиента; // Объявили переменную на клиенте &НаСервере Процедура ВыполнитьНаСервере() // Попытка использовать клиентскую переменную на сервере ИмяКомпьютераКлиента = "РабочийПК"; // Ошибка: Переменная не определена КонецПроцедуры
Сюда же можно отнести и обратную ситуацию, например, попытка обратиться к менеджерам объектов из клиентского кода. Допустим, в модуле приложения (все же помним, что он клиентский? 🙂 ) пытаемся создать документ:
Процедура ПриНачалеРаботыСистемы() НовыйДокумент = Документы.РасходнаяНакладная.СоздатьДокумент(); // Переменная не определена (Документы) КонецПроцедуры
Как исправить
Не пытайтесь использовать переменные модуля формы для передачи данных между контекстами клиента и сервера. Правильный путь — передавать данные в качестве параметров серверных процедур или использовать реквизиты формы (они доступны везде):
&НаКлиенте Процедура КомандаВыполнить(Команда) ИмяКлиента = "Пользователь1"; // Передаем локальную переменную на сервер как параметр ВыполнитьНаСервере(ИмяКлиента); КонецПроцедуры &НаСервереБезКонтекста Процедура ВыполнитьНаСервере(Знач ИмяКлиента) // Сервер принял параметр и успешно с ним работает Сообщить(ИмяКлиента); КонецПроцедуры
4. Игры с директивами условной компиляции
Иногда мы пишем код, который должен выполняться только на сервере или только в толстом клиенте, используя инструкции препроцессора #Если... #КонецЕсли. Если объявить переменную внутри такой инструкции, а попытаться использовать снаружи — ждите ошибку.
Как делать не надо (ошибка)
#Если Сервер Тогда РежимРаботы = "Серверный"; #КонецЕсли // Если этот модуль компилируется на клиенте, переменная РежимРаботы не создастся Сообщить(РежимРаботы); // Ошибка: Переменная не определена (РежимРаботы)
Как исправить
Следите за тем, чтобы обращение к переменной происходило внутри тех же самых условий компиляции, где она была создана:
#Если Сервер Тогда РежимРаботы = "Серверный"; // Обращаемся там же, где объявили Сообщить(РежимРаботы); #КонецЕсли
Подведем итог
Ошибка «Переменная не определена» — это не повод паниковать, а лишь сигнал быть внимательнее к деталям:
- Проверьте опечатки и раскладку клавиатуры.
- Посмотрите, в той ли процедуре вы пытаетесь прочитать переменную, где её создали.
- Проверьте директивы &НаКлиенте/&НаСервере у процедур.
Успехов в разработке!
Чувствуете, что застряли в основах 1С?
Информация в интернете кажется обрывочной, а на решение простых задач уходят часы? Вы не одиноки. Я запустил Клуб для 1С разработчиков Alexcode.PRO. Внутри - продвинутые статьи, видео, материалы для скачивания, закрытый чат для резидентов и возможность влиять на контент.