Другое · 6 мин
Как задать параметр в 1С
Практическая инструкция по заданию параметров в 1С: запросы, отчёты, обработки и процедуры. Способы передачи значений, проверка результата и типичные ошибки.
Параметр в 1С — это именованное значение, которое передаётся в процедуру, функцию, запрос, отчёт или обработку и используется для фильтрации данных, расчёта или управления поведением программы. Способ задания зависит от того, где именно нужен параметр: в тексте запроса, на форме документа, в модуле отчёта или при вызове общей процедуры.
Перед заданием параметра нужно определить его тип, место хранения и способ передачи. Неправильно заданный параметр может привести к пустому результату запроса, ошибке «Поле не найдено» или выполнению расчёта по неверным данным.
В материале разобраны основные способы задания параметров в 1С:Предприятии, порядок проверки результата и типичные ошибки, которых стоит избегать при самостоятельной настройке.
Что такое параметр в 1С и где он применяется
В 1С параметры встречаются в нескольких формах. Это параметры процедур и функций, параметры запросов к базе данных, реквизиты форм отчётов и обработок, а также значения, передаваемые через команды интерфейса. Каждый вид имеет свои правила задания и область действия.
Параметр процедуры существует только во время выполнения этой процедуры. Параметр запроса подставляется в текст запроса перед выполнением и позволяет менять условия отбора без перекомпиляции запроса. Реквизит формы отчёта хранит значение на время работы отчёта и может отображаться пользователю.
Задать параметр в запросе
В языке запросов 1С параметры объявляются в разделе ПАРАМЕТРЫ и подставляются в условия отбора. Чтобы задать значение, в коде модуля обращаются к коллекции Параметры объекта запроса и вызывают метод Вставить, указывая имя параметра и значение.
Пример типичного кода: запрос получает параметр даты или номера документа, после чего выполняется и возвращает выборку. Если параметр не вставлен, а в тексте запроса он используется, выполнение завершится ошибкой.
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Документ.Ссылка ИЗ Документ.РеализацияТоваровИУслуг ГДЕ Документ.Дата = &Дата";
Запрос.Параметры.Вставить("Дата", ТекущаяДата());
Результат = Запрос.Выполнить();Параметр отчёта или обработки
В отчёте или обработке параметр обычно оформляется как реквизит формы. Значение задаётся при открытии формы, через команду интерфейса или программно в обработчике события ПриОткрытии. Пользователь может видеть поле параметра на форме и менять его перед запуском.
Программное задание параметра отчёта выполняется перед формированием результата. Важно убедиться, что тип значения реквизита совпадает с типом, ожидаемым в модуле отчёта, иначе расчёт может отработать некорректно.
Параметр процедуры или функции
При вызове процедуры или функции значение параметра передаётся в скобках после имени процедуры. Внутри модуля параметр доступен под своим именем и может использоваться в расчётах, условиях и передаче дальше по цепочке вызовов.
Параметры могут передаваться по значению или по ссылке в зависимости от типа данных и контекста вызова. Изменение параметра внутри процедуры не всегда влияет на исходную переменную, поэтому нужно учитывать способ передачи при отладке.
Как проверить, что параметр задан корректно
Проверка результата начинается с выполнения запроса или отчёта с заданным параметром и сравнения полученной выборки с ожидаемой. Если параметр задан верно, данные отфильтрованы по нужному условию, а ошибок при выполнении нет.
Признаком проблемы служит пустой результат при ожидаемых данных, ошибка компиляции запроса или подстановка значения по умолчанию вместо заданного. В таких случаях проверяют имя параметра, его тип и момент присвоения значения.
Как проверить результат
Данные отфильтрованы по заданному условию
Пустой выборка или ошибка выполнения
Соответствует ожидаемому типу и содержит заданное значение
Значение по умолчанию или неопределённо
Совпадает с объявлением в запросе или процедуре
Опечатка в имени, параметр не найден
Частые ошибки и ограничения
Среди типичных ошибок — опечатка в имени параметра, отсутствие вызова метода Вставить для параметра запроса, несоответствие типов значений и попытка использовать параметр вне области его видимости. Каждая из них приводит к ошибке выполнения или неверному результату.
Ограничение связано с тем, что параметр процедуры не сохраняется после завершения вызова, а параметр запроса действует только для одного выполнения запроса. Для постоянного хранения значения используют реквизиты объекта, настройки или регистры сведений.
При самостоятельной настройке стоит ограничиться изменением значений параметров в существующих обработках и отчётах. Правка модулей запросов и общих процедур требует осторожности, так как ошибка может затрагивать другие части конфигурации.
Если после изменения параметра данные начинают отображаться некорректно в нескольких разделах программы, лучше откатить изменения и проверить их на копии базы.
Альтернативы и когда обращаться к специалисту
Если задать параметр через интерфейс не получается, можно использовать обработку выгрузки-загрузки данных или программное изменение реквизита через модуль. Выбор способа зависит от того, нужно ли сохранить значение на постоянной основе или только для одного запуска.
Обращаться к специалисту по 1С стоит при изменении типовых модулей, настройке параметров интеграции или если после задания параметра данные в базе начинают отображаться некорректно. Самостоятельная правка конфигурации без резервной копии не рекомендуется.
Что важно запомнить
Параметр задаётся в зависимости от контекста: запрос, форма отчёта или вызов процедуры. После задания обязательно проверяют результат, тип значения и область действия параметра.
Нужно ли объявлять параметр в тексте запроса перед использованием?
Да, в языке запросов 1С параметр должен быть объявлен в разделе ПАРАМЕТРЫ, а затем значение задаётся программно через коллекцию Параметры. Иначе выполнение запроса завершится ошибкой.
Может ли параметр процедуры сохранить значение после завершения вызова?
Нет, параметр процедуры существует только во время выполнения этой процедуры. Для хранения значения после завершения используют реквизит объекта, настройку или регистр сведений.
Что делать, если отчёт с параметром возвращает пустой результат?
Нужно проверить, что значение параметра действительно присвоено перед формированием отчёта, совпадает ли тип значения с ожидаемым и корректно ли составлено условие отбора в модуле отчёта.
Безопасно ли Independently править модули запросов для задания параметра?
Самостоятельная правка типовых модулей не рекомендуется без резервной копии базы, так как ошибка может затрагивать другие части конфигурации. Безопаснее менять значения параметров в существующих обработках или обращаться к специалисту.