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