4.15 ruml:tree-reference
Nodes that reference nodes, and with them the subtrees below, of other RUML files with typed references.
represents-and-refers-to
| Beschreibung | A rulemap declares `ruml:tree-reference` without payload; a node represents one node of a law rulemap and refers to two more, each with a node anchor `<ruml-version-uri>#node/<id>`. |
|---|---|
| Erwartung | accept |
| Ebene | schema |
| RUML | 4-15-ruml-tree-reference.fixtures/accept-represents-and-refers-to.ruml |
| Abschnitt | §4.15 |
{ "$format": "RUML", "$specVersion": "1.0", "capabilities": [ { "id": "ruml:tree-reference" } ], "metadata": { "id": "7d2e4f61-8a3b-4c5d-9e0f-1a2b3c4d5e6f", "version": "1.0.0", "created": "2026-10-19T00:00:00Z", "modified": "2026-10-19T00:00:00Z", "status": "draft", "title": "GmbH-Gründung prüfen" }, "rulemap": { "nodes": { "1": { "id": "2f8c6a1e-5b3d-4e7f-9a0c-6d1b2e3f4a5b", "label": "Gesellschaftsvertrag formgültig", "capabilities": [ { "id": "ruml:tree-reference", "payload": { "represents": { "uri": "https://rulemapping.org/rulemapping/gmbhg:2025-01-01#node/6e51c5a6-f7ff-43e1-b211-c70bd69937d7" }, "refersTo": [ { "uri": "https://rulemapping.org/rulemapping/gmbhg:2025-01-01#node/7791005b-3d30-455b-a538-6d96f04680d9" }, { "uri": "https://rulemapping.org/rulemapping/gmbhg:2025-01-01#node/9c4f2a7e-1b3d-4e6f-8a0b-2c4d6e8f0a1b" } ] } } ] } } }}root-payload
| Beschreibung | The root-level declaration of `ruml:tree-reference` has a payload. |
|---|---|
| Erwartung | reject |
| Ebene | schema |
| RUML | 4-15-ruml-tree-reference.fixtures/reject-root-payload.ruml |
| Abschnitt | §4.15 |
| Erwartete Regelverletzungen | TREE-01 |
| Stelle | /capabilities/0 |
{ "$format": "RUML", "$specVersion": "1.0", "capabilities": [ { "id": "ruml:tree-reference", "payload": {} } ], "metadata": { "id": "7d2e4f61-8a3b-4c5d-9e0f-1a2b3c4d5e6f", "version": "1.0.0", "created": "2026-10-19T00:00:00Z", "modified": "2026-10-19T00:00:00Z", "status": "draft", "title": "GmbH-Gründung prüfen" }, "rulemap": { "nodes": { "1": { "id": "2f8c6a1e-5b3d-4e7f-9a0c-6d1b2e3f4a5b", "label": "Gesellschaftsvertrag formgültig", "capabilities": [ { "id": "ruml:tree-reference", "payload": { "represents": { "uri": "https://rulemapping.org/rulemapping/gmbhg:2025-01-01#node/6e51c5a6-f7ff-43e1-b211-c70bd69937d7" } } } ] } } }}empty-tree-reference
| Beschreibung | A node has `ruml:tree-reference` with an empty payload. |
|---|---|
| Erwartung | reject |
| Ebene | schema |
| RUML | 4-15-ruml-tree-reference.fixtures/reject-empty-tree-reference.ruml |
| Abschnitt | §4.15 |
| Erwartete Regelverletzungen | TREE-01 |
| Stelle | /rulemap/nodes/1/capabilities/0/payload |
{ "$format": "RUML", "$specVersion": "1.0", "capabilities": [ { "id": "ruml:tree-reference" } ], "metadata": { "id": "7d2e4f61-8a3b-4c5d-9e0f-1a2b3c4d5e6f", "version": "1.0.0", "created": "2026-10-19T00:00:00Z", "modified": "2026-10-19T00:00:00Z", "status": "draft", "title": "GmbH-Gründung prüfen" }, "rulemap": { "nodes": { "1": { "id": "2f8c6a1e-5b3d-4e7f-9a0c-6d1b2e3f4a5b", "label": "Gesellschaftsvertrag formgültig", "capabilities": [ { "id": "ruml:tree-reference", "payload": {} } ] } } }}empty-refers-to
| Beschreibung | A node's `refersTo` is an empty array. |
|---|---|
| Erwartung | reject |
| Ebene | schema |
| RUML | 4-15-ruml-tree-reference.fixtures/reject-empty-refers-to.ruml |
| Abschnitt | §4.15 |
| Erwartete Regelverletzungen | TREE-01 |
| Stelle | /rulemap/nodes/1/capabilities/0/payload/refersTo |
{ "$format": "RUML", "$specVersion": "1.0", "capabilities": [ { "id": "ruml:tree-reference" } ], "metadata": { "id": "7d2e4f61-8a3b-4c5d-9e0f-1a2b3c4d5e6f", "version": "1.0.0", "created": "2026-10-19T00:00:00Z", "modified": "2026-10-19T00:00:00Z", "status": "draft", "title": "GmbH-Gründung prüfen" }, "rulemap": { "nodes": { "1": { "id": "2f8c6a1e-5b3d-4e7f-9a0c-6d1b2e3f4a5b", "label": "Gesellschaftsvertrag formgültig", "capabilities": [ { "id": "ruml:tree-reference", "payload": { "refersTo": [] } } ] } } }}includes-field
| Beschreibung | The payload has an `includes` field; a node that evaluates another file's subtree uses `ruml:tree-include` instead. |
|---|---|
| Erwartung | reject |
| Ebene | schema |
| RUML | 4-15-ruml-tree-reference.fixtures/reject-includes-field.ruml |
| Abschnitt | §4.15§4.16 |
| Erwartete Regelverletzungen | TREE-01 |
| Stelle | /rulemap/nodes/1/capabilities/0/payload/includes |
{ "$format": "RUML", "$specVersion": "1.0", "capabilities": [ { "id": "ruml:tree-reference" } ], "metadata": { "id": "7d2e4f61-8a3b-4c5d-9e0f-1a2b3c4d5e6f", "version": "1.0.0", "created": "2026-10-19T00:00:00Z", "modified": "2026-10-19T00:00:00Z", "status": "draft", "title": "GmbH-Gründung prüfen" }, "rulemap": { "nodes": { "1": { "id": "2f8c6a1e-5b3d-4e7f-9a0c-6d1b2e3f4a5b", "label": "Gesellschaftsvertrag formgültig", "capabilities": [ { "id": "ruml:tree-reference", "payload": { "includes": "https://rulemapping.org/rulemapping/gmbhg:2025-01-01#node/6e51c5a6-f7ff-43e1-b211-c70bd69937d7" } } ] } } }}represents-array
| Beschreibung | `represents` is an array of two references; a node represents at most one node. |
|---|---|
| Erwartung | reject |
| Ebene | schema |
| RUML | 4-15-ruml-tree-reference.fixtures/reject-represents-array.ruml |
| Abschnitt | §4.15 |
| Erwartete Regelverletzungen | TREE-01 |
| Stelle | /rulemap/nodes/1/capabilities/0/payload/represents |
{ "$format": "RUML", "$specVersion": "1.0", "capabilities": [ { "id": "ruml:tree-reference" } ], "metadata": { "id": "7d2e4f61-8a3b-4c5d-9e0f-1a2b3c4d5e6f", "version": "1.0.0", "created": "2026-10-19T00:00:00Z", "modified": "2026-10-19T00:00:00Z", "status": "draft", "title": "GmbH-Gründung prüfen" }, "rulemap": { "nodes": { "1": { "id": "2f8c6a1e-5b3d-4e7f-9a0c-6d1b2e3f4a5b", "label": "Gesellschaftsvertrag formgültig", "capabilities": [ { "id": "ruml:tree-reference", "payload": { "represents": [ { "uri": "https://rulemapping.org/rulemapping/gmbhg:2025-01-01#node/6e51c5a6-f7ff-43e1-b211-c70bd69937d7" }, { "uri": "https://rulemapping.org/rulemapping/gmbhg:2025-01-01#node/7791005b-3d30-455b-a538-6d96f04680d9" } ] } } ] } } }}same-document-node-reference
| Beschreibung | `refersTo` contains a same-document anchor (`#node/…`); reuse within one file is what modular nodes are for. |
|---|---|
| Erwartung | reject |
| Ebene | schema |
| RUML | 4-15-ruml-tree-reference.fixtures/reject-same-document-node-reference.ruml |
| Abschnitt | §4.15 |
| Erwartete Regelverletzungen | TREE-02 |
| Stelle | /rulemap/nodes/1/capabilities/0/payload/refersTo/0/uri |
{ "$format": "RUML", "$specVersion": "1.0", "capabilities": [ { "id": "ruml:tree-reference" } ], "metadata": { "id": "7d2e4f61-8a3b-4c5d-9e0f-1a2b3c4d5e6f", "version": "1.0.0", "created": "2026-10-19T00:00:00Z", "modified": "2026-10-19T00:00:00Z", "status": "draft", "title": "GmbH-Gründung prüfen" }, "rulemap": { "nodes": { "1": { "id": "2f8c6a1e-5b3d-4e7f-9a0c-6d1b2e3f4a5b", "label": "Gesellschaftsvertrag formgültig", "capabilities": [ { "id": "ruml:tree-reference", "payload": { "refersTo": [ { "uri": "#node/6e51c5a6-f7ff-43e1-b211-c70bd69937d7" } ] } } ] } } }}text-path-instead-of-node
| Beschreibung | `represents` points at a text element (`#ruml:text-reference/…`) instead of a node. |
|---|---|
| Erwartung | reject |
| Ebene | schema |
| RUML | 4-15-ruml-tree-reference.fixtures/reject-text-path-instead-of-node.ruml |
| Abschnitt | §4.15 |
| Erwartete Regelverletzungen | TREE-02 |
| Stelle | /rulemap/nodes/1/capabilities/0/payload/represents/uri |
{ "$format": "RUML", "$specVersion": "1.0", "capabilities": [ { "id": "ruml:tree-reference" } ], "metadata": { "id": "7d2e4f61-8a3b-4c5d-9e0f-1a2b3c4d5e6f", "version": "1.0.0", "created": "2026-10-19T00:00:00Z", "modified": "2026-10-19T00:00:00Z", "status": "draft", "title": "GmbH-Gründung prüfen" }, "rulemap": { "nodes": { "1": { "id": "2f8c6a1e-5b3d-4e7f-9a0c-6d1b2e3f4a5b", "label": "Gesellschaftsvertrag formgültig", "capabilities": [ { "id": "ruml:tree-reference", "payload": { "represents": { "uri": "https://rulemapping.org/rulemapping/gmbhg:2025-01-01#ruml:text-reference/text_main/4c1f0a52-8f7e-4b4a-9d0e-2a6b3c8e1f10" } } } ] } } }}duplicate-ref
| Beschreibung | `refersTo` contains the same `uri` twice. |
|---|---|
| Erwartung | reject |
| Ebene | schema |
| RUML | 4-15-ruml-tree-reference.fixtures/reject-duplicate-ref.ruml |
| Abschnitt | §4.15 |
| Erwartete Regelverletzungen | TREE-03 |
| Stelle | /rulemap/nodes/1/capabilities/0/payload/refersTo |
{ "$format": "RUML", "$specVersion": "1.0", "capabilities": [ { "id": "ruml:tree-reference" } ], "metadata": { "id": "7d2e4f61-8a3b-4c5d-9e0f-1a2b3c4d5e6f", "version": "1.0.0", "created": "2026-10-19T00:00:00Z", "modified": "2026-10-19T00:00:00Z", "status": "draft", "title": "GmbH-Gründung prüfen" }, "rulemap": { "nodes": { "1": { "id": "2f8c6a1e-5b3d-4e7f-9a0c-6d1b2e3f4a5b", "label": "Gesellschaftsvertrag formgültig", "capabilities": [ { "id": "ruml:tree-reference", "payload": { "refersTo": [ { "uri": "https://rulemapping.org/rulemapping/gmbhg:2025-01-01#node/6e51c5a6-f7ff-43e1-b211-c70bd69937d7" }, { "uri": "https://rulemapping.org/rulemapping/gmbhg:2025-01-01#node/6e51c5a6-f7ff-43e1-b211-c70bd69937d7" } ] } } ] } } }}