====== Messwerte und Kennzahlen ====== **B2Base · 1.0.0-draft.1 · Projektentwurf** Ein Messwert mit Definition, Einheit, Zeitbezug und Quelle. [[schemes:scheme|Bibliothek]] · [[schemes:reporting|Messwerte und Reporting]] · [[schemes:principles|Internationale Grundregeln]] ===== Direkt verwenden ===== [[b2schema>1.0.0-draft.1/reporting/observation.schema.json|Austauschschema (JSON)]] · [[b2schema>1.0.0-draft.1/reporting/observation.editor.schema.json|Schema für den Designer]] · [[b2schema>1.0.0-draft.1/reporting/observation.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 | 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 ==== { "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. [[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. { "$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 ===== * [[https://www.rfc-editor.org/rfc/rfc3339.html|IETF RFC 3339: Datum und Zeitstempel]] * [[https://unece.org/code-list-recommendations|UN/CEFACT: Code-Listen und Recommendation 20]] 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]]