====== Datensatz-Metadaten ======

<WRAP b2hero>
**B2Base · 1.0.0-draft.1 · Projektentwurf**

Identität, Schemafassung, Herkunft und Zeitbezug eines austauschbaren Datensatzes.

[[schemes:scheme|Bibliothek]] · [[schemes:common|Gemeinsame Grundlagen]] · [[schemes:principles|Internationale Grundregeln]]
</WRAP>

===== Direkt verwenden =====

[[b2schema>1.0.0-draft.1/common/metadata.schema.json|Austauschschema (JSON)]] · [[b2schema>1.0.0-draft.1/common/metadata.editor.schema.json|Schema für den Designer]] · [[b2schema>1.0.0-draft.1/common/metadata.examples.json|Beispieldaten]]

**Austauschschema:** vollständige Strukturprüfung mit JSON Schema 2020-12. **Designer-Fassung:** gleiche Datenfelder mit reduzierten Strukturregeln zur Feldübernahme. [[:guidelines#im_workflowdesigner_verwenden|Anleitung und Grenzen]]

===== Felder im Überblick =====

^ Feld ^ Typ ^ Pflicht im Modul ^ Bedeutung ^
| ''id'' | string | Ja | Stabile absolute Kennung des Datensatzes. |
| ''schemaId'' | string | Ja | Kennung des tatsächlich verwendeten Austauschschemas. |
| ''createdAt'' | string | Nein | Erstellungszeitpunkt. |
| ''updatedAt'' | string | Nein | Letzte fachliche Änderung. |
| ''language'' | string | Nein | Optionale Standardsprache unmarkierter Freitexte. |
| ''source'' | string | Nein | Herkunftssystem oder Quelldatensatz. |
| ''version'' | string | Nein | Version des Datensatzes, unabhängig von der Schemafassung. |
| ''extensions'' | object | Nein | Vereinbarte Erweiterungen; Schlüssel als absolute URI des Herausgebers. Keine stillschweigende Änderung von Kernfeldern. |

Pflichtangaben gelten für das jeweilige Objekt, wenn dieses Modul verwendet wird. Zusätzliche Alternativen und Statusregeln stehen im Austauschschema. Optionale Felder weglassen, wenn sie unbekannt oder nicht anwendbar sind; ein leeres Pflichtfeld ist kein gültiger Ersatz.

===== International richtig einsetzen =====

  * Schemafassung und Datensatzversion sind unterschiedliche Dinge. Eine neue Adresse kann dieselbe Schemafassung weiterverwenden.
  * Zeitpunkte benötigen UTC oder einen numerischen Offset; reine lokale Uhrzeiten sind für systemübergreifende Ereignisse unzureichend.
  * id benennt Daten. schemaId benennt deren Struktur. Keines dieser Felder ist eine automatische Download- oder Ausführungsanweisung.

===== Gültige Beispiele =====

Alle Beispiele sind synthetisch. Sie werden mit dem mitgelieferten Schema geprüft; daraus folgt keine fachliche Echtheit oder externe Erreichbarkeit.

==== Beispiel 1 ====

<file json example-1.json>
{
  "id": "urn:example:record:42",
  "schemaId": "https://b2base.eu/schemas/1.0.0-draft.1/person/nameandbirthdetails.schema.json",
  "createdAt": "2026-09-08T08:00:00Z",
  "language": "sr-Latn"
}
</file>

===== Umstellung aus dem bisherigen Wiki =====

Neues gemeinsames Modul; lässt sich neben bestehende Fachdaten stellen, ohne zusätzliche Pflichtfelder in jedes Personenmodul einzubauen.

[[schemes:migration|Änderungsübersicht und Migrationsregeln]]

===== Vollständiges Schema =====

Die Datei ist eigenständig: verwendete Bausteine sind unter ''$defs'' eingebettet, Referenzen bleiben lokal. ''$id'' ist die kanonische Kennung. Die Downloads oben verwenden den aktuellen Server; eine Veröffentlichung unter der kanonischen Domain ist damit nicht behauptet.

<file json metadata.schema.json>
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://b2base.eu/schemas/1.0.0-draft.1/common/metadata.schema.json",
  "title": "Datensatz-Metadaten",
  "$comment": "B2Base 1.0.0-draft.1. Projektentwurf, kein durch ISO oder andere Normungsgremien verabschiedeter Standard.",
  "type": "object",
  "description": "Metadaten eines Datensatzes.",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Stabile absolute Kennung des Datensatzes.",
      "format": "uri"
    },
    "schemaId": {
      "type": "string",
      "minLength": 1,
      "description": "Kennung des tatsächlich verwendeten Austauschschemas.",
      "format": "uri"
    },
    "createdAt": {
      "type": "string",
      "minLength": 1,
      "description": "Erstellungszeitpunkt.",
      "format": "date-time"
    },
    "updatedAt": {
      "type": "string",
      "minLength": 1,
      "description": "Letzte fachliche Änderung.",
      "format": "date-time"
    },
    "language": {
      "$ref": "#/$defs/LanguageTag",
      "description": "Optionale Standardsprache unmarkierter Freitexte."
    },
    "source": {
      "type": "string",
      "minLength": 1,
      "description": "Herkunftssystem oder Quelldatensatz.",
      "format": "uri"
    },
    "version": {
      "type": "string",
      "minLength": 1,
      "description": "Version des Datensatzes, unabhängig von der Schemafassung."
    },
    "extensions": {
      "type": "object",
      "description": "Vereinbarte Erweiterungen; Schlüssel als absolute URI des Herausgebers. Keine stillschweigende Änderung von Kernfeldern.",
      "properties": {},
      "additionalProperties": true,
      "propertyNames": {
        "format": "uri"
      }
    }
  },
  "required": [
    "id",
    "schemaId"
  ],
  "additionalProperties": false,
  "$defs": {
    "LanguageTag": {
      "type": "string",
      "minLength": 1,
      "description": "BCP-47-Sprachtag, etwa de, zh-Hant-TW, sr-Latn oder x-internal. Das Muster prüft nur die Grundform, nicht Registrierung oder alle BCP-47-Regeln.",
      "pattern": "^[A-Za-z]{1,8}(-[A-Za-z0-9]{1,8})*$"
    }
  },
  "examples": [
    {
      "id": "urn:example:record:42",
      "schemaId": "https://b2base.eu/schemas/1.0.0-draft.1/person/nameandbirthdetails.schema.json",
      "createdAt": "2026-09-08T08:00:00Z",
      "language": "sr-Latn"
    }
  ]
}
</file>

===== Quellen und Abgrenzung =====

  * [[https://www.rfc-editor.org/rfc/rfc3339.html|IETF RFC 3339: Datum und Zeitstempel]]
  * [[https://www.rfc-editor.org/rfc/rfc5646.html|IETF RFC 5646: BCP-47-Sprachtags]]
  * [[https://json-schema.org/understanding-json-schema/structuring|JSON Schema: Aufbau und Referenzen]]

Quellen geprüft am 8. September 2026. Die B2Base-Felder und ihre Kombination sind ein eigener Entwurf. Code-Register, nationale Regeln, Echtheit, Zeitfolgen und Referenzziele benötigen die im jeweiligen Verfahren vereinbarten Zusatzprüfungen.

[[schemes:scheme|Zur Bibliothek]] · [[:guidelines|Integration]] · [[:faq|Häufige Fragen]]