Получение вида документа в запросе 1С

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

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

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

Прямое получение вида через псевдополе Ссылка

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

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

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

Пример простейшего запроса выглядит следующим образом:

ВЫБРАТЬ
ДокументРеализацияТоваровУслуг.Ссылка КАК Ссылка,
ДокументРеализацияТоваровУслуг.Вид КАК ВидДокумента
ИЗ
Документ.РеализацияТоваровУслуг КАК ДокументРеализацияТоваровУслуг

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

Использование таблицы значений ВидыДокументов

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

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

Важно понимать разницу между этой таблицей и конкретными таблицами документов. Первая хранит описания типов, вторые — экземпляры данных. Для связи их между собой в запросе используется поле Ссылка из таблицы видов, которое соответствует типу данных в основных таблицах.

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

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

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

Соединение с регистром сведений для аналитики

В сложных конфигурациях, таких как 1С:ERP или УТ 11, часто встречается практика хранения дополнительных атрибутов вида документа в регистрах сведений. Это делается для того, чтобы не засорять основную таблицу документов редко используемыми полями.

Если вам необходимо получить не просто техническое имя вида, а, например, "Группу документов" или "Тип операции", заданный пользователем, простого псевдополя будет недостаточно. В этом случае требуется выполнить соединение (JOIN) таблицы документов с соответствующим регистром сведений.

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

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

Пример запроса с соединением:

ВЫБРАТЬ
Док.Ссылка,
ДопСвойства.ГруппаДокументов
ИЗ
Документ.ЗаказКлиента КАК Док
ЛЕВОЕ СОЕДИНЕНИЕ РегистрСведений.ДополнительныеСвойстваВидовДокументов КАК ДопСвойства
ПО ДопСвойства.ВидДокумента = Док.Вид

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

Работа с составными типами и универсальные запросы

Часто возникает задача сформировать единый список из разных видов документов, например, "Заказ клиента" и "Заказ поставщика". В этом случае тип поля Ссылка становится составным. Получение вида документа в таком запросе имеет свои особенности.

При использовании оператора ВЫБРАТЬ ... ИЗ ... ОБЪЕДИНИТЬ ВСЕ система автоматически приводит типы к общему знаменателю. Поле Вид в результирующей выборке будет доступно и будет содержать корректное значение для каждой строки, независимо от исходной таблицы.

Однако фильтрация по виду в составном запросе требует осторожности. Условие ГДЕ Вид = &ВидЗаказа может работать неэффективно, если оптимизатор запросов не сможет отсечь лишние таблицы на этапе генерации SQL. Рекомендуется явно указывать тип в условии или использовать таблицу Документы.ВсеВиды для фильтрации.

Почему составные типы замедляют запрос?

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

Для оптимизации таких выборок используйте временные таблицы с четкой типизацией полей.

Таблица сравнения методов получения вида

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

Метод	Производительность	Гибкость	Сложность реализации
Псевдополе Вид	Высокая	Низкая (только имя вида)	Минимальная
Таблица ВсеВиды	Средняя	Высокая (доступ ко всем свойствам)	Средняя
Регистр сведений	Зависит от индексов	Максимальная (пользовательские данные)	Высокая
Программный цикл	Низкая	Любая	Низкая (но плохо для объема)

Как видно из таблицы, для большинства стандартных задач достаточно использования псевдополя. Более сложные сценарии требуют привлечения дополнительных объектов метаданных.

Оптимизация и типичные ошибки

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

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

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

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

Используйте встроенные средства анализа запросов для проверки эффективности вашего кода перед выгрузкой на продуктивный сервер.

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

Можно ли получить вид документа, если ссылка равна Неопределено?

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

В чем разница между ВидДокумента и ПланВидовХарактеристик?

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

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

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

Работает ли получение вида в запросах к историческим данным (RLS)?

Да, механизм получения вида документа работает корректно даже при включенном RLS (Record Level Security), так как вид документа является частью ключа и структуры записи, доступ к которой регулируется правами доступа. Однако убедитесь, что у пользователя есть права на чтение метаданных.