Xdto

/unica:xdto — XDTO-пакеты 1С

Перед чтением или мутацией сверяй поддерживаемую грамматику и байтовые гарантии с ../../references/specs/1c-xdto-spec.md.

MCP routing

• Используй только MCP unica: unica.view читает пакет по адресу, а unica.apply с операциями семейства XDTO строит и применяет точечную мутацию.
• Всегда начинай с unica.view, затем перед каждой мутацией вызывай unica.apply с dryRun: true. Повторяй ровно тот же запрос с dryRun: false лишь после явного подтверждения пользователя; любое изменение аргументов требует нового preview.
• unica.apply принимает непустой упорядоченный массив ops. Связное изменение — тип и его свойства — веди одним вызовом: операции видят результаты предыдущих, публикация одна, отказ любой операции не оставляет частичной записи. Ошибка элемента называет ops[<индекс>].
• И читателю, и писателю передавай один адрес at вида <набор>:XDTOPackage.<Имя> (для операций над типом — <набор>:XDTOPackage.<Имя>.Type.<Тип>). Никогда не передавай путь к XDTOPackages/.../Ext/Package.bin: он остаётся внутренней раскладкой платформенной выгрузки.
• Не вызывай donor-команды compile, decompile или validate и не запускай их скриптовые обёртки: публичная граница этого скилла состоит ровно из двух нативных инструментов выше.

Операции семейства XDTO в ops — закрытое объединение с тегом op, а их аргументы едут внутри args.values: valueType.add (name, base), objectType.add (name), property.add (property, необязательный propertyPath), type.remove, property.remove (name, необязательный propertyPath). Тип, над которым идёт операция, называет at, а не отдельный аргумент. Для вложенного анонимного типа используй propertyPath, например "СсылкаНаОбъект" для ЛюбаяСсылка. Writer сохраняет BOM и наблюдённые переводы строк, а повтор того же добавления возвращает no-op. QName в base и property.type передавай с существующим префиксом. Если префикс не виден в области вставки, writer повторит его объявление локально только при единственном доказанном соответствии префикса URI во всём пакете; отсутствующее или противоречивое соответствие отклоняется без угадывания URI.

1. Прочитать логическую цель

Корень пакета отвечает целевым пространством имён и счётчиками, а состав лежит в ветвях Namespace, Type и Property; спускайся в нужную адресом из branches.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "unica.view",
    "arguments": {
      "cwd": "<workspace>",
      "at": "main:XDTOPackage.EnterpriseData_1_17_3"
    }
  }
}

Отдельный тип и его свойства читаются тем же вызовом глубже по адресу:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "unica.view",
    "arguments": {
      "cwd": "<workspace>",
      "at": "main:XDTOPackage.EnterpriseData_1_17_3.Type.ЛюбаяСсылка"
    }
  }
}

2. Построить preview

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "unica.apply",
    "arguments": {
      "at": "main:XDTOPackage.EnterpriseData_1_17_3.Type.ЛюбаяСсылка",
      "ops": [
        {
          "op": "property.add",
          "args": {
            "values": {
              "propertyPath": "СсылкаНаОбъект",
              "property": {
                "name": "Документ_НовыйДокумент",
                "type": "tns:Документ_ЗаказКлиента",
                "minOccurs": 0
              }
            }
          }
        }
      ],
      "dryRun": true
    }
  }
}

Связная последовательность — например objectType.add и следом property.add к созданному типу — передаётся тем же массивом ops и проверяется одним preview.

3. Применить только после подтверждения

Только после явного подтверждения пользователя повтори без изменений все аргументы preview, кроме dryRun:

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "unica.apply",
    "arguments": {
      "at": "main:XDTOPackage.EnterpriseData_1_17_3.Type.ЛюбаяСсылка",
      "ops": [
        {
          "op": "property.add",
          "args": {
            "values": {
              "propertyPath": "СсылкаНаОбъект",
              "property": {
                "name": "Документ_НовыйДокумент",
                "type": "tns:Документ_ЗаказКлиента",
                "minOccurs": 0
              }
            }
          }
        }
      ],
      "dryRun": false
    }
  }
}