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

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

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

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

Как посмотреть тип реквизита в конфигураторе

Самый быстрый способ узнать тип реквизита — открыть объект метаданных в конфигураторе. Найдите нужный справочник, документ или регистр в дереве конфигурации, раскройте ветку «Реквизиты» и выделите интересующий реквизит. В палитре свойств (открывается по правой кнопке мыши — «Свойства» или сочетанием Alt+Enter) первое же поле «Тип» покажет назначенный тип данных.

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

Для стандартных реквизитов (Ссылка, Код, Наименование, Дата, Номер) тип задаётся на уровне объекта целиком, а не отдельного реквизита. Например, тип кода справочника меняется в свойствах самого справочника на вкладке «Данные».

Определение типа значения в коде: ТипЗнч() и Тип()

Во встроенном языке тип конкретного значения определяется парой функций. Функция ТипЗнч(Значение) возвращает тип переданного значения, а функция Тип("ИмяТипа") создаёт объект типа по его строковому имени. Сравнение результата ТипЗнч с нужным типом — стандартный приём проверки:

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

Для примитивных типов используются имена «Строка», «Число», «Дата», «Булево». Для ссылочных типов имя строится по шаблону: вид объекта, точка, имя объекта метаданных — например, «ДокументСсылка.РеализацияТоваровУслуг» или «ПеречислениеСсылка.СтавкиНДС».

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

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

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

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

Метод Типы() возвращает массив всех типов, входящих в описание. Если массив содержит один элемент — реквизит простой, если несколько — составной. Дополнительно у ОписанияТипов доступны квалификаторы: КвалификаторыЧисла (длина и точность), КвалификаторыСтроки (длина, фиксированная или переменная), КвалификаторыДаты (состав даты: только дата, только время или дата и время).

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

ОписаниеТипа = Объект.Метаданные().Реквизиты.Найти("Плательщик").Тип;
Если ОписаниеТипа.СодержитТип(ТипЗнч(НовоеЗначение)) Тогда
    Объект.Плательщик = НовоеЗначение;
Иначе
    Сообщить("Тип значения не соответствует реквизиту");
КонецЕсли;

Проверка составных реквизитов и значения Неопределено

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

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

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

Определение типа в запросе и через СхемуЗапроса

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

Для приведения составного реквизита к одному типу в запросе применяют ВЫРАЗИТЬ(Поле КАК Справочник.Контрагенты). Значения несовместимых типов превратятся в NULL, что нужно учитывать при соединениях. Через объект СхемаЗапроса типы полей можно анализировать программно при динамическом построении запросов, хотя на практике чаще достаточно метаданных.

Практический сценарий: универсальная функция проверки

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

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

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

Как проверить результат и избежать ошибок

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

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

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