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

Другое · 7 мин

Параметры в 1С: виды, передача и настройка

Что такое параметры в 1С: параметры процедур, отчётов, обработок и сеанса, как передавать значения, проверять результат и избегать ошибок.

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

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

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

Что понимают под параметрами в 1С

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

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

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

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

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

Передача по значению и по ссылке

В 1С параметры могут передаваться по значению или по ссылке в зависимости от типа данных и способа вызова. При передаче по значению изменения внутри процедуры не влияют на исходную переменную, а при передаче по ссылке возможны изменения исходных данных. Это критично при работе со справочниками, документами и табличными частями.

Параметры отчётов и обработок

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

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

Параметры сеанса и регистров сведений

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

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

Порядок работы с параметрами
  1. 1
    Определите, где нужен параметр: в процедуре, отчёте, форме или сеансе.
  2. 2
    Опишите параметр с именем, типом и значением по умолчанию.
  3. 3
    Передайте значение при вызове и проверьте его наличие внутри кода.
  4. 4
    Проверьте результат на тестовых данных перед вводом в эксплуатацию.

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

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

Перед использованием параметра внутри кода проверьте, что он не равен неопределённому значению, особенно для ссылочных типов. Для отчётов и обработок убедитесь, что параметр формы заполнен перед формированием запроса. Результат проверяйте на тестовых данных с известным исходом, а не на рабочей базе без резервной копии.

Проверка результата

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

Ограничения и частые ошибки

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

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

Типичные ошибки
01
Путать параметры формы отчёта с параметрами процедуры — это разные механизмы.
02
Использовать неинициализированный параметр в условии или расчёте.
03
Передавать ссылку на изменяемый объект без понимания последствий для исходных данных.

Альтернативы параметрам

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

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

Итог

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

Параметры настраивают поведение 1С без правки кода, но требуют чёткого типа, инициализации и проверки перед использованием.

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

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

Нужно ли указывать тип параметра?

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

Может ли параметр быть необязательным?

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

Что делать, если отчёт не видит параметр?

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