Seminar Magda Metadatenmodell, Registry, Aspects, Events und Webhooks

Das Seminar vertieft den Kern des Magda-Datenmodells. Records, Aspects, JSON-Schemas, Beziehungen, Ereignishistorie und Webhooks werden so eingesetzt, dass fachliche Erweiterungen valide, nachvollziehbar und integrationsfähig bleiben.

Inhaltsübersicht

1. Registry-Grundmodell
2. Aspect und JSON-Schema entwerfen
3. Records und Beziehungen
4. Änderungen und Historie
5. Webhooks und Ereignisfilter
6. Schemaänderung und Governance
7. Praxisübungen und Voraussetzungen

Zielgruppe

Softwareentwicklung, Datenarchitektur, Datenengineering, Integrationsentwicklung und technische Data Governance.

Lernziele

• Records und Aspects für fachliche Anforderungen korrekt modellieren.
• Aspect-Schemas erstellen, validieren und weiterentwickeln.
• Beziehungen zwischen Datensätzen, Distributionen und Organisationen abbilden.
• Registry-Ereignisse und Historie für Nachvollziehbarkeit nutzen.
• Webhooks robust filtern, zustellen und wiederholen.

Seminarinhalte

1. Registry-Grundmodell

1. Schritt 1: Record, Aspect und Record-Aspect klar unterscheiden.
2. Schritt 2: Vorhandene Datensatz-, Distributions- und Organisationsmuster analysieren.
3. Schritt 3: Fachliche Anforderung in ein neutrales Record-Modell übersetzen.

2. Aspect und JSON-Schema entwerfen

1. Schritt 1: Aspect-ID, Name und fachliche Verantwortung festlegen.
2. Schritt 2: JSON-Schema mit Pflichtfeldern, Typen und Wertebereichen erstellen.
3. Schritt 3: Valide und invalide Beispieldaten automatisiert prüfen.

3. Records und Beziehungen

1. Schritt 1: Records über die Registry-API anlegen.
2. Schritt 2: Mehrere Aspects konsistent an einen Record binden.
3. Schritt 3: Beziehungen und Referenzen zwischen Objekten nachvollziehbar modellieren.

4. Änderungen und Historie

1. Schritt 1: Erstellung, Änderung und Löschung als Ereignisfolge verfolgen.
2. Schritt 2: Änderungspatches interpretieren und frühere Zustände rekonstruieren.
3. Schritt 3: Nachvollziehbarkeitsanforderungen mit der Registry-Historie abgleichen.

5. Webhooks und Ereignisfilter

1. Schritt 1: Relevante Record- und Aspect-Änderungen auswählen.
2. Schritt 2: Webhook mit Ziel, Filter und Wiederholungsanforderungen konfigurieren.
3. Schritt 3: Zustellung, Fehler und idempotente Verarbeitung testen.

6. Schemaänderung und Governance

1. Schritt 1: Kompatible und inkompatible Schemaänderungen unterscheiden.
2. Schritt 2: Migrations- und Übergangsstrategie für bestehende Records planen.
3. Schritt 3: Versionierung, Freigabe und Dokumentation eines Aspects organisieren.

Praxisübungen

• Entwurf eines eigenen fachlichen Aspects mit JSON-Schema.
• Anlegen verknüpfter Records über die Registry-API.
• Rekonstruktion einer Änderung aus der Ereignishistorie.
• Konfiguration und Test eines Webhooks mit Fehlerwiederholung.

Voraussetzungen

Gute JSON- und API-Kenntnisse. Grundkenntnisse zu JSON Schema und ereignisgesteuerten Systemen sind hilfreich.