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

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

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

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

Использование объектов метаданных для анализа структуры

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

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

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

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

Получение реквизитов через систему компоновки данных (СКД)

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

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

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

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

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

Анализ полей результата выполнения запроса

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

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

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

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

Метод получения	Источник данных	Включает системные поля	Сложность реализации
Объекты метаданных	Конфигурация	Нет (только явные)	Низкая
Система компоновки данных	Схема отчета	Зависит от настроек	Средняя
Результат запроса	Выполненный запрос	Да (включая псевдонимы)	Низкая
Обработка события	Форма документа	Да (все доступные)	Высокая

Динамическое получение свойств объекта в форме

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

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

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

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

⚠️ Внимание: При использовании метода Свойства() на клиенте список может быть неполным из-за ограничений безопасности платформы. Некоторые системные свойства могут быть скрыты от клиентского кода, поэтому критический анализ структуры лучше выполнять на стороне сервера.

Работа с табличными частями и вложенными структурами

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

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

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

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

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

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

Системные реквизиты и скрытые поля

Помимо реквизитов, созданных разработчиком, каждый документ в 1С обладает набором системных полей, которые управляются платформой. К ним относятся Ссылка, Дата, Номер, Проведен, ПометкаУдаления и другие. Эти поля существуют всегда, даже если они не видны в списке реквизитов конфигурации.

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

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

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

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

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

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

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

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

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

Почему метод Свойства() возвращает лишние поля?

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

Как узнать тип данных конкретного реквизита программно?

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

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