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

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

В платформе есть несколько рабочих механизмов: функция ТипЗнч(), сравнение через Тип(), метод Метаданные(), а также проверки на уровне запросов с помощью оператора ССЫЛКА. Выбор способа зависит от контекста: сервер или клиент, тонкий клиент или толстый, встроенный язык или текст запроса.

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

Что такое тип документа и чем он отличается от вида

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

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

Проверка через ТипЗнч и Тип

Классический и самый распространённый вариант — сравнение результата ТипЗнч() с типом, полученным через Тип(). Строковое имя типа строится по шаблону «ДокументСсылка.» плюс имя документа в конфигураторе.

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

Такой подход работает и на сервере, и на клиенте, в том числе в тонком и веб-клиенте, потому что не требует обращения к метаданным. Это делает его предпочтительным в общих модулях с признаками «Клиент» и «Сервер» одновременно.

Обратная задача — определить, что значение вообще является документом, а не справочником. Для этого тип приводят к строке и ищут подстроку «Документ», либо проверяют через менеджеры: Документы.ТипВсеСсылки().СодержитТип(ТипЗнч(Значение)).

Если Документы.ТипВсеСсылки().СодержитТип(ТипЗнч(Значение)) Тогда
    Сообщить("Это ссылка на документ");
КонецЕсли;

Получение вида документа через Метаданные()

Когда нужно не сравнить тип с эталоном, а узнать имя вида документа — например, для записи в журнал или формирования представления — используют метод Метаданные() у ссылки. Он возвращает объект описания метаданных, у которого доступны свойства Имя и Синоним.

ИмяВида = ДокументСсылка.Метаданные().Имя;        // "РеализацияТоваровУслуг"
ПредставлениеВида = ДокументСсылка.Метаданные().Синоним; // "Реализация товаров и услуг"

У этого способа есть ограничение: обращение к метаданным выполняется на сервере. В контексте тонкого клиента вызов Метаданные() у ссылки недоступен и вызовет ошибку. Если код должен работать на клиенте, либо переносите логику в серверную процедуру, либо используйте сравнение через ТипЗнч().

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

В языке запросов тип проверяется оператором ССЫЛКА. Это удобно, когда нужно отобрать записи, где составный реквизит содержит документы только определённого вида, например найти все задачи, основанием которых служит заказ покупателя.

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

Для получения типа как значения в выборке применяют функцию ТИПЗНАЧЕНИЯ(), а для приведения составного поля к конкретному типу — ВЫРАЗИТЬ(... КАК Документ.ИмяДокумента). После приведения становятся доступны реквизиты конкретного документа через точку.

Учтите, что ВЫРАЗИТЬ не фильтрует записи, а лишь приводит тип: строки с другими видами документов останутся в выборке с пустыми значениями приведённых полей. Для отбора комбинируйте приведение с условием ССЫЛКА.

Проверка типа в подписках и обработчиках событий

Подписки на события ПриЗаписи и ОбработкаПроведения часто назначают сразу на несколько видов документов. Внутри обработчика источник — это объект, поэтому сравнивать нужно с типом ДокументОбъект, а не ДокументСсылка. Это самая частая ошибка при написании подписок.

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

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

Проверка типа на форме и в условном оформлении

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

В условном оформлении динамического списка тип сравнивают через условие «Равно» с полем, вычисленным как ТИПЗНАЧЕНИЯ(Поле) в запросе, либо добавляют в запрос служебное булево поле по условию ССЫЛКА и оформляют уже по нему. Второй вариант проще в поддержке.

1. 1
   В точке останова выведите ТипЗнч(ПроверяемоеЗначение) в табло и убедитесь, какой тип фактически приходит
2. 2
   Сравните фактический тип с ожидаемым: ссылка это или объект
3. 3
   Проверьте строковое имя типа в функции Тип() на опечатки, сверив его с именем документа в конфигураторе
4. 4
   Убедитесь, что код выполняется в нужном контексте: сервер или клиент
5. 5
   Прогоните сценарий на документе целевого вида и на документе другого вида — условие должно срабатывать только в первом случае

Выбор способа проверки под задачу

Для однозначного выбора ориентируйтесь на контекст выполнения и цель проверки. Сравнение через ТипЗнч() универсально и работает везде, но требует точного строкового имени. Метод Метаданные() удобен для получения имени вида, но только на сервере. Оператор ССЫЛКА — единственный вариант внутри запроса.

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

Частые вопросы