Разработка и Конфигурация · 11 мин
Как получить структуру конфигурации 1С
Способы получить структуру конфигурации 1С: конфигуратор, выгрузка в файлы, отчёт по метаданным, обработки и программный перебор объектов. Пошаговые инструкции.
Структура конфигурации 1С — это перечень всех объектов метаданных: справочников, документов, регистров, отчётов, обработок, ролей, подсистем и других элементов, из которых состоит прикладное решение. Получить такую структуру требуется при знакомстве с новой базой, перед рефакторингом, для документирования доработок, аудита прав или подготовки к сравнению с типовой поставкой.
Существует несколько рабочих способов: визуальный просмотр дерева метаданных в конфигураторе, выгрузка конфигурации в файлы, встроенный отчёт по структуре, программный перебор метаданных через объект «Метаданные» и сторонние инструменты вроде EDT. Каждый вариант решает свою задачу: где-то нужна быстрая наглядность, где-то — машиночитаемый список для дальнейшей обработки.
Выбор способа зависит от цели. Для разового осмотра достаточно конфигуратора, для документации удобнее отчёт или выгрузка в файлы, а для автоматического анализа — программный обход метаданных. Ниже разобраны все подходы с точными действиями и ограничениями.
Просмотр структуры в конфигураторе через дерево метаданных
Основной и самый доступный способ — окно конфигурации в конфигураторе. Откройте базу в режиме «Конфигуратор», затем в меню выберите «Конфигурация → Открыть конфигурацию». Слева появится дерево, где объекты сгруппированы по видам: общие модули, справочники, документы, регистры сведений, регистры накопления, отчёты и так далее.
Раскрытие узла показывает вложенные сущности: у справочника — реквизиты, табличные части, формы, макеты; у документа — движения по регистрам. Двойной клик по объекту открывает палитру свойств, где видны все настройки: длина кода, иерархичность, периодичность регистра, индексы.
Если конфигурация находится на поддержке, часть объектов может быть заблокирована для изменения — в дереве они помечены соответствующими пиктограммами. Это не мешает просмотру структуры, но ограничивает редактирование. Для поиска конкретного объекта в большом дереве используйте поиск по подстроке (Ctrl+F в окне конфигурации или глобальный поиск по метаданным).
У этого способа есть ограничение: дерево наглядно, но не даёт готового текстового списка. Скопировать структуру целиком в документ напрямую из дерева нельзя — для этого нужны другие способы, описанные ниже.
Выгрузка конфигурации в файлы для анализа структуры
Выгрузка в файлы превращает всю конфигурацию в набор XML-файлов, где каждый объект метаданных описан отдельно. Это удобно для поиска по структуре, сравнения версий и хранения слепка конфигурации в системе контроля версий.
Порядок действий: в конфигураторе откройте «Конфигурация → Выгрузить конфигурацию в файлы». Укажите каталог назначения и выберите режим — иерархический (объекты раскладываются по папкам по видам метаданных) или плоский. Для анализа структуры удобнее иерархический формат: папки соответствуют видам объектов.
После выгрузки в корневом файле Configuration.xml содержится перечень всех объектов конфигурации. Файлы можно просматривать любым текстовым редактором, искать по ним через grep или анализировать скриптами. Учтите, что полная выгрузка крупной конфигурации занимает заметное время и дисковое пространство.
- 1Откройте базу в конфигураторе с правами на просмотр конфигурации
- 2Выполните «Конфигурация → Выгрузить конфигурацию в файлы»
- 3Укажите пустой каталог и выберите иерархический формат
- 4Дождитесь завершения выгрузки и откройте Configuration.xml
- 5Проверьте, что папки соответствуют видам метаданных
Альтернатива полной выгрузке — пакетный режим конфигуратора с командой DumpConfigToFiles, который подходит для автоматизации. Он выполняется из командной строки без открытия интерфейса и удобен для регулярных снимков структуры.
1cv8 DESIGNER /F"C:\Bases\MyBase" /N"Администратор" /DumpConfigToFiles "C:\Dump\Config" -format HierarchicalСравнение и объединение как способ увидеть структуру
Инструмент «Конфигурация → Сравнить, объединить с конфигурацией из файла» показывает структуру в виде дерева различий. Даже если цель — не объединение, а просмотр, этот режим полезен: он выводит два дерева рядом и подсвечивает различающиеся объекты.
Такой подход применяют, когда нужно понять, какие объекты добавлены или изменены доработкой по отношению к типовой поставке. Загрузив файл поставки типовой конфигурации, вы увидите полный список отличий — это фактически готовая структура доработок.
Из окна сравнения доступен отчёт, который можно сохранить в табличный документ. В нём перечислены объекты с указанием статуса: изменён, добавлен, удалён. Это один из немногих штатных способов получить текстовый перечень объектов без программирования.
Программное получение структуры через объект «Метаданные»
Встроенный язык 1С предоставляет глобальный контекст Метаданные, через который доступна вся структура конфигурации. Это основной способ для автоматического анализа: построения отчётов, проверки прав, генерации документации.
Коллекции метаданных организованы по видам объектов: Метаданные.Справочники, Метаданные.Документы, Метаданные.РегистрыНакопления и т.д. У каждого объекта есть свойства (Имя, Синоним, Комментарий) и вложенные коллекции — реквизиты, табличные части, измерения, ресурсы.
Для Каждого Справочник Из Метаданные.Справочники Цикл
Сообщить(Справочник.Имя + " — " + Справочник.Синоним);
Для Каждого Реквизит Из Справочник.Реквизиты Цикл
Сообщить(" Реквизит: " + Реквизит.Имя);
КонецЦикла;
КонецЦикла;Такой код можно выполнить через внешнюю обработку, консоль кода или фоновое задание. Результат удобно выводить не сообщениями, а в таблицу значений с последующим сохранением в Excel или CSV — получится структурированный реестр объектов.
Ограничение способа — права доступа. Код выполняется под конкретным пользователем, и если у него нет прав на часть объектов, обход метаданных всё равно работает (метаданные доступны независимо от прав на данные), но обращение к данным этих объектов вызовет ошибку. Для чистого анализа структуры прав достаточно даже без административных.
Для регулярного анализа удобно оформить перебор метаданных внешней обработкой с выводом в табличный документ: колонки «Вид объекта», «Имя», «Синоним», «Подсистемы». Такой файл легко фильтровать и прикладывать к технической документации.
Отчёты по структуре и готовые обработки
Для получения читаемого описания конфигурации без программирования используются специализированные отчёты и обработки. В некоторых типовых решениях и библиотеках есть встроенные инструменты описания метаданных, а на открытых ресурсах для разработчиков распространены обработки «Структура конфигурации», выводящие дерево объектов с реквизитами в табличный документ.
Такие обработки обычно позволяют выбрать состав выгружаемой информации: только список объектов, объекты с реквизитами, объекты с привязкой к подсистемам или ролям. Результат сохраняется в MXL, Excel или HTML и подходит для передачи коллегам или заказчику.
При использовании сторонних обработок проверяйте их источник и запускайте сначала на копии базы. Обработка с перебором метаданных сама по себе безопасна, но код из непроверенного источника может содержать что угодно.
Просмотр структуры через 1C:EDT
1C:Enterprise Development Tools — среда разработки на базе Eclipse, где конфигурация представлена как проект с файловой структурой. После импорта информационной базы в проект все объекты метаданных отображаются в панели навигации в виде дерева, аналогичного проводнику.
Преимущество EDT — мощный поиск по проекту, навигация по ссылкам между объектами и встроенные проверки. Структура проекта хранится в файлах формата, пригодного для систем контроля версий, поэтому историю изменений структуры можно отслеживать через Git.
Импорт крупной конфигурации в EDT требует времени и памяти, поэтому для разового просмотра структуры конфигуратор обычно быстрее. EDT оправдан, когда анализ структуры — часть постоянной разработки.
Сравнение способов
Быстрый визуальный осмотр; нельзя получить текстовый список целиком
Полный слепок для поиска и версионирования; требует времени и места на диске
Гибкая выборка под любую задачу; нужно писать код
Показывает структуру доработок относительно типовой; нужен файл поставки
Проектное представление с поиском и Git; тяжёлый импорт больших баз
Частые ошибки и проверка результата
Типичная ошибка — путать конфигурацию разработчика с конфигурацией базы данных. Если после изменений не выполнено обновление конфигурации базы данных, структуры в этих двух представлениях различаются, и анализ может быть сделан по неактуальной версии.
Вторая ошибка — выгружать структуру только верхнего уровня, игнорируя вложенные объекты: реквизиты, табличные части, движения документов. Для аудита и документирования важен именно полный состав, включая роли и подсистемы.
Проверить полноту полученной структуры просто: количество объектов по видам в вашем отчёте должно совпадать с тем, что видно в дереве конфигуратора. Выборочно откройте несколько объектов и убедитесь, что их реквизиты в отчёте совпадают с палитрой свойств.
Что важно запомнить
Для быстрого осмотра используйте дерево метаданных в конфигураторе, для документирования — выгрузку в файлы или отчёт через перебор «Метаданные», для анализа доработок — сравнение с типовой поставкой. Перед любыми действиями со сторонними инструментами делайте копию базы.
Часто задаваемые вопросы
Можно ли получить структуру конфигурации без прав администратора?
Да. Просмотр метаданных и программный перебор коллекции «Метаданные» не требуют административных прав — достаточно права на запуск конфигуратора или внешней обработки. Ограничения касаются доступа к данным, а не к описанию структуры.
Как получить список только изменённых объектов относительно типовой конфигурации?
Используйте «Конфигурация → Сравнить, объединить с конфигурацией из файла» и укажите файл поставки типовой версии. Отчёт о различиях покажет добавленные и изменённые объекты — это и есть структура доработок.
Чем выгрузка в файлы отличается от выгрузки в файл .cf?
Файл .cf — бинарный контейнер всей конфигурации, пригодный для загрузки, но нечитаемый напрямую. Выгрузка в файлы создаёт набор XML-файлов, которые можно читать, искать по ним и анализировать скриптами.
Как выгрузить структуру конфигурации в Excel?
Штатной кнопки нет. Напишите небольшую обработку с перебором коллекций «Метаданные» и выводом в табличный документ, затем сохраните его в формате Excel. Либо используйте готовые обработки описания конфигурации, проверив их на копии базы.
Почему структура в конфигураторе отличается от того, что видят пользователи?
Пользователи видят интерфейс, сформированный подсистемами и правами, а не полное дерево метаданных. Кроме того, возможны неприменённые изменения: конфигурация разработчика обновлена, а конфигурация базы данных — нет.
Можно ли автоматизировать регулярное получение структуры?
Да, через пакетный режим конфигуратора с командой DumpConfigToFiles, запускаемой по расписанию. Полученные файлы удобно складывать в систему контроля версий — так вы получите историю изменения структуры.