Seminar sovity Assets und Datenangebote modellieren

Inhaltsverzeichnis

1. Zielsetzung
2. Zielgruppe
3. Voraussetzungen
4. Seminarinhalte
   1. Modul 1: Assets, Identifikatoren und technische Datenadressen
   2. Modul 2: Metadaten und semantische Auffindbarkeit
   3. Modul 3: HTTP-, API- und Dateiquellen
   4. Modul 4: Access Policies und Contract Policies
   5. Modul 5: Contract Definition und Veröffentlichung
5. Praxisübungen
6. Methodik

Zielsetzung

Das Seminar vermittelt einen belastbaren Modellierungsprozess vom fachlichen Datenprodukt bis zum veröffentlichten Datenangebot. Asset-Schnitt, Identifikatoren, Metadaten, technische Datenadresse, Access Policy, Contract Policy und Contract Definition werden getrennt aufgebaut, geprüft und in einem Ende-zu-Ende-Test zusammengeführt.

Zielgruppe

Data Product Owner, Datenarchitekten, Connector-Administratoren, Integrationsverantwortliche und technische Datenanbieter.

Voraussetzungen

Grundverständnis von Datenräumen und Datenquellen; keine Programmierung erforderlich.

Seminarinhalte

Die Themen werden in der angegebenen Reihenfolge aufgebaut. Jeder Schritt setzt auf dem zuvor geprüften Systemzustand auf.

Modul 1: Assets, Identifikatoren und technische Datenadressen

Fachliches Datenprodukt und technische Bereitstellung werden unabhängig modelliert.

1. Schritt 1: Stabile Asset-ID, Version, Domäne und Lebenszyklusstatus nach einer Namenskonvention festlegen.
2. Schritt 2: Granularität so wählen, dass Policies und Transfers ohne unnötige Kopplung möglich bleiben.
3. Schritt 3: Quelltyp, Endpunkt, Methode, Format und statische beziehungsweise dynamische Parameter konfigurieren.
4. Schritt 4: Zugangsdaten nur als Secret- oder Vault-Referenz hinterlegen und Quelle mit Positiv- und Negativfall prüfen.

Modul 2: Metadaten und semantische Auffindbarkeit

Die Beschreibung des Datenprodukts wird für Suche, Bewertung und automatisierte Verarbeitung strukturiert.

1. Schritt 1: Titel, Beschreibung, Schlüsselwörter, Datenformat, Aktualität und fachlichen Geltungsbereich definieren.
2. Schritt 2: Pflichtfelder, organisationsspezifische Erweiterungen und kontrollierte Werte in einem Profil festhalten.
3. Schritt 3: JSON-LD-Kontexte und DCAT-nahe Eigenschaften konsistent benennen.
4. Schritt 4: Katalogdarstellung aus Sicht einer fremden Organisation prüfen und fehlende Suchmerkmale ergänzen.

Modul 3: HTTP-, API- und Dateiquellen

Web- und dateibasierte Quellen werden mit kontrollierter Parametrisierung und Authentifizierung eingebunden.

1. Schritt 1: HTTP-Methode, Pfad-, Query- und Headerparameter sowie zulässige Laufzeitüberschreibungen definieren.
2. Schritt 2: API-Schlüssel, Basic Authentication oder OAuth2 über sichere Secret-Referenzen konfigurieren.
3. Schritt 3: Binärdateien ohne ungeeignete Textkonvertierung übertragen und Zielverhalten für vorhandene Dateien festlegen.
4. Schritt 4: Zeitüberschreitung, ungültigen Parameter, nicht erreichbare Quelle und abgelaufenes Token reproduzieren und auswerten.

Modul 4: Access Policies und Contract Policies

Katalogsichtbarkeit und vertragliche Nutzungsbedingungen werden getrennt und testbar modelliert.

1. Schritt 1: Fachliche Regel in Operand, Operator, Wert, Datentyp und Namensraum übersetzen.
2. Schritt 2: Access Policy für Sichtbarkeit und Contract Policy für Vertragsberechtigung separat anlegen.
3. Schritt 3: Teilnehmer-, Gruppen-, Zeit- und Zweckbedingungen mit AND, OR oder XONE kombinieren.
4. Schritt 4: Erlaubte, abgelehnte und unvollständige Identitäten über eine Wahrheitstabelle und technische Tests prüfen.

Modul 5: Contract Definition und Veröffentlichung

Asset und Policies werden zu einem kontrollierten Datenangebot verbunden.

1. Schritt 1: Asset-Selektor oder explizite Asset-Zuordnung mit eindeutigem Geltungsbereich festlegen.
2. Schritt 2: Access- und Contract-Policy korrekt referenzieren und Contract Definition anlegen.
3. Schritt 3: Angebot aus externer Katalogsicht abrufen und unerwartete Assets oder fehlende Metadaten korrigieren.
4. Schritt 4: Probeverhandlung, Testtransfer und Freigabecheckliste als Veröffentlichungsnachweis durchführen.

Praxisübungen

Die Übungen verbinden die einzelnen Konfigurations- und Integrationsschritte zu prüfbaren Arbeitsergebnissen.

• Übung 1: Fachliches Datenprodukt mit stabiler Asset-ID und Versionierungsregel modellieren.
• Übung 2: REST-basierte Datenquelle mit ausgelagertem Geheimnis anlegen.
• Übung 3: Getrennte Access- und Contract-Policies für zwei Teilnehmergruppen aufbauen.
• Übung 4: Angebot extern im Katalog prüfen und eine Probeverhandlung durchführen.

Methodik

Kurze Fachimpulse, Demonstrationen und geführte Schrittfolgen wechseln mit eigenständigen Übungen am System. Die Arbeit erfolgt mit nachvollziehbaren Ausgangszuständen, Prüfkriterien und Negativfällen. Konfigurationen und Testnachweise werden so strukturiert, dass sie in betriebliche Checklisten und interne Standards überführt werden können.