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

Другое · 6 мин

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

Как в 1С узнать тип реквизита справочника, документа или регистра: через конфигуратор, программно и в отчётах, с примерами и проверкой результата.

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

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

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

Где хранится тип реквизита и где его смотреть

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

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

Требуется тип поля в структуреСмотрите в конфигураторе

Откройте объект конфигурации и проверьте колонку «Тип» у реквизита.

Нужен тип значения в выполненииИспользуйте TypeOf

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

Требуется программное получениеОбращайтесь к метаданным

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

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

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

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

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

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

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

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

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

Особенности для разных типов объектов

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

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

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

Проверка результата и частые ошибки

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

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

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

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

Итог

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

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

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

Можно ли получить тип реквизита без конфигуратора?

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

Что делать, если тип реквизита не определяется?

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

Отличается ли тип в конфигураторе от типа в выполнении?

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

Нужно ли делать резервную копию перед просмотром типов?

Сам просмотр типов в конфигураторе или через чтение метаданных не меняет данные. Резервная копия необходима только перед любыми изменениями типов реквизитов или структуры конфигурации.