Что такое параметр в 1С и как с ним работать

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

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

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

Параметры отчётов на СКД: что видит пользователь

Самый частый контакт с параметрами происходит в отчётах, построенных на системе компоновки данных (СКД). Когда вы открываете отчёт «Продажи» или «Остатки товаров» и видите поля «Начало периода», «Конец периода», «Организация» — это и есть параметры. Они подставляются в запрос отчёта и ограничивают выбираемые данные.

Параметры СКД делятся на видимые пользователю и служебные. Видимые отображаются на панели настроек и доступны для изменения. Служебные (например, автоматически создаваемые «Период» для виртуальных таблиц) заполняются платформой или разработчиком. Если параметр обязательный и не заполнен, отчёт либо не сформируется, либо выдаст предупреждение — это зависит от настроек, заданных разработчиком.

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

Параметры запросов: как безопасно фильтровать данные

В языке запросов 1С параметр обозначается символом «&» перед именем: &НачалоПериода, &Склад, &СписокНоменклатуры. Значение присваивается через объект запроса перед выполнением. Такой подход предпочтительнее конкатенации строк: платформа сама корректно обрабатывает типы данных, даты и специальные символы, а разработчик защищён от ошибок преобразования.

Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Номенклатура, КоличествоОстаток
|ИЗ РегистрНакопления.ТоварыНаСкладах.Остатки(&Период, Склад = &Склад) КАК Остатки";
Запрос.УстановитьПараметр("Период", КонецДня(ТекущаяДатаСеанса()));
Запрос.УстановитьПараметр("Склад", Склад);
Результат = Запрос.Выполнить().Выгрузить();

Особый случай — передача списка значений. Если в условии нужно проверить вхождение в перечень, параметру присваивают массив или список значений, а в тексте запроса используют оператор В (&Список). Платформа автоматически разворачивает коллекцию в набор значений. Передавать список строкой через запятую нельзя — запрос воспримет её как одно строковое значение, и условие не сработает.

Если параметр объявлен в тексте запроса, но значение ему не присвоено, при выполнении возникнет ошибка. Поэтому в коде принято устанавливать все параметры явно, даже если значение пустое: пустая дата, пустая ссылка или пустой массив — корректные значения, а отсутствие установки — ошибка.

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

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

Параметрам можно назначать значения по умолчанию: Процедура СформироватьОтчет(Период, ВключатьНДС = Истина). Такой параметр можно не указывать при вызове — подставится значение по умолчанию. Важное ограничение: параметры со значениями по умолчанию должны идти в конце списка, иначе вызов станет неоднозначным.

Параметры форм и сеанса

Управляемая форма может принимать параметры при открытии: например, форма элемента справочника получает ключ записи, форма выбора — настройку отбора или режим множественного выбора. Параметры объявляются в редакторе формы на закладке «Параметры», там же задаётся, является ли параметр ключевым. Ключевые параметры участвуют в уникальности формы: повторный вызов с теми же ключевыми параметрами активирует уже открытую форму, а не создаёт новую.

Параметры сеанса — это глобальные значения, доступные на протяжении всего сеанса работы пользователя: текущая организация, текущий пользователь, признак использования разделения данных. Они задаются в модуле сеанса при старте и затем читаются из любого серверного кода. Типичное применение — ограничение доступа к данным на уровне записей (RLS), где параметр сеанса подставляется в шаблон ограничения.

Как задать и проверить параметр на практике

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

1. 1
   Откройте отчёт и нажмите «Настройки» (или «Ещё → Изменить вариант» в типовых конфигурациях)
2. 2
   На закладке «Параметры» найдите нужный параметр и заполните значение: дату, организацию, склад
3. 3
   Убедитесь, что флажок использования параметра установлен — незадействованный параметр игнорируется
4. 4
   Сформируйте отчёт и проверьте, что данные соответствуют заданным ограничениям
5. 5
   Если настройка нужна постоянно, сохраните вариант отчёта под понятным именем

Признак корректно заданного параметра — отчёт формируется быстро и содержит только ожидаемые данные. Тревожные признаки: пустой отчёт при заведомо существующих данных (обычно неверный период или лишний отбор), очень долгое формирование (не задан период), ошибка «Параметр не установлен» (обязательный параметр оставлен пустым).

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

Начинающие разработчики часто путают параметры СКД и параметры запроса внутри компоновки. В СКД параметр запроса автоматически становится параметром компоновки, но его имя и тип можно переопределить на закладке «Компоновка данных». Если тип задан неверно (например, строка вместо ссылки), пользователь не сможет выбрать значение из справочника — поле примет любой текст, и отбор не сработает.

Ещё одна типичная проблема — даты в параметрах. Конец периода следует задавать как конец дня (КонецДня()) или использовать границу, иначе документы, проведённые в течение последнего дня, выпадут из выборки. В пользовательских настройках типовых отчётов эта проблема обычно решена стандартным периодом, но в собственных доработках её легко упустить.

FAQ: частые вопросы о параметрах в 1С