TerminalBasic/openspec/changes/archive/2026-09-05-phase-4-frm/specs/forms-dateiformat/spec.md

Purpose

Das Formulardateiformat legt fest, wie ein Formular samt seiner Steuerelemente und seines Codes als Textdatei abgelegt, wieder gelesen und aus binären Dateien des Vorbilds übernommen wird — die Grundlage dafür, dass Formulare überhaupt gespeichert und ausgetauscht werden können.

ADDED Requirements

Requirement: Aufbau des Textformats

Eine Formulardatei SHALL aus einer VERSION-Zeile, einem Beschreibungsteil und einem Codeteil bestehen. Der Beschreibungsteil SHALL aus verschachtelten Blöcken Begin <Klasse> <Name> … End mit Zeilen Eigenschaft = Wert bestehen; Zeichenketten stehen in Anführungszeichen. Der Codeteil SHALL gewöhnlicher Quelltext des Formularmoduls sein. Die Versionen 1.00 und 2.00 SHALL angenommen werden; eine andere Version MUST mit Nennung der vorgefundenen Version abgewiesen werden.

Scenario: Formular mit einem Steuerelement

• WHEN eine Datei ein Form-Blockelement mit einem eingebetteten CommandButton-Block und anschließendem SUB-Code enthält
• THEN entsteht daraus eine Formularbeschreibung mit einem Steuerelement und dem zugehörigen Quelltext

Scenario: Unbekannte Version

• WHEN die Datei mit VERSION 3.00 beginnt
• THEN wird sie abgewiesen und die Meldung nennt 3.00

Requirement: Schreiben ist die Umkehrung des Lesens

Das Schreiben einer gelesenen Formularbeschreibung SHALL dieselbe Datei ergeben. Geschrieben SHALL nur werden, was vom Vorgabewert abweicht; Reihenfolge und Einrückung SHALL festgelegt und dokumentiert sein, damit zwei Läufe dieselbe Datei erzeugen.

Scenario: Rundlauf

• WHEN eine Formulardatei gelesen und unverändert wieder geschrieben wird
• THEN ist die geschriebene Datei byte-gleich zur gelesenen

Scenario: Vorgabewerte werden nicht geschrieben

• WHEN ein Steuerelement nur Vorgabewerte trägt
• THEN enthält sein Block außer Begin/End keine Eigenschaftszeile

Requirement: Fehlerhafte Dateien werden benannt

Eine unbekannte Klasse, eine für die Klasse unbekannte Eigenschaft, ein Wert außerhalb des Wertebereichs und ein unausgeglichener Block MUST je mit Dateiname, Zeilennummer und dem betroffenen Namen gemeldet werden. Eine solche Datei MUST NOT teilweise übernommen werden.

Scenario: Unbekannte Eigenschaft

• WHEN ein CommandButton-Block die Zeile Farbe = 3 enthält
• THEN nennt die Meldung Datei, Zeile, CommandButton und Farbe

Scenario: Unausgeglichener Block

• WHEN einer Datei ein End fehlt
• THEN nennt die Meldung die Zeile des offenen Begin-Blocks

Requirement: Konvertierung binärer Formulardateien

Ein Unterbefehl SHALL eine binäre Formulardatei des Vorbilds (Kennung FC 08 01 00) in das Textformat übersetzen. Eine nicht erkannte oder beschädigte Datei MUST mit Nennung der Fundstelle abgewiesen werden; eine Teilausgabe MUST NOT entstehen. Der erschlossene Aufbau des Binärformats SHALL dokumentiert sein.

Scenario: Bekannte Beispieldatei

• WHEN eine binäre Beispieldatei konvertiert wird
• THEN entsteht eine Textdatei, deren Lesen dieselbe Formularbeschreibung ergibt wie die dokumentierte Erwartung

Scenario: Fremde Datei

• WHEN eine Datei ohne die Kennung übergeben wird
• THEN bricht der Befehl mit einer Meldung ab und schreibt keine Ausgabedatei