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

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

Главная сложность в том, что реквизит в 1С может иметь составной тип — например, реквизит «Контрагент» часто допускает ссылки на несколько справочников сразу. Поэтому корректная проверка должна учитывать не один тип, а список допустимых. Ниже разобраны рабочие способы с примерами кода и типичными ошибками.

Проверка типа функциями ТипЗначения() и Тип()

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

Типичный пример проверки реквизита документа:

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

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

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

Как узнать тип реквизита через метаданные

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

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

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

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

Тот же подход работает для табличных частей: сначала получают метаданные табличной части через МетаДок.ТабличныеЧасти.Найти("Товары"), затем обращаются к её коллекции реквизитов. Для стандартных реквизитов (Ссылка, Номер, Дата, Проведен) типы фиксированы платформой и отдельно в коллекции СтандартныеРеквизиты.

1. 1
   Получите объект метаданных: Метаданные.Документы.ИмяДокумента (или Справочники, ПланыСчетов и т.д.)
2. 2
   Найдите реквизит: коллекция Реквизиты.Найти("ИмяРеквизита") — не забудьте проверить результат на Неопределено
3. 3
   Обратитесь к свойству Тип — это объект ОписаниеТипов
4. 4
   Переберите массив Типы() для списка допустимых типов или прочитайте квалификаторы для примитивных типов

Проверка типа в конфигураторе без программирования

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

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

Дополнительно полезно окно «Дополнительно» в свойствах реквизита — там указывается, проверяется ли заполнение и как ведёт себя значение при обмене. Если тип реквизита недавно меняли, стоит проверить историю хранилища конфигурации, чтобы понять, какие данные могли остаться в старом формате.

Определение типа в режиме предприятия: отладчик и консоль запросов

В режиме отладки тип значения виден в табло: достаточно вычислить выражение ТипЗначения(Объект.Реквизит) или просто навести курсор на переменную — платформа покажет и значение, и его тип. Это удобно, когда нужно понять, что фактически попало в реквизит в конкретном документе.

Через консоль запросов тип значения в запросе определяется функцией языка запросов ТИПЗНАЧЕНИЯ():

ВЫБРАТЬ
ТИПЗНАЧЕНИЯ(РеализацияТоваровУслуг.Контрагент) КАК ТипКонтрагента
ИЗ
Документ.РеализацияТоваровУслуг КАК РеализацияТоваровУслуг

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

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

Проверка значения на допустимость перед записью

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

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

Учтите, что СодержитТип() проверяет только тип, но не квалификаторы: строка длиннее допустимой пройдёт проверку, но при записи будет усечена или вызовет ошибку в зависимости от контекста. Для строк и чисел дополнительно сверяйте длину и разрядность через квалификаторы описания типов.

Ещё один полезный приём — метод ПривестиЗначение(Значение) у «ОписаниеТипов». Он приводит значение к описанному типу: несовместимые значения заменяются на значение по умолчанию (пустая ссылка, 0, пустая строка). Это удобно при загрузке данных из внешних источников, когда тип входного значения заранее неизвестен.

Сравнение способов: что выбрать в разных ситуациях

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

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

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