diff --git a/plugins/1c/connector/adapter_1c_server.py b/plugins/1c/connector/adapter_1c_server.py
index 3a3b150..ed4b683 100644
--- a/plugins/1c/connector/adapter_1c_server.py
+++ b/plugins/1c/connector/adapter_1c_server.py
@@ -763,6 +763,7 @@ METHODS = [
{"name": "metadata.object.modules", "transport": "POST /rpc", "description": "1C-facing BSL module list for a metadata object, including owned form modules. Exact extension objects are resolved from public kind/name or ref through a live-validated route cache. include_storage must be a JSON boolean true/false, string values are invalid. Physical module ids are hidden unless include_storage=true."},
{"name": "metadata.object.related", "transport": "POST /rpc", "description": "1C-facing related metadata objects such as forms and templates. Physical record paths are hidden unless include_storage=true."},
{"name": "scd.inspect", "transport": "POST /rpc", "description": "Read-only inspection entry point for a report Data Composition Schema. Resolves a base report from Config or an extension report from ConfigCAS by public names, and returns partial evidence instead of inventing undecoded parameters, datasets, resources, or variants."},
+ {"name": "appearance.inspect", "transport": "POST /rpc", "description": "Read-only inspection of a base CommonTemplate whose payload is confirmed as AppearanceTemplate XML. Returns XML-backed appearance rules; no write route is exposed."},
{"name": "scd.prepare", "transport": "POST /rpc", "description": "Prepare the complete SQL saved-state file set required for one report SCD. For base reports it includes both report files and the separately stored Template payload group, while keeping SQL file identifiers internal."},
{"name": "scd.prepare.rollback", "transport": "POST /rpc", "description": "Remove exactly the rows inserted by one SCD preparation receipt after hash precondition checks. This is intended for controlled test cleanup and never touches active Config/ConfigCAS."},
{"name": "scd.compare", "transport": "POST /rpc", "description": "Read-only semantic comparison of active and prepared saved-state SCD XML: Config ↔ ConfigSave for base reports and ConfigCAS ↔ ConfigCASSave for extensions. Compares named parameters, datasets, fields, expressions, totals, and variants rather than storage hashes."},
@@ -36070,6 +36071,37 @@ def metadata_object_related(payload: dict[str, Any]) -> dict[str, Any]:
}
+def appearance_inspect(payload: dict[str, Any]) -> dict[str, Any]:
+ """Read a proven base CommonTemplate appearance XML carrier by public name."""
+ method = "appearance.inspect"
+ base_id_or_error = require_base_id(payload, method)
+ if isinstance(base_id_or_error, dict):
+ return base_id_or_error
+ base_id = base_id_or_error
+ if payload.get("extension") not in {None, ""} or payload.get("extension_guid") not in {None, ""}:
+ return {
+ "schema": "onec_appearance_inspect.v1", "method": method, "status": "unsupported", "base_id": base_id,
+ "diagnostics": {"code": "APPEARANCE_EXTENSION_ROUTE_UNPROVEN", "message": "Only a base CommonTemplate carrier is proven for this reader."},
+ }
+ template = str(payload.get("template") or payload.get("name") or payload.get("guid") or "").strip()
+ if not template:
+ return invalid_argument(method, "template", "template is required as a public CommonTemplate name or GUID.")
+ timeout_seconds = int(payload.get("timeout_seconds") or 60)
+ resolved = get_object("CommonTemplate", template, base_id=base_id, view="effective", limit=2, include_storage=True, include_semantic=False, timeout_seconds=timeout_seconds, table="Config")
+ if resolved.get("status") != "ok" or not isinstance(resolved.get("object"), dict):
+ return {"schema": "onec_appearance_inspect.v1", "method": method, "status": resolved.get("status") or "not_found", "base_id": base_id, "diagnostics": resolved.get("diagnostics") or {}}
+ object_card = resolved["object"]
+ guid = str(object_card.get("guid") or "").strip()
+ if not guid:
+ return {"schema": "onec_appearance_inspect.v1", "method": method, "status": "unresolved", "base_id": base_id, "diagnostics": {"code": "APPEARANCE_GUID_NOT_PROVEN"}}
+ data, _, read_error = read_storage_file_bytes(base_id, "Config", f"{guid}.0", timeout_seconds=min(timeout_seconds, 60))
+ if read_error or data is None:
+ return {"schema": "onec_appearance_inspect.v1", "method": method, "status": "not_found", "base_id": base_id, "diagnostics": (read_error or {}).get("diagnostics") or {"code": "APPEARANCE_PAYLOAD_NOT_FOUND"}}
+ from parser.appearance_payload import inspect_appearance_payload
+ decoded = inspect_appearance_payload(data)
+ return {"schema": "onec_appearance_inspect.v1", "method": method, "status": decoded.get("status"), "base_id": base_id, "template": public_metadata_row(object_card), "appearance": decoded, "activation_state": "working_not_runtime_applied"}
+
+
def scd_inspect(payload: dict[str, Any]) -> dict[str, Any]:
"""Resolve and decode one report SCD from its SQL ConfigCAS payload."""
method = "scd.inspect"
@@ -70405,6 +70437,8 @@ def call_method_impl(method: str, payload: dict[str, Any] | None) -> dict[str, A
return metadata_object_modules(payload)
if method == "metadata.object.related":
return metadata_object_related(payload)
+ if method == "appearance.inspect":
+ return appearance_inspect(payload)
if method == "scd.inspect":
return scd_inspect(payload)
if method == "scd.prepare":
diff --git a/tests/1c/test_payload_codec.py b/tests/1c/test_payload_codec.py
index e4f04e0..260a325 100644
--- a/tests/1c/test_payload_codec.py
+++ b/tests/1c/test_payload_codec.py
@@ -265,6 +265,18 @@ def test_appearance_payload_decoder_reads_xml_rules() -> None:
assert result["diagnostics"]["write"] == "unsupported_until_reverse_codec_fixture"
+def test_appearance_inspect_resolves_public_common_template(monkeypatch: pytest.MonkeyPatch) -> None:
+ source = compress_payload('- Заголовокx
'.encode("utf-8"), "raw_deflate")
+ monkeypatch.setattr(adapter_server, "get_object", lambda *_args, **_kwargs: {"status": "ok", "object": {"guid": "a" * 36, "kind": "CommonTemplate", "name": "Оформление"}})
+ monkeypatch.setattr(adapter_server, "read_storage_file_bytes", lambda *_args, **_kwargs: (source, {}, None))
+
+ result = adapter_server.appearance_inspect({"base_id": "upo_test", "template": "Оформление"})
+
+ assert result["status"] == "ok"
+ assert result["template"]["name"] == "Оформление"
+ assert result["appearance"]["items"][0]["parameter"] == "Заголовок"
+
+
def test_scd_scalar_patch_preserves_platform_prefix_and_trailer() -> None:
xml = """