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