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

Разработка и Конфигурация · 9 мин

Как вывести структуру конфигурации 1С

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

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

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

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

Как открыть окно конфигурации и увидеть дерево метаданных

Запустите ярлык 1С:Предприятие, выберите нужную информационную базу в списке и нажмите кнопку «Конфигуратор». Режим «Предприятие» для этой задачи не подходит — дерево метаданных доступно только в конфигураторе.

После входа откройте меню «Конфигурация» и выберите пункт «Открыть конфигурацию». Если конфигурация закрыта, пункт будет называться именно так; при повторном вызове появится «Закрыть конфигурацию». Слева появится окно с деревом объектов: «Общие», «Константы», «Справочники», «Документы», «Регистры сведений», «Регистры накопления», «Отчёты», «Обработки» и другие ветки.

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

Порядок действий
  1. 1
    Запустите базу в режиме «Конфигуратор»
  2. 2
    Откройте меню «Конфигурация» → «Открыть конфигурацию»
  3. 3
    Дождитесь построения дерева метаданных в левой части окна
  4. 4
    Раскройте нужную ветку (например, «Документы») и откройте объект двойным кликом
  5. 5
    Проверьте, что видны реквизиты, табличные части и формы объекта

Как вывести список объектов одного типа

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

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

Для поиска конкретного объекта по имени используйте поле поиска над деревом конфигурации (если оно отображается в вашей версии платформы) либо глобальный поиск по метаданным через меню «Правка» → «Глобальный поиск» с отбором по типам объектов.

Как вывести структуру в файл для анализа

Если структуру нужно сохранить, передать коллеге или сравнить с другой базой, используйте выгрузку. Меню «Конфигурация» → «Выгрузить конфигурацию в файлы» сохраняет конфигурацию в виде набора XML-файлов с иерархией каталогов, повторяющей дерево метаданных. По структуре папок легко восстановить состав объектов.

Более лёгкий вариант — выгрузка в файл поставки или в файл .cf через «Конфигурация» → «Сохранить конфигурацию в файл». Сам по себе .cf не читается как текст, но его можно загрузить в пустую базу и уже там просмотреть структуру.

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

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

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

Пример обхода справочников и вывода их имён:

Для Каждого Спр Из Метаданные.Справочники Цикл

Сообщить(Спр.Имя + " — " + Спр.Синоним);

КонецЦикла;

Аналогично доступны коллекции Метаданные.Документы, Метаданные.РегистрыНакопления, Метаданные.Отчеты и другие. У каждого объекта метаданных можно прочитать реквизиты (свойство «Реквизиты»), табличные части и движения. Такой код запускают через внешнюю обработку в режиме «Предприятие» или через консоль кода.

bsl
Для Каждого Док Из Метаданные.Документы Цикл
    Сообщить(Док.Имя);
    Для Каждого Реквизит Из Док.Реквизиты Цикл
        Сообщить("  - " + Реквизит.Имя);
    КонецЦикла;
КонецЦикла;

Как вывести структуру подчинённых объектов и зависимостей

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

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

У документа структуру движений видно на закладке «Движения» в его свойствах — там перечислены регистры, по которым документ проводится. У регистра, наоборот, свойство «Регистраторы» показывает список документов, которые по нему пишут.

Ограничения, права доступа и типичные ошибки

Просмотр структуры требует прав: у пользователя должно быть право «Конфигуратор» (или административные права) в базе. Если кнопка «Конфигуратор» недоступна в стартовом окне, проверьте, не запущен ли тонкий клиент без поддержки конфигуратора и есть ли у учётной записи соответствующие права.

Если конфигурация находится на поддержке с запретом изменений, структуру смотреть можно, а редактировать — нет: объекты будут помечены замком. Для доработки включают возможность изменения через «Конфигурация» → «Поддержка» → «Настройка поддержки», но это решение стоит принимать осознанно, поскольку оно влияет на дальнейшие обновления.

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

Типичные ошибки
01
Поиск структуры в режиме «Предприятие» — дерево метаданных доступно только в конфигураторе
02
Загрузка .cf в рабочую базу вместо тестовой копии — доработки перезаписываются безвозвратно
03
Сравнение конфигураций без выгрузки текущей — при ошибочном объединении не к чему откатиться
04
Использование имени объекта вместо синонима в документации — пользователи видят синоним, а разработчики имя, из-за чего возникает путаница
Итог

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

Структура выводится в конфигураторе через «Открыть конфигурацию». Для файла — выгрузка в файлы или .cf, для связей — поиск ссылок на объект, для отчётов по составу — обход коллекции Метаданные кодом. Любые загрузки изменений делайте только после резервной копии.

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

Можно ли посмотреть структуру конфигурации без конфигуратора?

Полностью — нет: дерево метаданных открывается только в конфигураторе. Частично состав объектов виден в режиме «Предприятие» через меню «Все функции» (включается в параметрах), где перечислены справочники, документы, регистры и отчёты, доступные пользователю. Но это список прикладных объектов, а не структура метаданных со свойствами.

Как вывести список всех документов конфигурации в Excel?

Самый простой способ — открыть ветку «Документы» в дереве конфигурации, вывести список объектов ветки и скопировать его через буфер обмена. Альтернатива — небольшая обработка с обходом коллекции Метаданные.Документы и выводом имён и синонимов в табличный документ, который затем сохраняется в формате Excel.

Чем отличается конфигурация от конфигурации базы данных?

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

Как узнать, какие объекты доработаны относительно типовой конфигурации?

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

Почему в дереве конфигурации нет части объектов, которые видны у коллеги?

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

Можно ли выгрузить структуру конфигурации в текстовый или XML-формат?

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