methodatlas
MethodenanleitungKnowledge Modeling

Shape-First Modeling

Die Anleitung zur Methode: Voraussetzungen und Materialien klären, den gesamten Ablauf verstehen und Ergebnisse, Stolperfallen sowie Abbruchkriterien nachschlagen.

KomplexitätMittel
ZeitHalber Tag pro Domain Slice
Teilnehmende1-4
FormatWorkshop + Async
ReifegradEstablished
Shape-first Modeling planen
01

Vorbedingung

Was vorher fertig sein muss

Vorher abschließenBegrenzter Gegenstand

Scope und Zweck von Shape-first Modeling sind als konkrete Frage benannt.

Ohne Scope wird SHACL Shape Suite beliebig.
Vorher abschließenZugang zu relevanten Perspektiven

RDF Use Cases, gültige und ungültige Beispieldaten, Namespace- und Severity Policy und entscheidungsfähige Fachpersonen sind verfügbar.

Ohne diese Perspektiven bleiben zentrale Aussagen in SHACL Shape Suite unbelegt.
02

Vorbereitung

Was vor Start vorliegen muss

Materialien

RDF Use Cases, gültige und ungültige Beispieldaten, Namespace- und Severity Policy, gemeinsame Arbeitsfläche, Quellenlinks und Entscheidungslog.

Personen / Rollen

Domain Expert · RDF Engineer · Data Producer · Consumer

Vorabinfos

RDF Use Cases, gültige und ungültige Beispieldaten, Namespace- und Severity Policy vorab zusammentragen und offene Annahmen markieren.

Zeitbedarf

60–120 Minuten pro Shape-Modul

Setup

Targets, NodeShapes, PropertyShapes und Constraint Components vor breiter Ontologiemodellierung sichtbar vorbereiten und Bewertungsbegriffe vor Beginn kalibrieren.

03

Kernfrage

Die eine Frage, die diese Methode beantwortet

Welche RDF-Struktur muss für den Use Case gelten und wie wird jede Verletzung berichtet?

04

Ablauf

Phasen mit Ziel, Durchführung, Ergebnis und Stolperfalle

SHACL trennt Shapes Graph und Data Graph. NodeShapes wählen Targets; PropertyShapes definieren Pfad, Kardinalität, Datentyp, Klasse und weitere Constraints. Validation erzeugt einen Results Graph.

SHACL Shape Suite

Fiktives Arbeitsbeispiel

Targets, NodeShapes, PropertyShapes und Constraint Components vor breiter Ontologiemodellierung als präzise Arbeitsstruktur mit fiktivem Beispiel.

Target

NodeShape · targetClass/Node

ActionShape targetClass Action.

PropertyShape

path · min/maxCount · datatype/class

owner min=1 max=1; dueDate xsd:date.

Fixture

Positiv · Negativ · Grenze

Action ohne Owner als Negativfall.

Result

focusNode · resultPath · severity · message

A-17, owner, Violation, Owner fehlt.

Das Beispiel zeigt die Fachlogik von Shape-first Modeling; eigene Vorlagen bleiben leer.

W3C Shapes Constraint Language (SHACL)

  1. 1

    Datenvertrag

    Datenvertrag

    Ziel

    Constraint Backlog so erarbeiten, dass die Kernfrage „Welche RDF-Struktur muss für den Use Case gelten und wie wird jede Verletzung berichtet?“ belastbar weiter beantwortet werden kann.

    Voraussetzungen für diesen Schritt

    • RDF Use Cases
    • gültige und ungültige Beispieldaten
    • Namespace- und Severity Policy

    Durchführung

    • Use Case, Target, Muss-/Soll-Regeln und Severity festlegen.
    • Quelle, Begründung und offene Unsicherheit direkt in Constraint Backlog festhalten.

    Ergebnis

    Constraint Backlog

    Constraint Backlog · Quelle · Unsicherheit · nächster Entscheid

    Qualitätscheck

    Ist jede Regel fachlich begründet?

    Stolperfalle

    Shapes übernehmen zufällige Muster aus Beispieldaten, statt fachlich begründete Constraints abzubilden. Use Case und Constraintbegründung dokumentieren, Positiv-/Negativfälle schreiben und Severity bewusst setzen.

    Zeitlicher Rahmen: 10–20 Minuten

  2. 2

    Shapes

    Shapes

    Ziel

    Shapes Graph so erarbeiten, dass die Kernfrage „Welche RDF-Struktur muss für den Use Case gelten und wie wird jede Verletzung berichtet?“ belastbar weiter beantwortet werden kann.

    Voraussetzungen für diesen Schritt

    • Constraint Backlog
    • gültige und ungültige Beispieldaten
    • Namespace- und Severity Policy

    Durchführung

    • NodeShapes und PropertyShapes mit Core Components schreiben.
    • Quelle, Begründung und offene Unsicherheit direkt in Shapes Graph festhalten.

    Ergebnis

    Shapes Graph

    Shapes Graph · Quelle · Unsicherheit · nächster Entscheid

    Qualitätscheck

    Sind Paths, Counts, Datatypes und Klassen korrekt?

    Stolperfalle

    Shapes übernehmen zufällige Muster aus Beispieldaten, statt fachlich begründete Constraints abzubilden. Use Case und Constraintbegründung dokumentieren, Positiv-/Negativfälle schreiben und Severity bewusst setzen.

    Zeitlicher Rahmen: 10–20 Minuten

  3. 3

    Fixtures

    Fixtures

    Ziel

    RDF Fixtures so erarbeiten, dass die Kernfrage „Welche RDF-Struktur muss für den Use Case gelten und wie wird jede Verletzung berichtet?“ belastbar weiter beantwortet werden kann.

    Voraussetzungen für diesen Schritt

    • Shapes Graph
    • gültige und ungültige Beispieldaten
    • Namespace- und Severity Policy

    Durchführung

    • Gültige, ungültige und Grenzfalldaten erstellen.
    • Quelle, Begründung und offene Unsicherheit direkt in RDF Fixtures festhalten.

    Ergebnis

    RDF Fixtures

    RDF Fixtures · Quelle · Unsicherheit · nächster Entscheid

    Qualitätscheck

    Verletzt jeder Negativfall genau die beabsichtigte Regel?

    Stolperfalle

    Shapes übernehmen zufällige Muster aus Beispieldaten, statt fachlich begründete Constraints abzubilden. Use Case und Constraintbegründung dokumentieren, Positiv-/Negativfälle schreiben und Severity bewusst setzen.

    Zeitlicher Rahmen: 10–20 Minuten

  4. 4

    Validierung

    Validierung

    Ziel

    Validation Suite so erarbeiten, dass die Kernfrage „Welche RDF-Struktur muss für den Use Case gelten und wie wird jede Verletzung berichtet?“ belastbar weiter beantwortet werden kann.

    Voraussetzungen für diesen Schritt

    • RDF Fixtures
    • gültige und ungültige Beispieldaten
    • Namespace- und Severity Policy

    Durchführung

    • SHACL Processor ausführen und Results Graph prüfen.
    • Quelle, Begründung und offene Unsicherheit direkt in Validation Suite festhalten.

    Ergebnis

    Validation Suite

    Validation Suite · Quelle · Unsicherheit · nächster Entscheid

    Qualitätscheck

    Enthält jedes Result Focus Node, Path und Constraint?

    Stolperfalle

    Shapes übernehmen zufällige Muster aus Beispieldaten, statt fachlich begründete Constraints abzubilden. Use Case und Constraintbegründung dokumentieren, Positiv-/Negativfälle schreiben und Severity bewusst setzen.

    Zeitlicher Rahmen: 10–20 Minuten

05

Artefakt

Was am Ende rauskommt

Skizze: so sieht das Artefakt aus

Shape-First Modeling · Datenqualität zuerst modellierenKlassen, Pflichtfelder, Datentypen, Beziehungen und Kardinalitäten als ausführbare Shapes definieren und gegen Beispieldaten validieren
Shape-First ModelingDas Visual zeigt Knotenklassen, einen Shape Contract mit Pflichtfeldern, Optionalität, Datentypen und Kardinalitäten sowie Validierung gegen Beispieldaten.Datenverträge vor freier Ontology-Semantik festlegenShape-First Modeling macht Erwartungen an Graphdaten ausführbar, prüfbar und versionierbar.Knotenklassenwichtigste Domain-Slices zuerstShape Contractrequiredname, idoptionaldescriptiondatatypexsd:datecardinality1..n relationsBeispieldatenInstanzen gegen Shapes prüfenValidation ReportFehler, Warnungen undDatenvertragConstraints voroffener SemantikausführbareDokumentationQuality Gate
Form

Versioniertes SHACL Shape Suite mit Datum, Quellen, Ownern und nächstem Review.

Versionierung / Ownership

Datum, Quelle, Annahmenstand und Entscheidung je Fassung von SHACL Shape Suite erhalten.

Tool-Alternativen
  • SHACL Shape Suite als Board oder Dokument
  • Quellen- und Evidenzregister
  • Entscheidungs- und Maßnahmenlog

shape-first-modeling-working-template.md

Plane Shape-first Modeling entlang der fachlichen Schritte und der konkreten Entscheidungsfrage.

Shape-First Modeling: Arbeitsvorlage

Fragestellung

Noch zu klären

Gewünschtes Ergebnis

Noch zu klären

Rahmen

Gesamten Workshop Zeit: 60–120 Minuten pro Shape-Modul

Diese Vorlage während der Arbeit auf Papier oder in einem eigenen Dokument ausfüllen.

Vorbereitung für diesen Umfang

Methodische Grundausstattung

  • Materialien: RDF Use Cases, gültige und ungültige Beispieldaten, Namespace- und Severity Policy, gemeinsame Arbeitsfläche, Quellenlinks und Entscheidungslog.
  • Rollen: Domain Expert · RDF Engineer · Data Producer · Consumer
  • Vorab-Infos: RDF Use Cases, gültige und ungültige Beispieldaten, Namespace- und Severity Policy vorab zusammentragen und offene Annahmen markieren.
  • Gesamter Zeitbedarf: 60–120 Minuten pro Shape-Modul
  • Setup: Targets, NodeShapes, PropertyShapes und Constraint Components vor breiter Ontologiemodellierung sichtbar vorbereiten und Bewertungsbegriffe vor Beginn kalibrieren.

Für die Arbeitsschritte bereitstellen

Datenvertrag: Datenvertrag

  • RDF Use Cases
  • gültige und ungültige Beispieldaten
  • Namespace- und Severity Policy

Shapes: Shapes

  • Constraint Backlog
  • gültige und ungültige Beispieldaten
  • Namespace- und Severity Policy

Fixtures: Fixtures

  • Shapes Graph
  • gültige und ungültige Beispieldaten
  • Namespace- und Severity Policy

Validierung: Validierung

  • RDF Fixtures
  • gültige und ungültige Beispieldaten
  • Namespace- und Severity Policy

SHACL Shape Suite

Target

NodeShape · targetClass/Node

...

PropertyShape

path · min/maxCount · datatype/class

...

Fixture

Positiv · Negativ · Grenze

...

Result

focusNode · resultPath · severity · message

...

Nur reale Angaben, Quellen und Entscheidungen eintragen.

W3C Shapes Constraint Language (SHACL)

Datenvertrag: Datenvertrag

Erwartetes Artefakt: Constraint Backlog

Constraint Backlog · Quelle · Unsicherheit · nächster Entscheid

Eintrag:

...

  • Ist jede Regel fachlich begründet?

Shapes: Shapes

Erwartetes Artefakt: Shapes Graph

Shapes Graph · Quelle · Unsicherheit · nächster Entscheid

Eintrag:

...

  • Sind Paths, Counts, Datatypes und Klassen korrekt?

Fixtures: Fixtures

Erwartetes Artefakt: RDF Fixtures

RDF Fixtures · Quelle · Unsicherheit · nächster Entscheid

Eintrag:

...

  • Verletzt jeder Negativfall genau die beabsichtigte Regel?

Validierung: Validierung

Erwartetes Artefakt: Validation Suite

Validation Suite · Quelle · Unsicherheit · nächster Entscheid

Eintrag:

...

  • Enthält jedes Result Focus Node, Path und Constraint?

Offene Fragen und nächste Schritte

...

Methodenanleitung: https://methodatlas.meierhoff-systems.de/de/methods/shape-first-modeling/run-sheet

06

Beispielausgabe

Konkret gefülltes Szenario, fiktives Beispiel

Fiktives Beispiel zur Orientierung. Die genannten Mengen und Zeiten beschreiben diesen Fall und sind keine allgemeine Vorgabe.

shape-first-modeling-beispiel.md

Konkret gefülltes Szenario, fiktives Beispiel

ex:ActionShape a sh:NodeShape; sh:targetClass ex:Action. PropertyShape für ex:owner mit sh:minCount 1 und sh:maxCount 1; ex:dueDate mit sh:datatype xsd:date. Negativfall ohne Owner erzeugt ValidationResult mit focusNode, resultPath, sourceConstraintComponent und Message.

07

Stolperfallen

Symptome erkennen, gegensteuern

Kurzüberblick, vollständiger Text steht in der jeweiligen Phase im Ablauf

  1. DatenvertragShapes übernehmen zufällige Muster aus Beispieldaten, statt fachlich begründete Constraints abzubilden.In der Phase ansehen
  2. ShapesShapes übernehmen zufällige Muster aus Beispieldaten, statt fachlich begründete Constraints abzubilden.In der Phase ansehen
  3. FixturesShapes übernehmen zufällige Muster aus Beispieldaten, statt fachlich begründete Constraints abzubilden.In der Phase ansehen
  4. ValidierungShapes übernehmen zufällige Muster aus Beispieldaten, statt fachlich begründete Constraints abzubilden.In der Phase ansehen
08

Abbruchkriterien

Wann du anhalten, Voraussetzungen klären oder einen anderen Ansatz wählen solltest

SHACL Shape Suite beantwortet die Kernfrage mit nachvollziehbaren Belegen oder offen markierter Unsicherheit.
Owner, nächste Aktion und Prüftermin sind für offene Punkte benannt.

Methode nach W3C SHACL Community. Kuratiert mit 1 Quellen.

Quellen: W3C Shapes Constraint Language (SHACL)

Ablauf, Timeboxen und Stolperfallen sind redaktionell kuratierte Praxisempfehlungen auf Basis der genannten Quellen.

Wie geht es weiter?

Papierillustration von Ontology Design Patterns mit dem methodenspezifischen Arbeitsmodell.
Knowledge Modeling
Ontology Design Patterns

Prüft, ob validierte Datenstrukturen bestehende Entwurfsmuster erfüllen.

Papierillustration von Linked Open Terms mit dem methodenspezifischen Arbeitsmodell.
Knowledge Modeling
Linked Open Terms

Veröffentlicht die validierten Strukturen als Teil eines offenen Vokabulars.

Im Playbook ansehenKnowledge Modeling vorbereitenVon Wissensdomäne zu Fragen, Konzeptmodell, Schema und Validierungsregeln.

Methodenanleitung durchgearbeitet?

Zum Steckbrief für Zweck, ähnliche Methoden und Quellen oder direkt zur nächsten Methode im Katalog.

Zum SteckbriefWeitere Methoden