Проверка типа документа в запросе 1С: методы, примеры и нюансы

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

В этой статье разберём три основных способа проверки типа документа прямо в тексте запроса: через функцию ТИПЗНАЧЕНИЕ(), конструкцию ВЫРАЗИТЬ, а также с использованием виртуальных таблиц. Плюс рассмотрим типичные ошибки, которые допускают даже опытные программисты, и дадим рекомендации по оптимизации таких запросов. Все примеры приведены для актуальных версий платформы 1С:Предприятие 8.3 (включая последние релизы).

Если вы часто работаете с документами разных видов (например, ЗаказПокупателя, РеализацияТоваровУслуг, ПоступлениеТоваров), эта инструкция поможет сделать ваши запросы надёжнее и гибче. А в конце статьи — FAQ с ответами на частые вопросы по теме.

1. Проверка типа документа через функцию ТИПЗНАЧЕНИЕ()

Функция ТИПЗНАЧЕНИЕ() — самый прямой способ определить тип объекта в запросе. Она возвращает строку с полным именем типа, например, "ДокументСсылка.ЗаказПокупателя". Это удобно, когда нужно явное сравнение или фильтрация по нескольким типам.

Основной синтаксис:

ВЫБРАТЬ
ТИПЗНАЧЕНИЕ(Документ.Ссылка) КАК ТипДокумента
ИЗ
Документ.ЗаказПокупателя КАК Документ

Пример с фильтрацией:

ВЫБРАТЬ
Документ.Номер,
Документ.Дата
ИЗ
Документ КАК Документ
ГДЕ
ТИПЗНАЧЕНИЕ(Документ.Ссылка) = "ДокументСсылка.ЗаказПокупателя"

• ✅ Плюсы: простой и понятный синтаксис, работает во всех версиях платформы.
• ⚠️ Минусы: возвращает строку, что может быть неудобно для сложных условий (например, проверки на принадлежность к группе типов).
• 🔍 Нюанс: если документ удалён, функция вернёт "НеопределённоеЗначение" — это нужно учитывать в логике.

ГДЕ ТИПЗНАЧЕНИЕ(Документ.Ссылка) В ("ДокументСсылка.ЗаказПокупателя", "ДокументСсылка.РеализацияТоваровУслуг")

2. Использование конструкции ВЫРАЗИТЬ для приведения типов

Конструкция ВЫРАЗИТЬ позволяет не только проверить тип, но и привести ссылку к нужному типу прямо в запросе. Это полезно, когда вы заранее знаете возможные типы документов и хотите избежать ошибок несоответствия.

Пример приведения к типу ДокументСсылка.ЗаказПокупателя:

ВЫБРАТЬ
ВЫРАЗИТЬ(Документ.Ссылка КАК ДокументСсылка.ЗаказПокупателя) КАК СсылкаНаЗаказ
ИЗ
Документ КАК Документ
ГДЕ
НЕ Документ.ПометкаУдаления

Если приведение невозможно (например, документ другого типа), результат будет NULL. Это можно использовать для фильтрации:

ВЫБРАТЬ
Документ.Номер
ИЗ
Документ КАК Документ
ГДЕ
ВЫРАЗИТЬ(Документ.Ссылка КАК ДокументСсылка.ЗаказПокупателя) ЕСТЬ NULL

Важно: конструкция ВЫРАЗИТЬ работает только с совместимыми типами. Например, нельзя привести ДокументСсылка.ПоступлениеТоваров к ДокументСсылка.ЗаказПокупателя, даже если они логически связаны.

3. Работа с виртуальными таблицами документов

Виртуальные таблицы (например, Документ.ЗаказПокупателя.Список) уже содержат данные конкретного типа, поэтому проверка типа в них избыточна. Однако если вы работаете с объединённой виртуальной таблицей (например, Документ.ВсеДокументы), проверка становится необходимой.

Пример запроса к виртуальной таблице с фильтрацией по типу:

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

Обратите внимание: при работе с регистрами накопления/сведений тип документа-регистратора можно получить через поле Регистратор, но его тоже придётся проверять на соответствие нужному типу.

4. Проверка типа в динамических запросах

Если запрос формируется динамически (например, в коде на 1С), проверка типа документа может усложняться из-за необходимости экранирования строк и учёта контекста. В таких случаях удобно использовать параметры запроса.

Пример с параметром:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|    Документ.Ссылка КАК Ссылка
|ИЗ
|    Документ КАК Документ
|ГДЕ
|    ТИПЗНАЧЕНИЕ(Документ.Ссылка) = &ТипДокумента";

Запрос.УстановитьПараметр("ТипДокумента", "ДокументСсылка.ЗаказПокупателя");
Результат = Запрос.Выполнить();

Для проверки нескольких типов можно передать массив:

ТипыДокументов = Новый Массив;
ТипыДокументов.Добавить("ДокументСсылка.ЗаказПокупателя");
ТипыДокументов.Добавить("ДокументСсылка.РеализацияТоваровУслуг");

Запрос.УстановитьПараметр("СписокТипов", ТипыДокументов);
Запрос.Текст =
"ВЫБРАТЬ
|    Документ.Ссылка
|ИЗ
|    Документ КАК Документ
|ГДЕ
|    ТИПЗНАЧЕНИЕ(Документ.Ссылка) В (&СписокТипов)";

Правильно ли экранированы кавычки в строке типа документа?|Передан ли параметр с корректным именем?|Учтена ли возможность NULL для удалённых документов?|Проверены ли права доступа к документам данного типа?-->

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

5. Типичные ошибки и как их избежать

Даже опытные разработчики иногда допускают ошибки при проверке типов документов. Вот самые распространённые:

• 🚫 Ошибка 1: Сравнение с неполным именем типа.

  Неправильно: ТИПЗНАЧЕНИЕ(Документ.Ссылка) = "ЗаказПокупателя"
  

  Правильно: ТИПЗНАЧЕНИЕ(Документ.Ссылка) = "ДокументСсылка.ЗаказПокупателя"

• 🚫 Ошибка 2: Игнорирование удалённых документов.

  Если документ помечен на удаление, ТИПЗНАЧЕНИЕ() вернёт NULL. Всегда добавляйте условие ГДЕ НЕ Документ.ПометкаУдаления.

• 🚫 Ошибка 3: Попытка привести несовместимые типы через ВЫРАЗИТЬ.

  Например, ВЫРАЗИТЬ(Документ.Ссылка КАК ДокументСсылка.СчётНаОплату) для документа ЗаказПокупателя всегда вернёт NULL.

• 🚫 Ошибка 4: Забывают про подтипы документов.

  Если у документа есть подтипы (например, ЗаказПокупателя.Оптовый и ЗаказПокупателя.Розничный), проверка на базовый тип ("ДокументСсылка.ЗаказПокупателя") сработает для всех подтипов.

⚠️ Внимание: В некоторых конфигурациях (например, 1С:ERP или 1С:УТ 11) имена типов документов могут отличаться от стандартных из-за использования подсистем или расширений. Перед написанием запроса проверьте реальные имена типов через Мetadata() или Справочник.ТипыДокументов.

6. Оптимизация запросов с проверкой типа

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

• ⚡ Используйте виртуальные таблицы для конкретных типов документов, если не нужна универсальная выборка.
• ⚡ Перенесите проверку типа в код после выполнения запроса, если это возможно (например, через ТипЗнч() в 1С).
• ⚡ Индексируйте поля, по которым идёт фильтрация (например, Дата или Номер), чтобы ускорить выборку перед проверкой типа.
• ⚡ Избегайте ВЫРАЗИТЬ в циклах — если нужно привести много ссылок, сделайте это одним запросом.

Пример оптимизированного запроса:

// Сначала отбираем документы по дате (индексированное поле)
ВЫБРАТЬ РАЗЛИЧНЫЕ
Документ.Ссылка КАК Ссылка
ИЗ
Документ КАК Документ
ГДЕ
Документ.Дата МЕЖДУ &НачалоПериода И &КонецПериода
И НЕ Документ.ПометкаУдаления

// Затем в коде проверяем типы:
Для Каждого Ссылка Из РезультатЗапроса Цикл
Если ТипЗнч(Ссылка) = Тип("ДокументСсылка.ЗаказПокупателя") Тогда
// Обработка заказов
КонецЕсли;
КонецЦикла;

Такой подход разгружает сервер 1С, так как тяжелая операция проверки типа выполняется на клиенте, а не в запросе.

7. Альтернативные подходы: когда проверка типа не нужна

Иногда задачу можно решить без явной проверки типа документа. Рассмотрим альтернативы:

• 🔄 Использование объединений (ОБЪЕДИНИТЬ):

  Если вам нужны данные из нескольких типов документов, можно сделать отдельные запросы к каждому типу и объединить результаты.

  ВЫБРАТЬ
  Номер, Дата, "ЗаказПокупателя" КАК ТипДокумента
  ИЗ
  Документ.ЗаказПокупателя
  
  ОБЪЕДИНИТЬ ВСЕ
  
  ВЫБРАТЬ
  Номер, Дата, "РеализацияТоваровУслуг" КАК ТипДокумента
  ИЗ
  Документ.РеализацияТоваровУслуг

• 🔄 Работа через регистры:

  Если документы записывают движения в регистры, можно анализировать данные регистров, где тип документа-регистратора уже известен.

• 🔄 Поля-признаки:

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

Эти методы часто быстрее и надёжнее, особенно если логика работы с документами заранее известна.

⚠️ Внимание: В конфигурациях с большим количеством типов документов (например, 1С:ERP или 1С:КА 2) объединение запросов по каждому типу может привести к избыточной нагрузке. В таких случаях лучше использовать виртуальную таблицу Документ.ВсеДокументы с фильтрацией по типу.

FAQ: Частые вопросы по проверке типа документа в 1С

ГДЕ ТИПЗНАЧЕНИЕ(Документ.Ссылка) ПОДОБНО "ДокументСсылка.ЗаказПокупателя%"

Если СтрНачинаетсяС(ТипЗнч(Ссылка), "ДокументСсылка.ЗаказПокупателя") Тогда
// Это подтип заказа
КонецЕсли;

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

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

Если ТипЗнч(Документ) = Тип("ДокументСсылка.ЗаказПокупателя") Тогда
// Действия
КонецЕсли;