Как проверить тип данных в 1С

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

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

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

Функция ТипЗнч — базовый способ определения типа

Функция ТипЗнч(Значение) возвращает объект типа «Тип», описывающий тип переданного значения. Это основной инструмент, когда нужно узнать, что именно лежит в переменной в момент выполнения кода.

Значение = 42;
ТипЗначения = ТипЗнч(Значение); // вернёт тип "Число"

Если ТипЗнч(Значение) = Тип("Число") Тогда
Сообщить("Это число");
КонецЕсли;

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

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

Сравнение с типом по имени и проверка ссылочных типов

Для ссылочных типов (справочники, документы, перечисления) проверка выполняется тем же сравнением, но имя типа строится по шаблону: СправочникСсылка.Номенклатура, ДокументСсылка.РеализацияТоваровУслуг, ПеречислениеСсылка.СтавкиНДС.

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

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

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

Для определения, является ли значение ссылкой вообще (без привязки к конкретному виду), применяется проверка через XMLТипЗнч(Значение) или анализ свойства Метаданные() в попытке — у примитивных типов такого метода нет.

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

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

ОписаниеТиповРеквизита = Метаданные.Документы.РеализацияТоваровУслуг
.Реквизиты.Контрагент.Тип;

Если ОписаниеТиповРеквизита.СодержитТип(Тип("СправочникСсылка.Контрагенты")) Тогда
// реквизит может хранить контрагента
КонецЕсли;

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

Проверка типа в запросах

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

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

Для приведения составного поля к конкретному типу в запросе используется ВЫРАЗИТЬ(Поле КАК Документ.РеализацияТоваровУслуг). Это позволяет обратиться к реквизитам конкретного вида документа через точку — без выражения такая попытка вызовет ошибку построения запроса.

Определение типа в отладчике без изменения кода

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

1. 1
   Поставьте точку останова на нужной строке и запустите отладку (F5)
2. 2
   Выделите переменную и нажмите Shift+F9 — откроется окно «Вычислить выражение»
3. 3
   В поле «Выражение» введите ТипЗнч(ИмяПеременной) — в колонке «Значение» появится тип
4. 4
   В колонке «Тип» того же окна тип отображается и без вызова функции — достаточно вычислить саму переменную
5. 5
   Для глубокого анализа откройте значение двойным щелчком и изучите структуру объекта

В табло (Ctrl+Alt+W) и в окне «Вычислить выражение» у каждого значения есть колонка «Тип», где платформа показывает имя типа: Число, Строка, СправочникСсылка.Номенклатура и так далее. Это самый быстрый способ понять, что пришло в процедуру извне.

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

Проверка примитивных типов и особые значения

Примитивные типы — Число, Строка, Дата, Булево — проверяются стандартным сравнением. Но в 1С есть особые значения, которые требуют отдельной обработки: Неопределено и NULL.

Если Значение = Неопределено Тогда
// параметр не передан
ИначеЕсли Значение = NULL Тогда
// пустое значение из запроса
ИначеЕсли НЕ ЗначениеЗаполнено(Значение) Тогда
// пустая ссылка, пустая строка, ноль, пустая дата
КонецЕсли;

Частая ошибка — сравнивать с Неопределено значение, полученное из запроса. Запрос возвращает NULL для отсутствующих соединений, и сравнение NULL = Неопределено даёт Ложь. В результате проверка «на пустоту» молча не срабатывает, и дальше код падает при обращении к реквизитам.

Сравнение способов и выбор подходящего

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

Для прикладного кода в типовых конфигурациях предпочтительнее функции БСП: они устойчивы к переименованию объектов и единообразны. В независимых разработках достаточно связки ТипЗнч() и Тип() с аккуратной обработкой несуществующих имён.

Частые вопросы о проверке типов в 1С