56 lines
3.5 KiB
Markdown
56 lines
3.5 KiB
Markdown
# Граф составляющих объекта конфигурации
|
|
|
|
Объект конфигурации — это корень, а не минимальная единица работы. Его
|
|
составляющие: модуль объекта, формы и их модули, макеты, схема компоновки
|
|
данных (СКД), а после декодирования СКД — наборы данных, запросы, поля,
|
|
ресурсы и варианты. Для записи нужен адрес именно составляющей и доказанный
|
|
физический носитель этой составляющей.
|
|
|
|
## Публичная инвентаризация
|
|
|
|
`metadata.object.components` — read-only фасад над уже доказанными SQL
|
|
декодерами. Он принимает обычный селектор владельца (`ref` либо `kind` и
|
|
`name`, при необходимости `extension`) и возвращает граф:
|
|
|
|
- корень `metadata_object`;
|
|
- только реально найденные `module`, `form`, `template` и `scd`;
|
|
- публичные `path` и `read_selector` каждого потомка;
|
|
- `unresolved` для областей, которые не были подтверждены.
|
|
|
|
Метод не создаёт потомок потому, что он обычно есть у такого типа объекта.
|
|
Например, пустой ответ `metadata.object.modules` у общей формы означает
|
|
«модуль этим маршрутом не найден», а не повод назвать форму модулем.
|
|
|
|
Пример запроса:
|
|
|
|
```json
|
|
{
|
|
"method": "metadata.object.components",
|
|
"payload": {
|
|
"base_id": "upo_test",
|
|
"extension": "test2",
|
|
"ref": "Report.tt_Отчет",
|
|
"include_storage": false
|
|
}
|
|
}
|
|
```
|
|
|
|
`read_selector` можно передать следующему read-only методу. Это не является
|
|
разрешением на запись: запись выбирает компонент по его `path`, повторно
|
|
подтверждает конкретный carrier/stream и разрешается только для семейства
|
|
контейнеров с доказанным byte-preserving кодеком.
|
|
|
|
## Иерархия и кодеки
|
|
|
|
Логический BSL один и тот же независимо от владельца, но его физический
|
|
носитель может различаться. Поэтому не нужны отдельные эвристики «для формы»
|
|
и «для отчёта»: нужен реестр семейств carrier-кодеков. Один кодек применяется
|
|
к нескольким типам объектов лишь после доказательства одинаковых границ,
|
|
непрозрачных атомов и round-trip проверки.
|
|
|
|
Текущий пример: модуль общего формы в `upo_test/test2` имеет доказанный
|
|
write-кодек saved-state; обнаруженный поток модуля отчёта — только
|
|
read-only structural codec. Второй компонент может быть найден и прочитан,
|
|
но не получит разрешение на SQL-запись, пока его служебный хвост не будет
|
|
декодирован.
|