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

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

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

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

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

Самый наглядный способ — открыть структуру объекта в конфигураторе. Найдите нужный объект (справочник, документ, регистр) в дереве конфигурации, раскройте ветку «Реквизиты» и дважды щёлкните по нужному реквизиту. В палитре свойств поле «Тип» покажет заданный тип: например, «Строка(150)», «Число(15,2)», «СправочникСсылка.Номенклатура».

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

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

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

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

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

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

Через метаданные также доступны квалификаторы: КвалификаторыСтроки.Длина, КвалификаторыЧисла.Разрядность и РазрядностьДробнойЧасти, КвалификаторыДаты.ЧастиДаты. Они нужны при программном создании объектов или проверке совместимости полей.

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

Как узнать тип конкретного значения: ТипЗнч и Тип

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

Функция Тип("ИмяТипа") создаёт объект типа по имени, что позволяет сравнивать: ТипЗнч(Значение) = Тип("СправочникСсылка.Контрагенты"). Такое сравнение — стандартный приём при разборе составных полей и реквизитов с типом «Характеристика».

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

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

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

ВЫБРАТЬ
ХозрасчетныйОбороты.Субконто1 КАК Субконто
ГДЕ
ТИПЗНАЧЕНИЯ(ХозрасчетныйОбороты.Субконто1) = ТИП(Справочник.Номенклатура)

Обратная задача — привести поле к нужному типу — решается оператором ВЫРАЗИТЬ(Поле КАК Справочник.Номенклатура). Приведение обязательно, когда по составному полю строится соединение: без ВЫРАЗИТЬ запрос может вернуть NULL или работать заметно медленнее из-за соединения по всем таблицам составного типа.

Проверить результат удобно в консоли запросов: выполните выборку с ТИПЗНАЧЕНИЯ по нескольким записям и убедитесь, что типы соответствуют ожиданиям, прежде чем переносить текст запроса в код.

1. 1
   Откройте реквизит в конфигураторе и выпишите все типы, входящие в составной тип
2. 2
   В консоли запросов выберите несколько записей с функцией ТИПЗНАЧЕНИЯ по этому полю
3. 3
   Определите, какие типы реально встречаются в данных
4. 4
   В коде добавьте ветвление через ТипЗнч для каждого значимого типа
5. 5
   Проверьте обработку на записи с пустым значением реквизита

Особые случаи: характеристики, определяемые типы и планы видов характеристик

В типовых конфигурациях часто встречаются определяемые типы — например, «ВладелецДополнительныхСвойств». Это не конкретный тип, а именованный составной тип, объявленный в ветке «Определяемые типы» дерева конфигурации. Чтобы узнать фактический состав, откройте соответствующий определяемый тип и посмотрите его свойство «Тип».

Реквизиты с типом «Характеристика.<Имя плана видов характеристик>» хранят значение, допустимое для конкретной строки плана видов характеристик. Фактический тип значения определяется свойством «ТипЗначения» самой характеристики, поэтому анализировать его нужно в два шага: сначала получить характеристику, затем тип её значения.

У ресурсов и измерений регистров тип смотрится так же, как у реквизитов, — через ветки «Измерения», «Ресурсы», «Реквизиты» соответствующего регистра. У табличных частей реквизиты находятся внутри ветки конкретной табличной части, что часто упускают при поиске.

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

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

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

Третья типичная ситуация — пустые значения. ТипЗнч(Неопределено) вернёт тип «Неопределено», а пустая ссылка имеет полноценный ссылочный тип. Логика, не учитывающая пустые значения, даёт сбои на незаполненных реквизитах.

FAQ