Другое · 7 мин
Как получить все реквизиты справочника 1С
Как получить все реквизиты справочника 1С: через Конфигуратор, программно и экспортом, с проверкой прав, ограничениями и типичными ошибками.
Реквизиты справочника в 1С — это поля метаданных, которые описывают элементы и группы справочника. Например, для справочника «Номенклатура» такими реквизитами могут быть статья затрат, единица измерения, страна происхождения или признак услуги. Получить полный список реквизитов нужно при настройке обмена данными, создании отчетов, проверке заполнения карточек и подготовке интеграции с другими системами.
Способ получения зависит от того, какая у вас задача: разово посмотреть состав полей в интерфейсе, выгрузить список для документации или получить реквизиты автоматически внутри обработки. Также важно учитывать режим приложения — обычное или управляемое — а также права текущего пользователя и состояние конфигурации.
Ниже рассмотрены основные пути получения реквизитов справочника, условия их применения и признаки, при которых самостоятельная работа может быть небезопасной. Все действия описываются без привязки к конкретному номеру релиза, так как порядок работы с метаданными может отличаться между версиями платформы.
Что считать реквизитами справочника и где они хранятся
Реквизиты относятся к метаданным конфигурации, а не к данным справочника. Это значит, что список полей задается при разработке или настройке конфигурации, а значения этих полей хранятся уже в самих элементах справочника. Чтобы получить названия и типы всех реквизитов, нужно обращаться к объекту метаданных, а не к таблице данных справочника.
В конфигурации реквизиты могут быть обычными, предопределенными, вычисляемыми или связанными с другими объектами. Некоторые из них видны в форме элемента, а некоторые скрыты от пользователя, но используются в программном коде или при обмене. Поэтому полный список из интерфейса пользователя может не совпадать с полным списком из метаданных.
Получить реквизиты через Конфигуратор
Откройте конфигурацию в режиме разработки, найдите нужный справочник в дереве метаданных и откройте его для редактирования. На вкладке «Реквизиты» отображается перечень полей с именами, синонимами, типами и длинами. Это самый простой способ разово ознакомиться со структурой справочника без написания кода.
Если конфигурация защищена или открыта только для чтения, вкладка реквизитов может быть недоступна для просмотра или изменений. В таких случаях список полей можно только изучить, но не редактировать, а получение метаданных программно может быть ограничено правами текущего сеанса.
Получить реквизиты программно на языке 1С
В коде 1С реквизиты справочника доступны через объект метаданных. Типичный алгоритм состоит из обращения к коллекции «Справочники», выбора нужного справочника по имени и перебора его коллекции «Реквизиты». На каждой итерации можно получить имя реквизита, его синоним, тип и другие свойства.
Такой подход подходит для внешних обработок, отчетов и команд, которые запускаются внутри информационной базы. Результат можно вывести в сообщение, таблицу значений или записать в документ. Важно учитывать, что код выполняется с правами текущего пользователя, поэтому отсутствие прав может привести к пустому результату или ошибке доступа.
- 1Откройте модуль внешней обработки или отчета.
- 2Обратитесь к метаданным справочника по его имени.
- 3Переберите коллекцию реквизитов этого справочника.
- 4Соберите имена, синонимы и типы в таблицу значений.
- 5Выведите таблицу на экран или в файл и проверьте полноту списка.
Вывести реквизиты в таблицу или отчет
Для документации или передачи коллегам удобно экспортировать список реквизитов в таблицу значений, электронную таблицу или печатную форму. Внешняя обработка может перебирать все справочники конфигурации или только выбранный, формировать строки с полями «Имя», «Синоним», «Тип», «Длина» и выводить их в удобном виде.
При экспорте проверяйте, попали ли в список все реквизиты, включая скрытые и служебные. Если в результате встречаются только поля формы, а не метаданные справочника, значит обработка обращается к неправильному объекту. Сравните количество строк в выгрузке с количеством реквизитов в Конфигураторе, если у вас есть доступ к обоим источникам.
Права доступа, блокировка конфигурации и ограничения
Получение реквизитов через метаданные требует прав на чтение конфигурации. В некоторых базах разработка разделена: обычные пользователи работают в закрытой конфигурации, а изменения вносятся только администраторами или через обновления. В таких условиях программное чтение списка реквизитов может быть ограничено или недоступно.
Не пытайтесь редактировать метаданные в рабочей базе без резервной копии и согласования. Изменение реквизита справочника может повлиять на формы, отчеты, обмен и уже введенные данные. Если вы не уверены в последствиях, ограничьтесь только чтением списка и консультацией с ответственным за конфигурацию специалистом.
Частые ошибки и способы проверки результата
Одна из типичных ошибок — попытка получить реквизиты через запрос к таблице данных справочника. Запрос вернет значения полей для конкретных элементов, но не даст имена и свойства всех реквизитов метаданных. Для списка полей нужен именно объект метаданных, а не данные.
Другая ошибка — игнорирование прав доступа. Код может выполняться без ошибок, но вернуть пустую коллекцию, если у пользователя нет прав на просмотр конфигурации. Также не путайте реквизиты справочника с реквизитами документа или регистра: у каждого объекта метаданных своя коллекция полей.
Как проверить результат
Совпадает с Конфигуратором или ожидаемым списком
Меньше ожидаемого или пустой результат
Список получен от имени пользователя с нужными правами
Пустой результат без ошибки при недостатке прав
Соответствуют метаданным справочника
Несоответствие или отсутствие полей
Как проверить, что список реквизитов получен полностью
Сравните количество полученных реквизитов с тем, что отображается в Конфигураторе, если такой доступ есть. Проверьте, что в списке есть не только часто используемые поля, но и служебные, вычисляемые и скрытые реквизиты. Убедитесь, что типы и синонимы соответствуют ожидаемым, а названия не обрезаны при экспорте.
Если список получен программно, запустите обработку от имени пользователя с разными правами и сравните результаты. Разница может указывать на ограничение доступа к метаданных. Для финальной проверки попробуйте использовать один из полученных реквизитов в отчете или форме и убедитесь, что система его распознает.
Что важно запомнить
Реквизиты справочника — это метаданные, доступные через Конфигуратор или объект метаданных в коде. Перед изменениями сделайте резервную копию и проверьте права доступа.
Можно ли получить реквизиты без Конфигуратора?
Да, программно через объект метаданных справочника, если у пользователя есть права на чтение конфигурации. Без доступа к метаданных список получить не получится.
Отличается ли список в форме от списка метаданных?
Может отличаться. Форма показывает только те поля, которые добавлены на неё, а метаданные содержат все реквизиты справочника, включая скрытые и служебные.
Что делать, если программный код вернул пустой список?
Проверьте права текущего пользователя, правильность имени справочника и состояние конфигурации. Возможно, конфигурация закрыта или доступ к метаданных ограничен.
Безопасно ли редактировать реквизиты в рабочей базе?
Только с резервной копией, согласованием и пониманием последствий для форм, отчетов и уже введенных данных. Без опыта лучше ограничиться чтением.