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