Zum Inhalt springen
RUMLRUML

Open Format for Digital Law

4.6 Parser-Pflichten

4.6 Parser-Pflichten

Die Pflichten von Parsern und Werkzeugen, die RUML- oder RUML-EXT-Dateien verarbeiten, sind in den Kapiteln definiert, die sie betreffen, und mit Verweisen auf diese Kapitel in Kapitel 8 katalogisiert; die Parser-Pflichten des Capability-Systems stehen in Kapitel 8.7. Dieser Abschnitt ergänzt die Reihenfolge, in der ein Parser eine Datei liest. Diese Reihenfolge ist von außen nicht beobachtbar und hat deshalb keine Regel-ID.

Die Reihenfolge der Capability-Einträge eines Knotens ist in Kapitel 4.3 definiert; an der Root ist sie nicht signifikant.

Frühzeitiges Lesen des capabilities-Arrays

Ein Parser MUSS das capabilities-Array lesen und auswerten, bevor er die rulemap oder andere strukturelle Felder der Datei verarbeitet. Dies sichert das Fail-Fast-Verhalten für required: true-Capabilities.

Empfohlene Parse-Reihenfolge

  1. $format und $specVersion lesen und validieren
  2. capabilities-Array lesen und für jede Capability prüfen, ob sie bekannt ist
  3. Bei unbekannter required: true-Capability: Abbruch
  4. Restliche Felder verarbeiten

Hinweis zu Werkzeug-Implementierungen

Validierungswerkzeuge

Ein Validierungswerkzeug MUSS jede Regel der Ebenen Schema und semantisch in Kapitel 8 prüfen (Regel CAP-28CAP-28 Ein Validierungswerkzeug MUSS jede Regel dieses Katalogs prüfen, deren Ebene schema oder semantic ist.). Ein Werkzeug, das nur die Kernstruktur prüft und das capabilities-System ignoriert, ist kein vollständiger RUML-Validator.