1cconfinfo — анализ конфигурации 1С

Описание

Скилл для анализа структуры конфигурации 1С:Предприятие. Поддерживает три источника данных:

Приоритет: сначала MCP conf-doc (если подключён), затем Configuration.xml, затем OData $metadata.

См. skills/conf-doc/SKILL.md.

Источник 1: XML-выгрузка конфигурации

Используй скилл cf-info для анализа XML-выгрузки:

python .claude/skills/cf-info/scripts/cf-info.py -ConfigPath <путь_к_Configuration.xml_или_папке>

Или через PowerShell:

powershell -NoProfile -File .claude/skills/cf-info/scripts/cf-info.ps1 -ConfigPath <путь>

Режимы: overview (default), brief, full.

Структура выгрузки

Configuration.xml — корневой дескриптор метаданных:

• имя, версию, поставщика
• ссылки на все объекты конфигурации

Источник 2: OData $metadata (когда нет Configuration.xml)

Если выгрузки нет, используй скрипт odata-cfg-info.py:

python skills/1cconfinfo/scripts/odata-cfg-info.py [-Mode overview|brief|full]

Скрипт читает credentials из env.json, запрашивает {odata_url}/$metadata, кэширует ответ в .cache/ и показывает состав опубликованных объектов.

Параметры скрипта

Примеры

# Обзор (из кэша если есть, иначе — из OData)
python skills/1cconfinfo/scripts/odata-cfg-info.py

# Полный список объектов
python skills/1cconfinfo/scripts/odata-cfg-info.py -Mode full

# Принудительно обновить кэш
python skills/1cconfinfo/scripts/odata-cfg-info.py -ForceRefresh

# Краткая строка
python skills/1cconfinfo/scripts/odata-cfg-info.py -Mode brief

# Другой профиль
python skills/1cconfinfo/scripts/odata-cfg-info.py -EnvProfile prod

Как работает кэш

• Файл кэша: .cache/odata_metadata_<hash>.xml (hash от URL базы)
• TTL по умолчанию: 1 час (3600 сек)
• Повторные вызовы в течение часа работают без сетевых запросов
• -ForceRefresh принудительно обновляет кэш

Ограничения OData vs XML

Настройка env.json

{
  "default": {
    "odata_url": "http://localhost/your_base/odata/standard.odata",
    "odata_user": "Администратор",
    "odata_password": "пароль"
  }
}

Важно: Для кириллических паролей используй только этот скрипт. curl -u и PowerShell ломают кодировку при base64.

Алгоритм выбора источника

1. Подключён ли MCP 1c-conf-doc и conf_doc_health OK?
   ДА → conf_doc_search / conf_doc_get_object / conf_doc_get_object_chunk
   НЕТ → перейти к п.2

2. Есть ли Configuration.xml (или папка с ним)?
   ДА → использовать cf-info (полная информация)
   НЕТ → перейти к п.3

3. Есть ли env.json с odata_url?
   ДА → использовать odata-cfg-info.py (опубликованные объекты)
   НЕТ → попросить пользователя указать путь к выгрузке или настроить env.json

Структура файла объекта (XML-выгрузка)

<MetaDataObject xmlns="..." version="2.20">
  <Catalog uuid="...">
    <Properties>
      <Name>ИмяОбъекта</Name>
      <Synonym><v8:item><v8:content>Синоним</v8:content></v8:item></Synonym>
    </Properties>
    <ChildObjects>
      <Attribute uuid="...">
        <Properties>
          <Name>ИмяРеквизита</Name>
          <Type><v8:Type>cfg:CatalogRef.ДругойСправочник</v8:Type></Type>
        </Properties>
      </Attribute>
    </ChildObjects>
  </Catalog>
</MetaDataObject>

Типы ссылок в реквизитах

<v8:Type>cfg:CatalogRef.ИмяСправочника</v8:Type>
<v8:Type>cfg:DocumentRef.ИмяДокумента</v8:Type>
<v8:Type>cfg:EnumRef.ИмяПеречисления</v8:Type>
<v8:Type>xsd:string</v8:Type>
<v8:Type>xsd:decimal</v8:Type>
<v8:Type>xsd:boolean</v8:Type>
<v8:Type>xsd:dateTime</v8:Type>

Соглашения об именовании