Как в запросе 1С указать тип документа

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

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

В этой статье мы подробно разберем все доступные способы указания типа документа в конструкции ГДЕ. Мы рассмотрим нюансы работы с перечислениями, покажем, как избежать распространенных ошибок при написании кода, и обсудим, какие подходы считаются лучшими практиками в современной разработке под 1С. Понимание этих механизмов позволит вам писать более надежный и быстрый код.

Использование констант типов в условии WHERE

Самый прямой и понятный способ отфильтровать записи по типу — это использование встроенных констант типов. В языке запросов 1С для каждого типа данных существует специальное ключевое слово, которое начинается с символа &. Когда вы пишете &ТипДокумента.РеализацияТоваровУслуг, вы явно сообщаете интерпретатору, что поле ВидДвижения или Ссылка должно соответствовать именно этому метаданному.

Этот метод является наиболее предпочтительным с точки зрения производительности. Платформа 1С:Предприятие на этапе компиляции запроса точно знает, какой внутренний идентификатор типа нужно подставить в SQL-запрос к базе данных. Это позволяет серверу СУБД (например, MS SQL или PostgreSQL) максимально эффективно использовать индексы по полям типов. Вам не нужно беспокоиться о преобразовании строк или чисел вручную.

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

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

ВЫБРАТЬ
РегистрНакопления.Продажи.Период КАК Период,
РегистрНакопления.Продажи.Сумма КАК Сумма
ИЗ
РегистрНакопления.Продажи КАК РегистрНакопления
ГДЕ
РегистрНакопления.ВидДвижения = &ВидДвиженияРегистраНакопления.Приход
И РегистрНакопления.Период МЕЖДУ &НачалоМесяца И &КонецМесяца

Здесь мы видим явное указание вида движения через константу &ВидДвиженияРегистраНакопления.Приход. Это гарантирует, что в выборку попадут только приходные записи, игнорируя расходные. Такой подход делает код самодокументируемым: любой разработчик сразу понимает логику отбора без необходимости изучать справочники внутренних идентификаторов.

Работа с перечислениями и их псевдонимами

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

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

В чем разница между Типом и Перечислением?

Тип метаданных (например, &Документ.ЗаказКлиента) — это неизменяемая структура объекта в базе. Перечисление (например, Перечисление.СтатусыЗаказов) — это набор записей в справочнике, которые можно добавлять или удалять. При фильтрации по полю "ВидДокумента" чаще используется Тип, а при фильтрации по полю "Статус" — Перечисление.

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

• 🔍 Прямое обращение: Используйте полный путь Перечисление.Имя.Значение для максимальной ясности кода.
• ⚡ Производительность: Сравнение со значением перечисления работает так же быстро, как и с константой типа, так как оба значения преобразуются в идентификаторы на этапе подготовки запроса.
• 🔄 Гибкость: Значения перечислений можно передавать в запрос через параметры, что делает код универсальным для разных сценариев использования.

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

ВЫБРАТЬ
Документ.ЗаказПокупателя.Ссылка КАК Заказ,
Документ.ЗаказПокупателя.Дата КАК ДатаЗаказа
ИЗ
Документ.ЗаказПокупателя КАК Документ
ГДЕ
Документ.Статус = Перечисление.СтатусыЗаказов.Подтвержден

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

Динамическая фильтрация через параметры запроса

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

Решением является передача значения типа в качестве параметра запроса. В коде встроенного языка вы создаете объект типа ОписаниеТипов или просто присваиваете переменной значение типа, а затем передаете эту переменную в объект Запрос. В тексте самого запроса вы ссылаетесь на этот параметр через символ &.

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

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

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

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

Здесь переменная ВидДвижения в запросе заменяется на значение, переданное методом УстановитьПараметр. Платформа автоматически преобразует переданный тип во внутренний формат, понятный серверу баз данных. Это позволяет гибко управлять логикой отбора без изменения текста SQL-подобного запроса.

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

Вопрос производительности при фильтрации по типу документа является одним из самых обсуждаемых среди разработчиков 1С. Многие ошибочно полагают, что использование функций преобразования, таких как ЕСТЬNULL или приведение типов в тексте запроса, может замедлить работу. На самом деле, современные версии платформы 1С:Предприятие 8.3 обладают мощным оптимизатором запросов.

Тем не менее, существуют нюансы. Прямое сравнение поля с константой типа (Поле = &Тип.Значение) всегда является самым быстрым вариантом. Оно позволяет СУБД использовать индекс по полю типа без каких-либо дополнительных вычислений. Использование функций в условии ГДЕ, даже встроенных в язык 1С, может в некоторых редких случаях препятствовать использованию индекса, если оптимизатор не сможет «заглянуть» внутрь функции.

Метод фильтрации	Читаемость кода	Производительность	Гибкость
Константа типа (&Тип)	Высокая	Максимальная	Низкая (статично)
Параметр запроса	Средняя	Высокая	Высокая
Значение перечисления	Высокая	Высокая	Средняя
Функции преобразования	Низкая	Средняя/Низкая	Высокая

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

Обработка составных типов и неопределенных значений

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

Если вы фильтруете таблицу со составным типом, указание конкретного типа документа в условии ГДЕ автоматически сужает выборку до записей соответствующего типа. Записи других типов будут просто отброшены. Однако, если в поле возможно значение NULL (Неопределено), стандартное сравнение может вести себя неочевидно для новичков.

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

• 🛡️ Безопасность типов: При работе с составными типами всегда проверяйте, что сравниваемые значения совместимы, чтобы избежать ошибок выполнения.
• 🚫 Игнорирование NULL: Помните, что в SQL и запросах 1С выражение NULL = NULL возвращает Ложь. Используйте оператор ЕСТЬNULL для явной проверки на пустоту.
• 📝 Логирование: При отладке сложных запросов с составными типами выводите типы полученных значений в журнал регистрации, чтобы понять, какие данные приходят из базы.

Особое внимание стоит уделить ситуациям, когда в запросе используется соединение (ЛЕВОЕ СОЕДИНЕНИЕ) таблиц с разными типами ключей. В таких случаях условие на тип документа лучше размещать в секции ГДЕ основного запроса, а не в условии соединения, чтобы не исказить результат объединения таблиц.

Частые ошибки и лучшие практики

Даже опытные разработчики иногда допускают ошибки при указании типов в запросах. Одна из самых распространенных проблем — попытка сравнить поле типа с строковым литералом, например, ВидДвижения = "Приход". Это грубая ошибка, которая приведет к тому, что запрос вернет пустой результат, так как в базе хранится уникальный идентификатор (UUID), а не текстовое название.

Еще одна ошибка — использование функций преобразования типов прямо в условии выборки без необходимости. Например, конструкция ТипЗнч(Ссылка) = Тип("ДокументСсылка.Реализация") работает, но она менее производительна и менее читаема, чем использование константы &Документ.Реализация. Старайтесь писать код так, чтобы он был понятен другому разработчику с первого взгляда.

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

Соблюдение лучших практик не только ускоряет работу программы, но и облегчает ее сопровождение. Используйте именование параметров, которое отражает их суть. Вместо &П1 пишите &НужныйТипДокумента. Это кажется мелочью, но при поддержке большого проекта экономит часы времени на понимание логики кода.

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

Можно ли использовать номер типа вместо имени?

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

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

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

Влияет ли указание типа на блокировку записей?

Само по себе указание типа в условии WHERE не устанавливает блокировки. Блокировки зависят от режима транзакции и используемых методов объекта запроса (например, метод Выбрать с параметром блокировки). Однако точная фильтрация по типу помогает СУБД быстрее найти нужные строки, сокращая время удержания ресурсов.

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

Используйте логический оператор ИЛИ в условии WHERE. Например: ГДЕ ВидДвижения = &Тип1 ИЛИ ВидДвижения = &Тип2. Также можно использовать оператор В (IN), если передаете список типов, но синтаксически проще и понятнее цепочка ИЛИ для небольшого количества типов.

Почему запрос не использует индекс при фильтрации по типу?

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