Как определить тип объекта в 1С

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

Платформа 1С:Предприятие предоставляет несколько встроенных механизмов для определения типа: функции ТипЗначения() и ТипЗнч(), объект ОписаниеТипов, а также работу через метаданные объекта. Каждый способ имеет свою область применения, ограничения и подводные камни.

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

Какие способы определения типа существуют в 1С

Встроенный язык предлагает три основных подхода. Первый — функции ТипЗначения() и ТипЗнч(), которые возвращают объект типа «Тип», описывающий тип переданного значения. Второй — объект ОписаниеТипов, который хранит состав типов для реквизита, колонки или параметра. Третий — анализ метаданных прикладного объекта через метод Метаданные().

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

Определение типа через ТипЗначения и ТипЗнч

Функция ТипЗнч(Значение) — основной рабочий инструмент. Она принимает любое значение и возвращает объект типа Тип. Устаревший вариант ТипЗначения() работает аналогично и встречается в старом коде; в новых разработках принято использовать ТипЗнч().

Типичный сценарий — сравнение типа переменной с конкретным типом. Эталонный тип получают функцией Тип(), куда строкой передают имя типа в том виде, в каком оно фигурирует в синтакс-помощнике:

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

Для примитивных типов имена простые: «Число», «Строка», «Дата», «Булево», «Неопределено», «Null». Для прикладных объектов имя строится по шаблону: семейство, вид объекта и имя из конфигуратора, например «СправочникОбъект.Номенклатура» или «РегистрСведенийЗапись.КурсыВалют».

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

Проверка типа через ОписаниеТипов

Объект ОписаниеТипов описывает допустимые типы реквизита, колонки таблицы значений или параметра. Он нужен, когда тип не один, а составной: например, реквизит «Контрагент» может хранить ссылки на разные справочники.

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

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

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

Определение типа прикладного объекта через метаданные

Когда нужно узнать, какой именно документ или справочник передан в переменной, удобнее метаданные. У ссылок и объектов есть метод Метаданные(), возвращающий объект описания конфигурации. У него доступны свойства Имя, ПолноеИмя(), Представление() и родительский объект.

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

Проверить принадлежность к семейству объектов помогает метод Метаданные.НайтиПоТипу() и сравнение родителя. Например, чтобы понять, что значение — любой документ, а не конкретный, используют проверку через Метаданные.Документы.Содержит(Мета) или анализ полного имени.

Мета = Значение.Метаданные();
Если Метаданные.Документы.Содержит(Мета) Тогда
// это документ любого вида
ИначеЕсли Метаданные.Справочники.Содержит(Мета) Тогда
// это справочник
КонецЕсли;

Практические сценарии и примеры кода

Универсальная проверка «ссылка или объект»

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

Определение типа в запросе

В языке запросов тип определяют функцией ТИПЗНАЧЕНИЯ(Поле), а сравнение выполняют с литералом ТИП(Справочник.Номенклатура). Это работает и в условиях ГДЕ, и в ВЫБОР:

ВЫБОР
КОГДА ТИПЗНАЧЕНИЯ(Таб.Контрагент) = ТИП(Справочник.Контрагенты)
ТОГДА "Контрагент"
ИНАЧЕ "Прочее"
КОНЕЦ

Определение типа на клиенте

ТипЗнч() и Тип() доступны и в клиентском контексте, но обращение к Метаданные() на тонком клиенте ограничено. Если логика требует метаданных (например, ПолноеИмя объекта), выполняйте её на сервере, а на клиент передавайте готовую строку.

Функция ЭтоДокумент(Значение)
    Если Не ЗначениеЗаполнено(Значение) Тогда
        Возврат Ложь;
    КонецЕсли;
    Мета = Значение.Метаданные();
    Возврат Метаданные.Документы.Содержит(Мета);
КонецФункции

Типичные ошибки при определении типа

Самая частая ошибка — сравнение типа со строкой вместо объекта Тип: конструкция ТипЗнч(Х) = "Строка" всегда ложна, потому что слева объект Тип, а справа строка. Правильно: ТипЗнч(Х) = Тип("Строка").

Вторая ошибка — попытка вызвать Метаданные() у примитивного значения (числа, строки, Неопределено). У примитивов этого метода нет, и код упадёт с ошибкой. Перед вызовом проверяйте, что значение — прикладной объект, например через Справочники.ТипВсеСсылки().СодержитТип(ТипЗнч(Значение)) или обработку исключения.

Третья проблема — использование строкового представления типа (функция Строка(ТипЗнч(...))) для сравнений. Представление может отличаться локализацией и не гарантирует стабильности; сравнивайте именно объекты Тип.

Как проверить корректность определения типа

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

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

Ограничения и безопасные границы

Определение типа — безопасная операция: она не меняет данные и не требует прав на запись. Однако действия, которые обычно следуют за ней (ПолучитьОбъект(), запись, удаление), уже требуют аккуратности. Перед массовой обработкой объектов по определённому типу делайте резервную копию или тестируйте логику на копии базы.

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

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