Desko77 /config-index - индекс конфигурации 1С
Один проход по выгрузке, на выходе один JSON. Индекс отвечает на вопрос "что вообще есть в этой конфигурации и из чего оно состоит" - и тем самым дает остальным навыкам то, чего им не хватало: возможность проверить объект не сам по себе, а против остальной конфигурации.
Работает без EDT, без платформы и без запущенной базы - читает только файлы выгрузки.
Параметры
| Параметр | Обяз. | Умолч. | Описание |
|---|---|---|---|
| ConfigPath | да | - | Каталог выгрузки (где лежит Configuration.xml) либо путь к нему |
| OutFile | нет | - | Куда записать индекс. Без него JSON печатается в stdout |
| Detailed | нет | - | Дописать в отчет имена ненайденных объектов и время сборки |
Команда
powershell.exe -NoProfile -File "skills/1c-config-index/scripts/config-index.ps1" -ConfigPath "src" -OutFile "index.json"
python skills/1c-config-index/scripts/config-index.py -ConfigPath src -OutFile index.json
Что попадает в индекс
| Ключ | Что там |
|---|---|
format |
Версия схемы индекса. Читающий навык обязан ее проверять |
kind |
configuration либо extension - по ConfigurationExtensionPurpose |
name, version, namePrefix |
Имя конфигурации, версия, префикс имен расширения |
declared |
Состав Configuration.xml: тип -> список имен, в порядке записи |
objects |
Ключ Тип.Имя -> разбор объекта (см. ниже) |
types |
Все GeneratedType конфигурации: CatalogRef.Контрагенты, DocumentObject.Накладная и прочие |
commonModules |
Общий модуль -> список ЭКСПОРТНЫХ методов его Ext/Module.bsl |
missing |
Объявлено в Configuration.xml, но файла на диске нет |
unknownKinds |
Типы из ChildObjects, которых нет в карте типов |
Запись объекта несет только непустое: attributes, standardAttributes, tabularSections,
standardTabularSections, dimensions, resources, addressingAttributes, accountingFlags,
extDimensionAccountingFlags, enumValues, forms, templates, commands, subsystems,
recalculations, columns, operations, urlTemplates, valueType, props и refs. Пустые
корзины не пишутся: на конфигурации в тысячи объектов они дали бы мегабайты фигурных скобок.
Табличная часть записана как {"attributes": {имя: [типы]}, "standardAttributes": [имена]} -
собственные колонки и стандартные лежат рядом, но раздельно.
Стандартные реквизиты берутся из блока StandardAttributes самой выгрузки, а не из своей таблицы:
таблица разошлась бы с платформой молча. Имена там внутренние, английские (Description, Code,
Period) - и в путях данных формы они пишутся точно так же.
У реквизита хранится список типов с отброшенным префиксом пространства имен: CatalogRef.Контрагенты,
string, decimal. Ссылочный тип узнается по точке в имени.
props держит те свойства, которые нужны последующим проверкам: Hierarchical, CodeLength,
DescriptionLength, RegisterType, Periodicity, WriteMode, ObjectBelonging и флаги общего
модуля. refs - списки ссылок на другие объекты: состав подсистемы (Content), движения документа
(RegisterRecords), владельцы, основания, регистры последовательности.
Вложенная подсистема получает ключ с полным путем: Subsystem.Основная.Subsystem.Справочники -
именно так подсистема адресуется во всей конфигурации.
Чего индекс НЕ делает
Он ничего не проверяет и ни на что не ругается, кроме одного: сообщает, что объект объявлен в
Configuration.xml, а файла нет. Проверки строятся ПОВЕРХ индекса в других навыках.
Он не разбирает формы, макеты и схемы компоновки - только перечисляет их имена. Не читает права ролей. Не выводит типы выражений BSL и не понимает запросы: без платформы этого получить нельзя.
Сколько это стоит
Замер на синтетической конфигурации: 3007 объектов, 3515 файлов, 43 МБ выгрузки, индекс на выходе 2.7 МБ.
| Порт | Время |
|---|---|
| python | ~2.5 с |
| powershell | ~16 с |
Разрыв объясняется стоимостью обхода XML в PowerShell, а не разной работой: оба порта дают байт-в-байт одинаковый JSON, это закреплено кейсами. На больших конфигурациях брать python-порт.
Как этим пользуются другие навыки
Индекс строится ОДИН раз на прогон и передается проверкам файлом. Обход каталога на каждую ссылку превратил бы валидацию большой конфигурации в неприемлемо долгую.
python skills/1c-config-index/scripts/config-index.py -ConfigPath src -OutFile .cache/config-index.json
# дальше этот файл отдается навыкам-проверкам параметром -IndexPath
Расширение и частичная выгрузка - нормальное состояние: объект может ссылаться на то, чего в ЭТОЙ
выгрузке нет, потому что оно в основной конфигурации. Индекс это различает полем kind, а
проверяющий навык обязан на него смотреть - иначе на любом расширении утонет в ложных ошибках.
Связанные навыки
1c-cf-info- краткая сводка по конфигурации для человека; индекс же машинный и полный1c-meta-info- разбор одного объекта метаданных1c-meta-validate,1c-cf-validate,1c-form-validate- проверки, которые читают индекс