Messwerte und Kennzahlen

B2Base · 1.0.0-draft.1 · Projektentwurf

Ein Messwert mit Definition, Einheit, Zeitbezug und Quelle.

Bibliothek · Messwerte und Reporting · Internationale Grundregeln

Direkt verwenden

Austauschschema (JSON) · Schema für den Designer · Beispieldaten

Austauschschema: vollständige Strukturprüfung mit JSON Schema 2020-12. Designer-Fassung: gleiche Datenfelder mit reduzierten Strukturregeln zur Feldübernahme. Anleitung und Grenzen

Felder im Überblick

Feld	Typ	Pflicht im Modul	Bedeutung
`id`	string	Ja	Beobachtungskennung.
`metric`	object	Ja	Definition der Messgröße oder Kennzahl.
`quantity`	object	Ja	Dezimalwert mit maschinenlesbarer Einheit; die Einheit muss zum Messgegenstand passen.
`observedAt`	string	Ja	Zeitpunkt der Beobachtung.
`subjectRef`	string	Nein	Bezugsobjekt.
`source`	string	Nein	Herkunft der Beobachtung.
`quality`	object	Nein	Optionaler Qualitäts- oder Schätzstatus.
`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

Kennzahlen benötigen eine Definition. Gleiche Namen garantieren keine gleiche Berechnung, Grundgesamtheit oder Einheit.
Für Zeitraumstatistiken ist ein eigenes Profil mit Intervall, Aggregation und Zeitzone erforderlich; observedAt benennt hier einen Zeitpunkt.
Dezimalwerte sind Text. Eine fehlende Beobachtung ist kein Messwert null oder 0; den Datensatz erst mit vorhandenem Wert anlegen.

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

example-1.json

{
  "id": "urn:example:observation:42",
  "metric": {
    "value": "mass",
    "scheme": "https://example.org/metrics/v1"
  },
  "quantity": {
    "value": "12.75",
    "unitCode": "KGM",
    "unitScheme": "https://unece.org/code-list-recommendations"
  },
  "observedAt": "2026-09-08T08:00:00Z"
}

Umstellung aus dem bisherigen Wiki

Die angekündigte Reportingkategorie erhält ein wiederverwendbares Modul für einzelne Beobachtungen.

Ä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.

observation.schema.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://b2base.eu/schemas/1.0.0-draft.1/reporting/observation.schema.json",
  "title": "Messwerte und Kennzahlen",
  "$comment": "B2Base 1.0.0-draft.1. Projektentwurf, kein durch ISO oder andere Normungsgremien verabschiedeter Standard.",
  "type": "object",
  "description": "Eine einzelne Beobachtung; keine unbeschriftete Zahl.",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Beobachtungskennung.",
      "format": "uri"
    },
    "metric": {
      "$ref": "#/$defs/CodedValue",
      "description": "Definition der Messgröße oder Kennzahl."
    },
    "quantity": {
      "$ref": "#/$defs/Quantity"
    },
    "observedAt": {
      "type": "string",
      "minLength": 1,
      "description": "Zeitpunkt der Beobachtung.",
      "format": "date-time"
    },
    "subjectRef": {
      "type": "string",
      "minLength": 1,
      "description": "Bezugsobjekt.",
      "format": "uri"
    },
    "source": {
      "type": "string",
      "minLength": 1,
      "description": "Herkunft der Beobachtung.",
      "format": "uri"
    },
    "quality": {
      "$ref": "#/$defs/CodedValue",
      "description": "Optionaler Qualitäts- oder Schätzstatus."
    },
    "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",
    "metric",
    "quantity",
    "observedAt"
  ],
  "additionalProperties": false,
  "$defs": {
    "CodedValue": {
      "type": "object",
      "description": "Fachlicher Code mit benanntem Vokabular.",
      "properties": {
        "value": {
          "type": "string",
          "minLength": 1,
          "description": "Code aus dem bezeichneten Vokabular; als Text unverändert übernehmen."
        },
        "scheme": {
          "type": "string",
          "minLength": 1,
          "description": "Absolute URI des Vokabulars, einschließlich einer Version, falls dessen Bedeutung veränderlich ist.",
          "format": "uri"
        },
        "label": {
          "type": "string",
          "minLength": 1,
          "description": "Optionale lesbare Bezeichnung."
        },
        "language": {
          "$ref": "#/$defs/LanguageTag",
          "description": "Sprache der Bezeichnung, nicht Staatsangehörigkeit."
        }
      },
      "required": [
        "value",
        "scheme"
      ],
      "additionalProperties": false
    },
    "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})*$"
    },
    "Quantity": {
      "type": "object",
      "description": "Dezimalwert mit maschinenlesbarer Einheit; die Einheit muss zum Messgegenstand passen.",
      "properties": {
        "value": {
          "type": "string",
          "minLength": 1,
          "description": "Dezimaltext ohne Gruppierung oder Exponent.",
          "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$"
        },
        "unitCode": {
          "type": "string",
          "minLength": 1,
          "description": "Code aus dem angegebenen Einheitensystem, etwa MTR, KGM oder MTK nach UN/CEFACT Recommendation 20."
        },
        "unitScheme": {
          "type": "string",
          "minLength": 1,
          "description": "URI des Einheitensystems; Empfänger muss das System unterstützen.",
          "format": "uri"
        }
      },
      "required": [
        "value",
        "unitCode",
        "unitScheme"
      ],
      "additionalProperties": false
    }
  },
  "examples": [
    {
      "id": "urn:example:observation:42",
      "metric": {
        "value": "mass",
        "scheme": "https://example.org/metrics/v1"
      },
      "quantity": {
        "value": "12.75",
        "unitCode": "KGM",
        "unitScheme": "https://unece.org/code-list-recommendations"
      },
      "observedAt": "2026-09-08T08:00:00Z"
    }
  ]
}

Quellen und Abgrenzung

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.

Zur Bibliothek · Integration · Häufige Fragen