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

Другое · 6 мин

Получение значения константы в запросе 1С

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

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

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

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

Когда значение константы нужно в запросе

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

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

Передача константы параметром запроса

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

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

Порядок действий через параметр
  1. 1
    Получить значение константы функцией на встроенном языке
  2. 2
    Создать запрос и добавить параметр с именем, например &Лимит
  3. 3
    Установить значение параметра перед выполнением запроса
  4. 4
    Выполнить запрос и проверить полученные данные

Пример сценария с параметром

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

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

Прямая ссылка на константу в языке запроса

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

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

Проверка результата и контрольные точки

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

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

Контрольные точки

Как проверить результат

Значение параметра перед выполнением
Норма

Константа имеет заполненное значение нужного типа

Тревожный признак

Пустое или неопределённое значение

Текст запроса с прямой ссылкой
Норма

Запрос компилируется и выполняется

Тревожный признак

Ошибка компиляции или неопознанное имя константы

Типичные ошибки и ограничения

Частая ошибка — попытка использовать константу как обычное поле таблицы в части SELECT или JOIN. Язык запросов не поддерживает такое обращение без параметра или специальной конструкции, что приводит к ошибке при выполнении.

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

Типичные ошибки
01
Использование константы как поля таблицы без параметра
02
Сравнение значений разных типов без приведения
03
Использование непустой константы без проверки на отсутствие значения

Альтернативы и безопасная работа

Если запрос становится сложным из-за нескольких констант, удобнее вынести их в отдельные параметры или использовать временную таблицу. Это упрощает отладку и снижает риск ошибки при изменении значения константы.

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

Итог

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

Константу в запросе 1С лучше передавать параметром через ЗначениеКонстанты; прямая ссылка возможна не везде, а результат всегда нужно проверять на пустоту и тип.

Можно ли использовать константу напрямую в любом запросе 1С?

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

Что делать, если константа пустая?

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

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

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

Можно ли соединять константу с таблицей через JOIN?

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

Как проверить, что запрос верно использует константу?

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