Skip to content
RUMLRUML

Open Format for Digital Law

4.12 ruml:text-reference

Text entries with RUML Text content, and local anchors into them.

law-text-as-ruml-text

DescriptionA law RUML carries § 1 SGB XII as RUML Text (LegalDocML.de namespace, digest, source); its node represents a sentence of it, named by `id` and the marker's `GUID` as `element`.
Expectaccept
Layerschema
RUML4-12-ruml-text-reference.fixtures/accept-law-text-as-ruml-text.ruml
Spec§4.12
4-12-ruml-text-reference.fixtures/accept-law-text-as-ruml-text.ruml
{
"$format": "RUML",
"$specVersion": "1.0",
"capabilities": [
{
"id": "ruml:text-reference",
"payload": {
"data": {
"text_main": {
"title": "Sozialgesetzbuch (SGB) Zwölftes Buch (XII) – Sozialhilfe",
"uri": "eli/bund/bgbl-1/2003/s3023/2026-07-30/1/deu",
"timestamp": "2026-10-09T00:00:00Z",
"type": "embedded",
"digest": "sha3-256:541651b3dea3102b4e29d035fbeebd8d6473630975d4848e57bf2831bb0249b3",
"source": {
"uri": "https://testphase.rechtsinformationen.bund.de/v1/legislation/eli/bund/bgbl-1/2003/s3023/2026-07-30/1/deu/regelungstext-verkuendung-1.xml"
},
"content": {
"type": "akomaNtoso",
"attrs": {
"xmlns": "http://Inhaltsdaten.LegalDocML.de/1.8.2/"
},
"content": [
{
"type": "act",
"attrs": {
"name": "regelungstext"
},
"content": [
{
"type": "body",
"attrs": {
"eId": "hauptteil-n1",
"GUID": "1f4e2a90-6b3c-4d7e-8a51-0c9d2e7f3b11"
},
"content": [
{
"type": "article",
"attrs": {
"eId": "art-z1",
"GUID": "0b1e9e8a-2c55-4f5f-9a3e-6d1c7b2a4e01"
},
"content": [
{
"type": "num",
"attrs": {
"eId": "art-z1_bezeichnung-n1",
"GUID": "6e3a1d70-9c42-4b85-a7f1-3d2c8b0e5f12"
},
"content": ["§ 1"]
},
{
"type": "heading",
"attrs": {
"eId": "art-z1_überschrift-n1",
"GUID": "2a9c5e81-4d07-4f3b-b6e2-8f1a0c7d9e13"
},
"content": ["Aufgabe der Sozialhilfe"]
},
{
"type": "paragraph",
"attrs": {
"eId": "art-z1_abs-z",
"GUID": "5d8f3c21-7a64-4c0b-8e2f-1a9b6c3d7e02"
},
"content": [
{
"type": "num",
"attrs": {
"eId": "art-z1_abs-z_bezeichnung-n1",
"GUID": "8b2d4f63-1e90-4a7c-9d35-6f0e2b1c8a14"
}
},
{
"type": "content",
"attrs": {
"eId": "art-z1_abs-z_inhalt-n1",
"GUID": "3c7e9b05-2f18-4d6a-8e4c-1b9d0f5a7c15"
},
"content": [
{
"type": "p",
"attrs": {
"eId": "art-z1_abs-z_inhalt-n1_text-n1",
"GUID": "d4a1c826-5b3e-4f07-a9d2-7e6c3b0f1a16"
},
"content": [
"Aufgabe der Sozialhilfe ist es, den Leistungsberechtigten die Führung eines Lebens zu ermöglichen, das der Würde des Menschen entspricht.",
{
"type": "marker",
"attrs": {
"eId": "art-z1_abs-z_inhalt-n1_text-n1_marker-n1",
"GUID": "9a7c2e14-3b58-4d6f-a1e0-4c2b8d5f6a03",
"refersTo": "satzende"
}
},
" Die Leistung soll sie so weit wie möglich befähigen, unabhängig von ihr zu leben; darauf haben auch die Leistungsberechtigten nach ihren Kräften hinzuarbeiten.",
{
"type": "marker",
"attrs": {
"eId": "art-z1_abs-z_inhalt-n1_text-n1_marker-n2",
"GUID": "f15b8e37-6a29-4c41-8d7f-2e0a9c3b5d17",
"refersTo": "satzende"
}
},
" Zur Erreichung dieser Ziele haben die Leistungsberechtigten und die Träger der Sozialhilfe im Rahmen ihrer Rechte und Pflichten zusammenzuwirken.",
{
"type": "marker",
"attrs": {
"eId": "art-z1_abs-z_inhalt-n1_text-n1_marker-n3",
"GUID": "7e2c0a49-8d16-4b5e-9f83-5a1d4c6e2b18",
"refersTo": "satzende"
}
}
]
}
]
}
]
}
]
}
]
}
]
}
]
}
}
}
}
}
],
"metadata": {
"id": "ec36948d-fbb2-4815-985a-bd5e9375d934",
"version": "2026-07-30",
"created": "2026-10-09T00:00:00Z",
"modified": "2026-10-09T00:00:00Z",
"status": "inForce",
"validFrom": "2026-07-30T00:00:00Z",
"documentType": "law",
"title": "SGB XII § 1"
},
"rulemap": {
"nodes": {
"1": {
"id": "0eb360a6-626a-406d-89a1-9f434ced141b",
"label": "Aufgabe der Sozialhilfe",
"capabilities": [
{
"id": "ruml:text-reference",
"payload": {
"refs": [
{
"id": "text_main",
"element": "9a7c2e14-3b58-4d6f-a1e0-4c2b8d5f6a03",
"type": "represents"
}
]
}
}
]
}
}
}
}

own-text-without-uri

DescriptionA draft rulemap carries a text written in the file itself: a UUID-based key, a `title`, no `uri`, and a node representing the whole entry (anchor without `element`).
Expectaccept
Layerschema
RUML4-12-ruml-text-reference.fixtures/accept-own-text-without-uri.ruml
Spec§4.12
4-12-ruml-text-reference.fixtures/accept-own-text-without-uri.ruml
{
"$format": "RUML",
"$specVersion": "1.0",
"capabilities": [
{
"id": "ruml:text-reference",
"payload": {
"data": {
"text_3f2c9a1e4b7d4e0f9a6c1b2d3e4f5a6b": {
"title": "Benutzungssatzung der Stadtbibliothek",
"timestamp": "2026-10-10T09:00:00Z",
"status": "draft",
"text": "§ 1 Benutzungsberechtigt ist, wer einen gültigen Bibliotheksausweis besitzt."
}
}
}
}
],
"metadata": {
"id": "5b0e7c8d-2f41-4a9e-8c3b-1d6f0e2a7b95",
"version": "0.1.0",
"created": "2026-10-10T09:00:00Z",
"modified": "2026-10-10T09:00:00Z",
"status": "draft"
},
"rulemap": {
"nodes": {
"1": {
"id": "a3b6c9d2-4e5f-4a1b-8c7d-0e9f2a3b4c5d",
"label": "Benutzungsberechtigung",
"capabilities": [
{
"id": "ruml:text-reference",
"payload": {
"refs": [
{
"id": "text_3f2c9a1e4b7d4e0f9a6c1b2d3e4f5a6b",
"type": "represents"
}
]
}
}
]
}
}
}
}

text-without-title

DescriptionA text entry has `uri`, `timestamp`, `status` and `text` but no `title`.
Expectreject
Layerschema
RUML4-12-ruml-text-reference.fixtures/reject-text-without-title.ruml
Spec§4.12
Expected rule violationsTXT-04
At/capabilities/0/payload/data/text_main
4-12-ruml-text-reference.fixtures/reject-text-without-title.ruml
{
"$format": "RUML",
"$specVersion": "1.0",
"capabilities": [
{
"id": "ruml:text-reference",
"payload": {
"data": {
"text_main": {
"uri": "/akn/de/act/2024-01-01/estg",
"timestamp": "2026-10-09T00:00:00Z",
"status": "inForce",
"text": "§ 1 Steuerpflicht"
}
}
}
}
],
"metadata": {
"id": "ec36948d-fbb2-4815-985a-bd5e9375d934",
"version": "2024-01-01",
"created": "2026-10-09T00:00:00Z",
"modified": "2026-10-09T00:00:00Z",
"status": "inForce",
"validFrom": "2024-01-01T00:00:00Z",
"documentType": "law"
},
"rulemap": {
"nodes": {
"1": {
"id": "0eb360a6-626a-406d-89a1-9f434ced141b",
"label": "Steuerpflicht"
}
}
}
}

text-and-content

DescriptionA text entry carries both plain `text` and RUML Text `content`.
Expectreject
Layerschema
RUML4-12-ruml-text-reference.fixtures/reject-text-and-content.ruml
Spec§4.12
Expected rule violationsTXT-07
At/capabilities/0/payload/data/text_main
4-12-ruml-text-reference.fixtures/reject-text-and-content.ruml
{
"$format": "RUML",
"$specVersion": "1.0",
"capabilities": [
{
"id": "ruml:text-reference",
"payload": {
"data": {
"text_main": {
"title": "Einkommensteuergesetz",
"uri": "/akn/de/act/2024-01-01/estg",
"timestamp": "2026-10-09T00:00:00Z",
"status": "inForce",
"text": "§ 1 Steuerpflicht",
"digest": "sha3-256:0000000000000000000000000000000000000000000000000000000000000000",
"content": {
"type": "akomaNtoso",
"attrs": {
"xmlns": "http://Inhaltsdaten.LegalDocML.de/1.8.2/"
},
"content": []
}
}
}
}
}
],
"metadata": {
"id": "ec36948d-fbb2-4815-985a-bd5e9375d934",
"version": "2024-01-01",
"created": "2026-10-09T00:00:00Z",
"modified": "2026-10-09T00:00:00Z",
"status": "inForce",
"validFrom": "2024-01-01T00:00:00Z",
"documentType": "law"
},
"rulemap": {
"nodes": {
"1": {
"id": "0eb360a6-626a-406d-89a1-9f434ced141b",
"label": "Steuerpflicht"
}
}
}
}

content-without-digest

DescriptionA text entry has `content` but no `digest`.
Expectreject
Layerschema
RUML4-12-ruml-text-reference.fixtures/reject-content-without-digest.ruml
Spec§4.12
Expected rule violationsTXT-08
At/capabilities/0/payload/data/text_main
4-12-ruml-text-reference.fixtures/reject-content-without-digest.ruml
{
"$format": "RUML",
"$specVersion": "1.0",
"capabilities": [
{
"id": "ruml:text-reference",
"payload": {
"data": {
"text_main": {
"title": "Einkommensteuergesetz",
"uri": "/akn/de/act/2024-01-01/estg",
"timestamp": "2026-10-09T00:00:00Z",
"content": {
"type": "akomaNtoso",
"attrs": {
"xmlns": "http://Inhaltsdaten.LegalDocML.de/1.8.2/"
},
"content": []
}
}
}
}
}
],
"metadata": {
"id": "ec36948d-fbb2-4815-985a-bd5e9375d934",
"version": "2024-01-01",
"created": "2026-10-09T00:00:00Z",
"modified": "2026-10-09T00:00:00Z",
"status": "inForce",
"validFrom": "2024-01-01T00:00:00Z",
"documentType": "law"
},
"rulemap": {
"nodes": {
"1": {
"id": "0eb360a6-626a-406d-89a1-9f434ced141b",
"label": "Steuerpflicht"
}
}
}
}

content-without-namespace

DescriptionThe root of a text's `content` declares no namespace, so it names no Akoma Ntoso dialect.
Expectreject
Layerschema
RUML4-12-ruml-text-reference.fixtures/reject-content-without-namespace.ruml
Spec§4.12
Expected rule violationsTXT-15
At/capabilities/0/payload/data/text_main/content
4-12-ruml-text-reference.fixtures/reject-content-without-namespace.ruml
{
"$format": "RUML",
"$specVersion": "1.0",
"capabilities": [
{
"id": "ruml:text-reference",
"payload": {
"data": {
"text_main": {
"title": "Einkommensteuergesetz",
"uri": "/akn/de/act/2024-01-01/estg",
"timestamp": "2026-10-09T00:00:00Z",
"digest": "sha3-256:76d99de78df2c37611134daf1a8b9110af6a3da8918b206be675afda0261c2b6",
"content": {
"type": "akomaNtoso",
"content": []
}
}
}
}
}
],
"metadata": {
"id": "ec36948d-fbb2-4815-985a-bd5e9375d934",
"version": "2024-01-01",
"created": "2026-10-09T00:00:00Z",
"modified": "2026-10-09T00:00:00Z",
"status": "inForce",
"validFrom": "2024-01-01T00:00:00Z",
"documentType": "law"
},
"rulemap": {
"nodes": {
"1": {
"id": "0eb360a6-626a-406d-89a1-9f434ced141b",
"label": "Steuerpflicht"
}
}
}
}

anchor-into-another-ruml

DescriptionAn anchor points into a law in another RUML file with an absolute `uri`; anchors are local and have no `uri`.
Expectreject
Layerschema
RUML4-12-ruml-text-reference.fixtures/reject-anchor-into-another-ruml.ruml
Spec§4.12
Expected rule violationsTXT-01
At/rulemap/nodes/1/capabilities/0/payload/refs/0
4-12-ruml-text-reference.fixtures/reject-anchor-into-another-ruml.ruml
{
"$format": "RUML",
"$specVersion": "1.0",
"capabilities": [
{
"id": "ruml:text-reference"
}
],
"metadata": {
"id": "5b0c1d2e-3f40-4a5b-8c6d-7e8f9a0b1c2d",
"version": "3.1.0",
"created": "2026-10-09T00:00:00Z",
"modified": "2026-10-09T00:00:00Z",
"status": "draft",
"title": "Grundsicherung im Alter"
},
"rulemap": {
"nodes": {
"1": {
"id": "0eb360a6-626a-406d-89a1-9f434ced141b",
"label": "Leistungsberechtigt nach § 41 SGB XII",
"capabilities": [
{
"id": "ruml:text-reference",
"payload": {
"refs": [
{
"uri": "https://rulemapping.org/rulemapping/sgb-12:2026-07-30#ruml:text-reference/text_main/5d8f3c21-7a64-4c0b-8e2f-1a9b6c3d7e02",
"type": "represents"
}
]
}
}
]
}
}
}
}

anchor-without-type

DescriptionAn anchor names a text entry and an element but no `type`.
Expectreject
Layerschema
RUML4-12-ruml-text-reference.fixtures/reject-anchor-without-type.ruml
Spec§4.12
Expected rule violationsTXT-01
At/rulemap/nodes/1/capabilities/0/payload/refs/0
4-12-ruml-text-reference.fixtures/reject-anchor-without-type.ruml
{
"$format": "RUML",
"$specVersion": "1.0",
"capabilities": [
{
"id": "ruml:text-reference"
}
],
"metadata": {
"id": "5b0c1d2e-3f40-4a5b-8c6d-7e8f9a0b1c2d",
"version": "3.1.0",
"created": "2026-10-09T00:00:00Z",
"modified": "2026-10-09T00:00:00Z",
"status": "draft"
},
"rulemap": {
"nodes": {
"1": {
"id": "0eb360a6-626a-406d-89a1-9f434ced141b",
"label": "Leistungsberechtigt",
"capabilities": [
{
"id": "ruml:text-reference",
"payload": {
"refs": [
{
"id": "text_main",
"element": "5d8f3c21-7a64-4c0b-8e2f-1a9b6c3d7e02"
}
]
}
}
]
}
}
}
}

two-represents-anchors

DescriptionA node marks two different texts as the norm it represents.
Expectreject
Layerschema
RUML4-12-ruml-text-reference.fixtures/reject-two-represents-anchors.ruml
Spec§4.12
Expected rule violationsTXT-01
At/rulemap/nodes/1/capabilities/0/payload/refs
4-12-ruml-text-reference.fixtures/reject-two-represents-anchors.ruml
{
"$format": "RUML",
"$specVersion": "1.0",
"capabilities": [
{
"id": "ruml:text-reference",
"payload": {
"data": {
"text_estg_1": {
"title": "§ 1 EStG",
"uri": "/akn/de/act/2024-01-01/estg#sec_1",
"timestamp": "2026-10-09T00:00:00Z",
"status": "inForce",
"text": "§ 1 Steuerpflicht (1) Natürliche Personen, die im Inland einen Wohnsitz oder ihren gewöhnlichen Aufenthalt haben, sind unbeschränkt einkommensteuerpflichtig."
},
"text_estg_2": {
"title": "§ 2 EStG",
"uri": "/akn/de/act/2024-01-01/estg#sec_2",
"timestamp": "2026-10-09T00:00:00Z",
"status": "inForce",
"text": "§ 2 Umfang der Besteuerung, Begriffsbestimmungen"
}
}
}
}
],
"metadata": {
"id": "ec36948d-fbb2-4815-985a-bd5e9375d934",
"version": "2024-01-01",
"created": "2026-10-09T00:00:00Z",
"modified": "2026-10-09T00:00:00Z",
"status": "inForce",
"validFrom": "2024-01-01T00:00:00Z",
"documentType": "law"
},
"rulemap": {
"nodes": {
"1": {
"id": "0eb360a6-626a-406d-89a1-9f434ced141b",
"label": "Unbeschränkte Steuerpflicht",
"capabilities": [
{
"id": "ruml:text-reference",
"payload": {
"refs": [
{
"id": "text_estg_1",
"type": "represents"
},
{
"id": "text_estg_2",
"type": "represents"
}
]
}
}
]
}
}
}
}