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

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.

• Eine leere oder fehlende Liste allein bedeutet nicht staatenlos. Dafür wird citizenshipStatus ausdrücklich gesetzt.
• Familienstand und Beschäftigung haben keine hier behauptete weltweit einheitliche Klassifikation. scheme benennt die verwendete Bedeutung.
• Ein Status braucht bei zeitabhängiger Auswertung einen Bezugszeitpunkt; aktuelle und historische Angaben nicht vermischen.

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

example-1.json

{
  "citizenshipStatus": "stateless",
  "nationalities": [],
  "effectiveDate": "2026-09-08"
}

example-2.json

{
  "citizenshipStatus": "known",
  "nationalities": [
    "CA",
    "FR"
  ]
}

Der frühere Aufgabenvermerk wurde durch ein prüfbares Schema ersetzt. Es gibt keine automatische Ableitung aus Namen, Wohnort oder Sprache.

Änderungsübersicht und Migrationsregeln

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.

attributes.schema.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://b2base.eu/schemas/1.0.0-draft.1/person/attributes.schema.json",
  "title": "Personenmerkmale und Status",
  "$comment": "B2Base 1.0.0-draft.1. Projektentwurf, kein durch ISO oder andere Normungsgremien verabschiedeter Standard.",
  "type": "object",
  "description": "Optionale, zweckgebundene Personenmerkmale.",
  "properties": {
    "citizenshipStatus": {
      "type": "string",
      "minLength": 1,
      "description": "Unterscheidet bekannte Staatsangehörigkeit, Staatenlosigkeit und unbekannte Angaben.",
      "enum": [
        "known",
        "stateless",
        "undetermined",
        "notProvided"
      ]
    },
    "nationalities": {
      "type": "array",
      "description": "Bekannte Staatsangehörigkeiten; keine ethnische Zugehörigkeit.",
      "items": {
        "$ref": "#/$defs/CountryCode"
      },
      "uniqueItems": true
    },
    "maritalStatus": {
      "$ref": "#/$defs/CodedValue",
      "description": "Familienstand aus einem benannten fachlichen oder nationalen Vokabular."
    },
    "employmentStatus": {
      "$ref": "#/$defs/CodedValue",
      "description": "Beschäftigungsstatus mit Vokabular."
    },
    "effectiveDate": {
      "type": "string",
      "minLength": 1,
      "description": "Datum, für das die Angaben gelten.",
      "format": "date"
    },
    "extensions": {
      "type": "object",
      "description": "Vereinbarte Erweiterungen; Schlüssel als absolute URI des Herausgebers. Keine stillschweigende Änderung von Kernfeldern.",
      "properties": {},
      "additionalProperties": true,
      "propertyNames": {
        "format": "uri"
      }
    }
  },
  "additionalProperties": false,
  "minProperties": 1,
  "allOf": [
    {
      "if": {
        "properties": {
          "citizenshipStatus": {
            "const": "stateless"
          }
        },
        "required": [
          "citizenshipStatus"
        ]
      },
      "then": {
        "properties": {
          "nationalities": {
            "maxItems": 0
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "citizenshipStatus": {
            "const": "known"
          }
        },
        "required": [
          "citizenshipStatus"
        ]
      },
      "then": {
        "required": [
          "nationalities"
        ],
        "properties": {
          "nationalities": {
            "minItems": 1
          }
        }
      }
    }
  ],
  "$defs": {
    "CountryCode": {
      "type": "string",
      "minLength": 1,
      "description": "ISO 3166-1 Alpha-2, Großbuchstaben. Das Muster prüft nur die Schreibweise; zugewiesenen Code und Gültigkeitszeitpunkt gesondert prüfen.",
      "pattern": "^[A-Z]{2}$"
    },
    "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})*$"
    }
  },
  "examples": [
    {
      "citizenshipStatus": "stateless",
      "nationalities": [],
      "effectiveDate": "2026-09-08"
    },
    {
      "citizenshipStatus": "known",
      "nationalities": [
        "CA",
        "FR"
      ]
    }
  ]
}

• ISO: ISO 3166-Ländercodes
• 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.

Zur Bibliothek · Integration · Häufige Fragen