Skip to content
RUMLRUML

Open Format for Digital Law

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

DescriptionA 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>`.
Expectaccept
Layerschema
RUML4-15-ruml-tree-reference.fixtures/accept-represents-and-refers-to.ruml
Spec§4.15
4-15-ruml-tree-reference.fixtures/accept-represents-and-refers-to.ruml
{
"$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

DescriptionThe root-level declaration of `ruml:tree-reference` has a payload.
Expectreject
Layerschema
RUML4-15-ruml-tree-reference.fixtures/reject-root-payload.ruml
Spec§4.15
Expected rule violationsTREE-01
At/capabilities/0
4-15-ruml-tree-reference.fixtures/reject-root-payload.ruml
{
"$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

DescriptionA node has `ruml:tree-reference` with an empty payload.
Expectreject
Layerschema
RUML4-15-ruml-tree-reference.fixtures/reject-empty-tree-reference.ruml
Spec§4.15
Expected rule violationsTREE-01
At/rulemap/nodes/1/capabilities/0/payload
4-15-ruml-tree-reference.fixtures/reject-empty-tree-reference.ruml
{
"$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

DescriptionA node's `refersTo` is an empty array.
Expectreject
Layerschema
RUML4-15-ruml-tree-reference.fixtures/reject-empty-refers-to.ruml
Spec§4.15
Expected rule violationsTREE-01
At/rulemap/nodes/1/capabilities/0/payload/refersTo
4-15-ruml-tree-reference.fixtures/reject-empty-refers-to.ruml
{
"$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

DescriptionThe payload has an `includes` field; a node that evaluates another file's subtree uses `ruml:tree-include` instead.
Expectreject
Layerschema
RUML4-15-ruml-tree-reference.fixtures/reject-includes-field.ruml
Spec§4.15§4.16
Expected rule violationsTREE-01
At/rulemap/nodes/1/capabilities/0/payload/includes
4-15-ruml-tree-reference.fixtures/reject-includes-field.ruml
{
"$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

Description`represents` is an array of two references; a node represents at most one node.
Expectreject
Layerschema
RUML4-15-ruml-tree-reference.fixtures/reject-represents-array.ruml
Spec§4.15
Expected rule violationsTREE-01
At/rulemap/nodes/1/capabilities/0/payload/represents
4-15-ruml-tree-reference.fixtures/reject-represents-array.ruml
{
"$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

Description`refersTo` contains a same-document anchor (`#node/…`); reuse within one file is what modular nodes are for.
Expectreject
Layerschema
RUML4-15-ruml-tree-reference.fixtures/reject-same-document-node-reference.ruml
Spec§4.15
Expected rule violationsTREE-02
At/rulemap/nodes/1/capabilities/0/payload/refersTo/0/uri
4-15-ruml-tree-reference.fixtures/reject-same-document-node-reference.ruml
{
"$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

Description`represents` points at a text element (`#ruml:text-reference/…`) instead of a node.
Expectreject
Layerschema
RUML4-15-ruml-tree-reference.fixtures/reject-text-path-instead-of-node.ruml
Spec§4.15
Expected rule violationsTREE-02
At/rulemap/nodes/1/capabilities/0/payload/represents/uri
4-15-ruml-tree-reference.fixtures/reject-text-path-instead-of-node.ruml
{
"$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

Description`refersTo` contains the same `uri` twice.
Expectreject
Layerschema
RUML4-15-ruml-tree-reference.fixtures/reject-duplicate-ref.ruml
Spec§4.15
Expected rule violationsTREE-03
At/rulemap/nodes/1/capabilities/0/payload/refersTo
4-15-ruml-tree-reference.fixtures/reject-duplicate-ref.ruml
{
"$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"
}
]
}
}
]
}
}
}
}