Zum Inhalt springen
RUMLRUML

Open Format for Digital Law

4.16 ruml:tree-include

Leaf nodes that evaluate the subtree of a node of another RUML file in their place.

include-on-leaf

BeschreibungTwo leaves of an `AND` node each include one node of a law rulemap; one of them also refers to a further node with `ruml:tree-reference`. A third leaf has its own logic.
Erwartungaccept
Ebeneschema
RUML4-16-ruml-tree-include.fixtures/accept-include-on-leaf.ruml
Abschnitt§4.16
4-16-ruml-tree-include.fixtures/accept-include-on-leaf.ruml
{
"$format": "RUML",
"$specVersion": "1.0",
"capabilities": [
{
"id": "ruml:tree-reference"
},
{
"id": "ruml:tree-include"
}
],
"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",
"operator": "AND",
"label": "Gesellschaft wirksam gegründet",
"children": ["2", "3", "4"]
},
"2": {
"id": "3a9d7b2f-6c4e-4f80-8b1d-7e2c3f4a5b6c",
"label": "Gesellschaftsvertrag notariell beurkundet",
"capabilities": [
{
"id": "ruml:tree-include",
"payload": {
"uri": "https://rulemapping.org/rulemapping/gmbhg:2025-01-01#node/6e51c5a6-f7ff-43e1-b211-c70bd69937d7"
}
}
]
},
"3": {
"id": "4b0e8c3a-7d5f-4a91-9c2e-8f3d4a5b6c7d",
"label": "Stammkapital mind. 25.000 €",
"capabilities": [
{
"id": "ruml:tree-include",
"payload": {
"uri": "https://rulemapping.org/rulemapping/gmbhg:2025-01-01#node/7791005b-3d30-455b-a538-6d96f04680d9"
}
},
{
"id": "ruml:tree-reference",
"payload": {
"refersTo": [
{
"uri": "https://rulemapping.org/rulemapping/gmbhg:2025-01-01#node/9c4f2a7e-1b3d-4e6f-8a0b-2c4d6e8f0a1b"
}
]
}
}
]
},
"4": {
"id": "5c1f9d4b-8e6a-4ba2-ad3f-9a4e5b6c7d8e",
"label": "Eintragung ins Handelsregister"
}
}
}
}

root-payload

BeschreibungThe root-level declaration of `ruml:tree-include` has a payload.
Erwartungreject
Ebeneschema
RUML4-16-ruml-tree-include.fixtures/reject-root-payload.ruml
Abschnitt§4.16
Erwartete RegelverletzungenTREE-01
Stelle/capabilities/0
4-16-ruml-tree-include.fixtures/reject-root-payload.ruml
{
"$format": "RUML",
"$specVersion": "1.0",
"capabilities": [
{
"id": "ruml:tree-include",
"payload": {
"uri": "https://rulemapping.org/rulemapping/gmbhg:2025-01-01#node/6e51c5a6-f7ff-43e1-b211-c70bd69937d7"
}
}
],
"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-include",
"payload": {
"uri": "https://rulemapping.org/rulemapping/gmbhg:2025-01-01#node/6e51c5a6-f7ff-43e1-b211-c70bd69937d7"
}
}
]
}
}
}
}

include-without-uri

BeschreibungA node has `ruml:tree-include` with a payload without `uri`.
Erwartungreject
Ebeneschema
RUML4-16-ruml-tree-include.fixtures/reject-include-without-uri.ruml
Abschnitt§4.16
Erwartete RegelverletzungenTREE-01
Stelle/rulemap/nodes/1/capabilities/0/payload
4-16-ruml-tree-include.fixtures/reject-include-without-uri.ruml
{
"$format": "RUML",
"$specVersion": "1.0",
"capabilities": [
{
"id": "ruml:tree-include"
}
],
"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-include",
"payload": {}
}
]
}
}
}
}

include-same-document

BeschreibungAn inclusion uses a same-document `uri` (`#node/…`); reuse within one file is what modular nodes are for.
Erwartungreject
Ebeneschema
RUML4-16-ruml-tree-include.fixtures/reject-include-same-document.ruml
Abschnitt§4.16
Erwartete RegelverletzungenTREE-02
Stelle/rulemap/nodes/1/capabilities/0/payload/uri
4-16-ruml-tree-include.fixtures/reject-include-same-document.ruml
{
"$format": "RUML",
"$specVersion": "1.0",
"capabilities": [
{
"id": "ruml:tree-include"
}
],
"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-include",
"payload": {
"uri": "#node/6e51c5a6-f7ff-43e1-b211-c70bd69937d7"
}
}
]
}
}
}
}

including-node-with-children

BeschreibungA node with `ruml:tree-include` also has a child of its own; an including node is a leaf.
Erwartungreject
Ebeneschema
RUML4-16-ruml-tree-include.fixtures/reject-including-node-with-children.ruml
Abschnitt§4.1§4.16
Erwartete RegelverletzungenCAP-07
Stelle/rulemap/nodes/2/children
4-16-ruml-tree-include.fixtures/reject-including-node-with-children.ruml
{
"$format": "RUML",
"$specVersion": "1.0",
"capabilities": [
{
"id": "ruml:tree-include"
}
],
"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",
"operator": "AND",
"label": "Gesellschaft wirksam gegründet",
"children": ["2"]
},
"2": {
"id": "3a9d7b2f-6c4e-4f80-8b1d-7e2c3f4a5b6c",
"operator": "AND",
"label": "Gesellschaftsvertrag notariell beurkundet",
"children": ["3"],
"capabilities": [
{
"id": "ruml:tree-include",
"payload": {
"uri": "https://rulemapping.org/rulemapping/gmbhg:2025-01-01#node/6e51c5a6-f7ff-43e1-b211-c70bd69937d7"
}
}
]
},
"3": {
"id": "4b0e8c3a-7d5f-4a91-9c2e-8f3d4a5b6c7d",
"label": "Alle Gesellschafter haben unterzeichnet"
}
}
}
}

represents-and-include

BeschreibungA node includes a node of a law rulemap and also represents it with `ruml:tree-reference`; an including node already stands for the node it includes.
Erwartungreject
Ebeneschema
RUML4-16-ruml-tree-include.fixtures/reject-represents-and-include.ruml
Abschnitt§4.16
Erwartete RegelverletzungenTREE-08
Stelle/rulemap/nodes/1/capabilities
4-16-ruml-tree-include.fixtures/reject-represents-and-include.ruml
{
"$format": "RUML",
"$specVersion": "1.0",
"capabilities": [
{
"id": "ruml:tree-reference"
},
{
"id": "ruml:tree-include"
}
],
"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-include",
"payload": {
"uri": "https://rulemapping.org/rulemapping/gmbhg:2025-01-01#node/6e51c5a6-f7ff-43e1-b211-c70bd69937d7"
}
},
{
"id": "ruml:tree-reference",
"payload": {
"represents": {
"uri": "https://rulemapping.org/rulemapping/gmbhg:2025-01-01#node/6e51c5a6-f7ff-43e1-b211-c70bd69937d7"
}
}
}
]
}
}
}
}