К статье
Практический материал

Другое · 7 мин

Как получить тип реквизита в 1С 8: реквизиты, формы и метаданные

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

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

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

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

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

Однако результат TypeOf зависит от заполнения. Если реквизит не заполнен, функция может вернуть Неопределено, даже если в конфигурации поле объявлено как обязательное строго типизированное. Это основная причина ложных выводов при проверке типа по значению.

Как узнать объявленный тип реквизита конфигурации

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

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

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

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

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

Особенности форм и элементов управления

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

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

Привязка элемента управления к реквизиту не означает, что визуальный тип поля полностью определяет допустимые значения. Например, поле может отображаться как строка, а реквизит быть ссылкой со сложными правилами выбора.

Когда тип не определяется или возвращает Неопределено

Частая причина отсутствия типа — пустой или неинициализированный реквизит. В таком случае средства выполнения не могут судить о заявленном типе конфигурации, и только метаданные дадут достоверный ответ.

Ссылки на справочники и документы возвращают уточнённый тип, например ссылка на конкретный справочник, а не общий тип «Справочник». При сравнении типов нужно учитывать это различие, иначе проверка может не сработать для дочерних или связанных объектов.

Что проверяемИсточник информацииОсобенность
Тип текущего значенияВыполнение модуляЗависит от заполнения, пустое значение — Неопределено
Объявленный тип реквизитаМетаданные конфигурацииНе зависит от заполнения, показывает допустимый тип
Тип атрибута формыОписание формыМожет отличаться от типа реквизита объекта

Проверка результата и безопасные действия

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

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

Типичные ошибки
01
Проверять только текущее значение и принимать пустой реквизит за отсутствие типа
02
Путать тип строки табличной части с типом её реквизита
03
Применять клиентские способы доступа к метаданным в серверном контексте без проверки доступности

Если тип получен из метаданных, но значение в базе не соответствует этому типу из-за исторических данных, логика должна обрабатывать такое несоответствие. Автоматическое приведение типов может скрыть проблему вместо её устранения.

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

Ещё одна ошибка — считать, что один и тот же подход работает для всех объектов конфигурации. У справочников, документов, регистров и планов видов характеристик структура метаданных различается, и универсальная формула может не сработать.

Контрольные точки

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

Пустой реквизит
Норма

Метаданные возвращают объявленный тип

Тревожный признак

Выполнение возвращает Неопределено, логика не обрабатывает этот случай

Тип ссылки
Норма

Уточнённый тип ссылки на конкретный объект

Тревожный признак

Обобщённый тип используется там, где нужна конкретная ссылка

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

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

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

Итог

Что важно запомнить

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

Можно ли узнать тип реквизита только по его текущему значению?

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

Отличается ли тип реквизита табличной части от типа её строки?

Да. Табличная часть и реквизиты внутри её строк имеют отдельные описания в метаданных, и их не следует подменять друг другом.

Что делать, если TypeOf возвращает Неопределено?

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

Нужно ли тестировать изменения типов на копии базы?

Да. Изменение конфигурации и типов реквизитов может повлиять на хранение и логику, поэтому проверку проводят на копии перед работой с основной базой.