1cconfinfo

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

Описание

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

| Источник | Когда использовать | |----------|-------------------| | MCP 1c-conf-doc (conf_doc_*) | Подключён MCP и backend доступен — семантический поиск по полной выгрузке | | XML-выгрузка (Configuration.xml) | Есть выгрузка конфигурации в файлы | | OData $metadata | Нет выгрузки, но есть опубликованная база |

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

См. [skills/conf-doc/SKILL.md](../conf-doc/SKILL.md).

---

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

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

python .claude/skills/cf-info/scripts/cf-info.py -ConfigPath 

Или через PowerShell:

powershell -NoProfile -File .claude/skills/cf-info/scripts/cf-info.ps1 -ConfigPath 

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

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

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

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

| Тип объекта | Папка | |-------------|-------| | Справочники | Catalogs/ | | Документы | Documents/ | | РегистрыСведений | InformationRegisters/ | | РегистрыНакопления | AccumulationRegisters/ | | Перечисления | Enums/ | | Отчёты | Reports/ | | Обработки | DataProcessors/ | | ОбщиеМодули | CommonModules/ | | Роли | Roles/ | | Подсистемы | Subsystems/ | | РегламентныеЗадания | ScheduledJobs/ | | ПланыОбмена | ExchangePlans/ | | HTTPСервисы | HTTPServices/ |

---

Источник 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/ и показывает состав опубликованных объектов.

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

| Параметр | Описание | По умолчанию | |----------|----------|--------------| | -Mode | overview / brief / full | overview | | -EnvFile | Путь к env.json | env.json | | -EnvProfile | Профиль в env.json | default | | -ODataUrl | Переопределить URL | из env.json | | -CacheDir | Папка для кэша | .cache | | -CacheTTL | Время жизни кэша (сек) | 3600 | | -ForceRefresh | Игнорировать кэш | false |

Примеры

# Обзор (из кэша если есть, иначе — из 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_.xml (hash от URL базы)
• TTL по умолчанию: 1 час (3600 сек)
• Повторные вызовы в течение часа работают без сетевых запросов
• -ForceRefresh принудительно обновляет кэш

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

| Возможность | XML-выгрузка | OData | |-------------|:---:|:---:| | Все объекты конфигурации | ✓ | ✗ (только опубликованные) | | Реквизиты объектов | ✓ | ✓ (через EntityType) | | Версия конфигурации | ✓ | ✗ | | Роли, подсистемы, модули | ✓ | ✗ | | Работает без выгрузки | ✗ | ✓ |

---

Настройка 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-выгрузка)

  
    
      ИмяОбъекта
      Синоним
    
    
      
        
          ИмяРеквизита
          cfg:CatalogRef.ДругойСправочник
        
      
    
  

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

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

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

| Паттерн | Пример | Значение | |---------|--------|----------| | ПрисоединенныеФайлы суффикс | СотрудникиПрисоединенныеФайлы | Каталог прикреплённых файлов | | бит_ префикс | бит_Доверенность | Кастомный объект доработки | | Удалить префикс | УдалитьБанки | Устаревший объект | | адаптер_ префикс | адаптер_ВходящиеСообщения | Объект интеграционного адаптера |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: gybson63
• Source: gybson63/1c-oData-skill
• License: MIT

Install and usage instructions live in the source repository linked above.