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

Другое · 7 мин

Сравнение типа значения в запросе 1С

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

В языке запросов 1С тип значения обычно определяют функцией TYPEOF. Она применяется к полю, ссылке или параметру и возвращает строковое представление типа, которое можно использовать в условии ГДЕ. Это позволяет отбирать только записи определенного справочника, документа или другого объекта, не загружая лишние данные в отчет или обработку.

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

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

Что возвращает TYPEOF в запросе

Функция TYPEOF применяется к значению из таблицы, ссылке или реквизиту и возвращает строку с именем типа. Например, для ссылки на элемент справочника результатом может быть строка вида «Справочник.Номенклатура», а для документа — «Документ.РеализацияТоваровИУслуг». Точный вид зависит от конфигурации и версии платформы.

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

1c
ВЫБРАТЬ
 Товар.Ссылка КАК Товар
ИЗ
 Справочник.Номенклатура КАК Товар
ГДЕ
 TYPEOF(Товар.Ссылка) = "Справочник.Номенклатура"

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

Как составить условие сравнения типа

Базовый вид условия выглядит так: TYPEOF(Поле) = "Ожидаемый тип". В тексте запроса строки обычно заключаются в кавычки, а имя типа пишется точно, с учетом точки и регистра, принятого в конфигурации. Если тип не совпадает, строка не попадает в выборку.

Если нужно отобрать несколько типов, используйте логическое ИЛИ: TYPEOF(Поле) = "ТипА" ИЛИ TYPEOF(Поле) = "ТипБ". Для большого количества типов условие становится громоздким, в таких случаях удобнее разделить запрос на части или использовать объединение выборок через ОБЪЕДИНИТЬ ВСЕ, если это допускается логикой отчета.

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

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

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

Количество строк после фильтра
Норма

Соответствует ожидаемому набору объектов

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

Ноль строк или лишние объекты других типов

Имя типа в условии
Норма

Совпадает с данными консоли запросов

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

Отличается регистром, точкой или именем справочника

Работа на копии базы
Норма

Отчет выполняется без ошибок

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

Изменение данных или сбой расчета

Сравнение параметра и поля запроса

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

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

Типичные ошибки
01
Сравнение TYPEOF с объектом типа вместо строкового имени — условие никогда не сработает.
02
Опечатка в имени типа, например отсутствие точки или неверный регистр — отбор возвращает пустую выборку.
03
Использование TYPEOF в тяжелых циклах без оценки производительности — замедление отчетов и обменов.

Ограничения и проверка результата

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

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

Сравнение вариантов

TYPEOF в условии ГДЕ

Подходит для отбора по известному строковому имени типа в одном запросе.

Разделение на несколько запросов или объединение

Удобно при большом количестве типов, но увеличивает объем кода.

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

Подходит для сложной логики, но требует загрузки лишних данных.

Частые ошибки

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

Альтернативы и выбор подхода

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

Безопасная самостоятельная работа

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

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

Итог

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

TYPEOF возвращает строку типа, сравнивайте её с точным именем типа, тестируйте на копии и избегайте жестких изменений в критических расчетах.

Можно ли сравнивать TYPEOF напрямую с типом из встроенного языка?

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

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

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

Подходит ли TYPEOF для отбора по многим типам сразу?

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

Нужно ли резервировать базу перед правкой запроса?

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