Как в 1С выбрать документы определенного типа — запросы и примеры

Выборка документов конкретного типа в 1С:Предприятие — одна из самых частых задач при работе с базой данных.hether вы разрабатываете отчет, настраиваете обмен данными или автоматизируете бизнес-процессы, умение корректно фильтровать документы по их видам сэкономит часы работы. В этой статье разберем все способы: от простых запросов с условием ТИПЗНАЧЕНИЯ() до сложных конструкций с объединением таблиц и динамическими параметрами.

Особенность 1С 8.3 (и актуальных версий 8.2) в том, что система хранит документы разных типов в одной таблице виртуальной базы данных — Документ. Без явной фильтрации вы получите все движения и записи, что не только замедляет выполнение запроса, но и усложняет дальнейшую обработку. Мы покажем, как избежать типичных ошибок, например, когда в выборку попадают не тех видов документы или когда запрос возвращает пустой результат из-за неверного указания метаданных.

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

1. Базовый синтаксис: как указать тип документа в запросе

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

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

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

ПриходнаяНакладная.ЭтоГруппа = ЛОЖЬ

Однако этот подход работает только если вы заранее знаете имя таблицы документа. Для универсальной выборки (например, когда виды документов определяются динамически) используйте конструкцию с ВЫБРАТЬ РАЗРЕШЕННЫЕ:

ВЫБРАТЬ Документ.Ссылка КАК Ссылка ИЗ Документ.Ссылка КАК Документ ГДЕ

ТИПЗНАЧЕНИЯ(Документ.Ссылка) = ТИП("ДокументСсылка.ПриходнаяНакладная")

📌 ТИПЗНАЧЕНИЯ() — возвращает тип значения, позволяет сравнивать с метаданными.
🔍 ЭтоГруппа = ЛОЖЬ — исключает группы документов из выборки.
⚡ ВЫБРАТЬ РАЗРЕШЕННЫЕ — используется для динамического получения списка видов.

2. Фильтрация по нескольким типам документов

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

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

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

)

Для большего количества типов (например, 5–10) лучше заранее сформировать массив типов в коде и передать его в запрос как параметр. Это упростит поддержку кода и уменьшит вероятность ошибок при редактировании.

💡

Если в запросе используете более 3–4 типов документов, вынесите их в отдельную коллекцию в коде и передавайте как параметр запроса. Это сделает запрос чище и облегчит его модификацию.

Способ фильтрации	Пример кода	Когда использовать
Один тип документа	`ТИПЗНАЧЕНИЯ(Ссылка) = ТИП("ДокументСсылка.ПриходнаяНакладная")`	Для простых выборок
Несколько типов (фиксированный список)	`ТИПЗНАЧЕНИЯ(Ссылка) В (ТИП("Тип1"), ТИП("Тип2"))`	Когда типы известны заранее
Динамический список типов	Передача массива типов как параметра запроса	Для гибких отчетов с настраиваемыми фильтрами

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

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

Пример запроса для выборки движений по регистру ТоварыНаСкладах только для документов ПриходнаяНакладная:

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

И ТИПЗНАЧЕНИЯ(ДвиженияПриходнаяНакладная.Регистратор.Ссылка) = ТИП("ДокументСсылка.ПриходнаяНакладная")

Обратите внимание на путь к ссылке документа: Регистратор.Ссылка. Это важно, так как виртуальные таблицы регистров содержат не сами документы, а ссылки на них через поле Регистратор.

⚠️ Внимание: При работе с виртуальными таблицами Обороты или Остатки фильтрация по типу документа может значительно замедлить выполнение запроса. Если возможна предварительная выборка документов нужного типа, используйте её как источник для соединения (СОЕДИНИТЬ).

4. Динамическое формирование списка типов документов

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

Пример кода на встроенном языке 1С:

// Формируем массив типов документов
ТипыДокументов = Новый Массив;
ТипыДокументов.Добавить(Тип("ДокументСсылка.ПриходнаяНакладная"));
ТипыДокументов.Добавить(Тип("ДокументСсылка.РасходнаяНакладная"));

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

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

☑️ Подготовка динамического запроса

Создать массив типов документовДобавить нужные типы в массивПередать массив как параметр запросаПроверить результат на пустоту

Выполнено: 0 / 4

5. Особенности фильтрации в управляемых формах и отчетах

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

Пример настройки отчета с выбором типов:

Добавьте на форму табличное поле и настройте его колонки:
- 📋 Колонка "ТипДокумента" (тип Строка) — для отображения имени.
- 🔘 Колонка "Выбран" (тип Булево) — флажок для выбора.

Заполните таблицу доступными типами документов при открытии формы:

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

При выполнении отчета сформируйте массив выбранных типов и передайте его в запрос.

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

Для Каждого Документ Из Метаданные.Документы Цикл Если Документ.Имя = "ПриходнаяНакладная" Тогда ТипыДокументов.Добавить(Тип("ДокументСсылка." + Документ.Имя)); КонецЕсли;

КонецЦикла;

⚠️ Внимание: При динамическом формировании списка типов документов учитывайте права пользователя. Если у него нет прав на просмотр определенного вида документа, запрос вернет ошибку. Используйте ПроверкаПравДоступа() перед добавлением типа в массив.

6. Оптимизация запросов: индексы и производительность

Фильтрация по типу документа может замедлять выполнение запроса, особенно если в базе миллионы записей. Для ускорения работы используйте следующие приемы:

🚀 Индексы: Убедитесь, что в конфигурации созданы индексы по полю Ссылка и её типу. В типовой 1С:ERP или 1С:УТ они обычно уже есть, но в самописных решениях может потребоваться доработка.
🔄 Предварительная выборка: Если нужно получить движения документов, сначала выберите сами документы нужного типа, а затем соедините их с виртуальными таблицами регистров.
📊 Ограничение периода: Всегда добавляйте фильтр по дате (Документ.Дата МЕЖДУ &НачалоПериода И &КонецПериода), даже если он не важен для логики отчета. Это сократит объем сканируемых данных.

Пример оптимизированного запроса с предварительной выборкой:

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

ПО Движения.Регистратор = Документы.Ссылка

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

💡

Использование временных таблиц (ПОМЕСТИТЬ ВТ) для предварительной выборки документов ускоряет выполнение сложных запросов в 2–5 раз.

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

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

❌ Неверное указание типа: Ошибка в имени типа (например, ТИП("ПриходнаяНакладная") вместо ТИП("ДокументСсылка.ПриходнаяНакладная")) приведет к пустому результату. Всегда проверяйте полное имя типа через Метаданные.
❌ Игнорирование групп: Забытый фильтр ЭтоГруппа = ЛОЖЬ может включить в выборку папки документов, что исказит данные.
❌ Избыточные соединения: Соединение с виртуальными таблицами без предварительной фильтрации документов замедляет запрос. Используйте временные таблицы.
❌ Права доступа: Запрос может упасть с ошибкой, если у пользователя нет прав на просмотр определенного вида документа. Проверяйте права заранее.

Для отладки запросов используйте ОбъяснитьЗапрос() — это поможет понять, почему выборка работает медленно или возвращает неожиданные данные:

Объяснение = Запрос.Объяснить();
Сообщить(Объяснение.Текст);

Как проверить, какие документы попали в выборку?

Если запрос возвращает неожиданные документы, добавьте в выборку поле ТИПЗНАЧЕНИЯ(Документ.Ссылка) КАК ТипДокумента и выведите результат в таблицу. Это поможет увидеть, какие типы реально отфильтровались.

⚠️ Внимание: В некоторых конфигурациях (например, 1С:Бухгалтерия 3.0) имена типов документов могут отличаться от отображаемых в интерфейсе. Например, в базе документ называется ПоступлениеТоваровУслуг, а в меню — "Приходная накладная". Всегда сверяйтесь с метаданными через Метаданные.Документы.

Частые вопросы (FAQ)

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

Используйте следующий код для вывода всех доступных типов документов:

Для Каждого Документ Из Метаданные.Документы Цикл
Сообщить(Документ.Имя);
КонецЦикла;

Или посмотрите имя в конфигураторе: откройте ветку Документы, найдите нужный документ и скопируйте его Имя из свойств.

Почему запрос возвращает пустой результат, хотя документы есть?

Возможные причины:

Ошибка в имени типа (проверьте через Метаданные).
Фильтр по дате слишком жесткий (расширьте период).
У пользователя нет прав на просмотр документа (проверьте роли).
Документы являются группами (добавьте ЭтоГруппа = ЛОЖЬ).

Можно ли фильтровать документы по типу в отчетах без программирования?

Да, в стандартных отчетах 1С (например, "Анализ субконто" или "Обороты между субконто") можно:

Открыть настройки отчета (кнопка "Показать настройки").
Перейти на закладку "Отбор".
Добавить отбор по полю "Вид документа" и выбрать нужные типы.

Однако для сложной логики (например, динамический список типов) потребуется доработка отчета в конфигураторе.

Как выбрать документы, у которых есть движения по конкретному регистру?

Используйте соединение с виртуальной таблицей регистра и проверку на НЕ ЗНАЧЕНИЕ(Движение.Регистратор) ЕСТЬ NULL:

ВЫБРАТЬ РАЗЛИЧНЫЕ Движения.Регистратор КАК СсылкаНаДокумент ИЗ РегистрНакопления.ТоварыНаСкладах.Обороты КАК Движения ГДЕ Движения.Регистратор.Ссылка.ЭтоГруппа = ЛОЖЬ

И ТИПЗНАЧЕНИЯ(Движения.Регистратор.Ссылка) = ТИП("ДокументСсылка.ПриходнаяНакладная")

Как фильтровать документы по типу в мобильной платформе 1С?

В мобильной платформе синтаксис запросов аналогичен десктопной версии, но есть ограничения:

Не все виртуальные таблицы поддерживаются.
Запросы с большим количеством соединений могут выполняться дольше.
Для фильтрации по типу используйте тот же ТИПЗНАЧЕНИЯ(), но тестируйте производительность на реальных данных.

Пример запроса для мобильного приложения:

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

Документ.Дата УБЫВ

Как в 1С выбрать документы определенного типа: запросы с примерами