1С: как получить список реквизитов справочника

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

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

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

Работа с объектом Метаданные

Основным инструментом для получения информации о структуре конфигурации является объект Метаданные. Глобальный контекст платформы предоставляет доступ к этому объекту, который содержит полное описание всех элементов конфигурации. Чтобы получить доступ к конкретному справочнику, необходимо обратиться к коллекции справочников через свойство Справочники.

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

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

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

⚠️ Внимание: Свойство Реквизиты возвращает только пользовательские поля. Системные реквизиты, такие как Код, Наименование, Родитель или Владелец, в эту коллекцию не входят и требуют отдельного обращения.

Получение пользовательских реквизитов

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

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

В данном примере переменная Реквизит в каждой итерации цикла содержит объект описания поля. Вы можете обращаться к различным свойствам этого объекта. Например, свойство Имя содержит идентификатор поля, используемый в коде, а свойство Синоним — понятное пользователю название, которое отображается в интерфейсе.

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

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

Обработка системных реквизитов справочника

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

К основным системным полям справочника относятся: Ссылка, Код, Наименование, Родитель, Владелец, Группа, ЭтоГруппа. Для некоторых справочников, например, «Номенклатура», могут присутствовать специфические системные поля, такие как Артикул или ЕдиницаИзмерения, если они предусмотрены базовой конфигурацией.

Чтобы получить полный список всех доступных полей, включая системные, разработчики часто формируют массив вручную, добавляя к пользовательским реквизитам известные системные имена. Альтернативный подход — использование запроса к системной таблице InformationSchema.Fields, но это работает только в некоторых режимах и требует прав администратора.

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

⚠️ Внимание: Имена системных реквизитов могут отличаться в зависимости от вида объекта. Например, у документа есть реквизиты Дата и Номер, которых нет у справочника. Не пытайтесь получить реквизит Дата у справочника через метаданные — его там просто не существует.

Анализ типов данных и составных полей

Платформа 1С:Предприятие поддерживает мощную систему типов. Реквизит может быть простого типа (Число, Строка, Дата) или ссылочного типа (СправочникСсылка, ДокументСсылка). Кроме того, широко используются составные типы, позволяющие хранить в одном поле значения разной природы.

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

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

Свойство	Тип значения	Описание
Имя	Строка	Идентификатор реквизита в коде
Синоним	Строка	Представление реквизита для пользователя
Тип	ОписаниеТипов	Информация о допустимых типах данных
Длина	Число	Максимальная длина для строковых типов
Точность	Число	Количество знаков после запятой для числовых типов

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

Особенности работы с типом ХранилищеЗначения

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

Реквизиты табличных частей справочника

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

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

МетаданныеСправочника = Метаданные.Справочники.Комплектация;
ТЧ = МетаданныеСправочника.ТабличныеЧасти.Товары;
Для каждого Реквизит Из ТЧ.Реквизиты Цикл
// Обработка реквизита табличной части
КонецЦикла;

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

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

Оптимизация и производительность при работе с метаданными

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

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

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

⚠️ Внимание: Интерфейс и набор доступных свойств метаданных могут незначительно меняться при обновлении платформы 1С. Всегда тестируйте код на актуальной версии платформы, используемой у заказчика.

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

Часто задаваемые вопросы (FAQ)

Как получить список всех справочников в конфигурации?

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

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

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

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

Необходимо анализировать объект, из которого получены метаданные. Объект Метаданные.Справочники.Имя вернет структуру справочника, а Метаданные.РегистрыСведений.Имя — структуру регистра. У них разные наборы системных полей.

Где хранится информация о длине строкового реквизита?

Информация о длине хранится в свойстве Длина объекта описания реквизита. Для типов, не имеющих длины (например, Число или Дата), это свойство может быть не определено или равно 0.

Доступны ли метаданные в внешних обработках?

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