Struktur editierbarer Einstellungsdateien, Editieren im allgemeinen Text-Editor

Das Editieren der Dateien kann auch außerhalb des Programmsystems in einem üblichen Text-Editor stattfinden. Änderungen werden in der Projektverwaltung oder im Bauwerk nicht automatisch geladen. Daher sind folgende Vorgehensweisen einzuhalten:

• Zum Editieren der Datei sollte die aufrufende Funktion in der Projektverwaltung oder dem Bauwerk verlassen werden.

• Beim Aufruf der Funktion, die die editierbare Einstellungsdatei verwendet, wird diese auch neu geladen.

• Standard - Funktionen aus Einstellungen verwalten sind nur zu verwenden, wenn die Einstellungsdatei nicht in einem Text-Editor geöffnet ist. Anmerkung: Leider ist es nicht immer möglich festzustellen, dass eine Datei gerade geöffnet ist, da z.B. Notepad++ automatisch nur eine Kopie der Datei öffnet.

Hier sind jegliche Fehleingaben möglich, die durch das Programm nicht abgefangen werden können. Die Datei kann unbenutzbar werden. Deshalb sollten nur versierte Anwender diese Dateien mit einem allgemeinen Text-Editor editieren.

Struktur und Inhalte editierbarer Einstellungsdateien

In editierbaren Einstellungsdateien befinden sich Strukturen und Bereiche, die im Editor verändert werden können und solche, die nicht verändert werden sollten. In vielen dieser Dateien finden sich in entsprechenden Einträgen und Kommentaren Hinweise zu Zweck und Inhalten der Datei.

Wird als Text eine Referenz in der Form #123 (Lattenkreuz mit Nummer) angegeben, so ist das die Referenz auf die Zeilennummer in der Editdsi1.frg.

Die Dateien sind in Datenbereiche, sogenannte sections aufgeteilt. Jede section beginnt mit einem Eintrag in eckigen Klammern und endet mit demselben Eintrag ergänzt um das Wort ENDSEC:

[SECTION NAME]

...

[SECTION NAME ENDSEC]

Innerhalb der section besteht jede Zeile aus Kennwort - Gleichheitszeichen - Wert. Danach kann durch doppelten Schrägstrich abgetrennt ein Kommentar folgen.

Kennwort = Wert

Kennwort = Wert//Kommentar

Struktur-Version der Datei, [VERSION]

Bearbeitbarkeit: Nicht ändern!

In der section VERSION befindet sich die Kennung für die Struktur-Version der Datei. Das Programm benötigt diese Information, um die Datei richtig verarbeiten zu können. Dies ist nicht die Version ihrer Daten. Diese section darf nicht geändert werden.

Beispiel:

[VERSION]

Version=1.1

[VERSION ENDSEC]

Gruppen, [CATEGORY]

Bearbeitbarkeit: Bevorzugt mit Einstellungen verwalten bearbeiten.

Die section CATEGORY enthält die Namen und Reihenfolge der Gruppen. Die Kennwörter enden mit einer Nummer, die der Reihenfolge entspricht. Nach dem Gleichheitszeichen folgt der Name der Gruppe:

Beispiel:

[CATEGORY]

CategoryName1=group abc

CategoryName2=group 123

[CATEGORY ENDSEC]

Informationen zur Datei, [FILE INFO]

Die section FILE INFO enthält Informationen zur Datei und den Daten, die darin definiert werden. Hier befinden sich wertvolle Hinweise zu den Daten und Regeln in der Datei.

Wird als Text eine Referenz in der Form #123 (Lattenkreuz mit Nummer) angegeben, so ist das die Referenz auf die Zeilennummer in der Editdsi1.frg. Im Dialog zum Editieren der editierbaren Einstellungsdateien werden die Texte aus der frg (Sprachdatei) angezeigt.

Den Kennwörtern FileDescription_1 bis FileDescription_5 können bis zu 5 Zeilen Text zugewiesen werden.

Beispiel:

[FILE INFO]

FileDescription_1=Beschreibung der Datei

FileDescription_2=max. 5 lines

FileDescription_3=#123

[FILE INFO ENDSEC]

Information zu den sections, [SECTION INFORMATION]

Bearbeitbarkeit: Information muss für jede section vorhanden sein! Hinweise bei den einzelnen Einträgen beachten!

Alle Einstellungen der Datei enthalten dieselben sections. System-Informationen sind für alle diese sections gleich, unabhängig in welcher Einstellung sie stehen. Deshalb werden diese Informationen in dieser vorgelagerten section festgehalten. Einstellungen müssen nicht alle diese sections enthalten, können aber nur sections enthalten, die hier definiert wurden.

Die section SECTION INFORMATION enthält alle sections, die in den Einstellungen verwendbar sind. Zu jeder section gibt es Informationstexte, den SectionsType und den Verweis auf ein Hilfsbild:

Line1 .. Line5

Bis zu fünf Zeilen Erklärungstext zum Inhalt der section. Hier stehen wertvolle Hinweise für das Editieren der Datei. Wird als Text eine Referenz in der Form #123 (Lattenkreuz mit Nummer) angegeben, so ist das die Referenz auf die Zeilennummer in der Editdsi1.frg. Im Dialog zum Editieren der editierbaren Einstellungsdateien werden die Texte aus der frg (Sprachdatei) angezeigt.

SectionType

Es werden 3 Typen von sections unterschieden: FILTER, FREE, FIX

FILTER Das Kennwort vor dem Gleichheitszeichen beschreibt eine Auswahl von Ausführungen (Wand, Decke, Dachfläche) oder eine Auswahl von Identnummern.

Folgende Auswahlbeschreibungen sind möglich: ABC123 der ganze Name lautet ABC123 ABC* der Name beginnt mit ABC *ABC der Name endet mit ABC *ABC* ABC befindet sich irgendwo im Namen.

In diese section können beliebig viele Einträge gemacht werden. Die übergeordnete Funktion bestimmt ob alle zutreffenden Einträge, nur der erste oder nur der letzte verwendet wird.

FREE Das Kennwort vor dem Gleichheitszeichen kann frei vergeben werden. Das können z.B. Anwendervariablen sein.

In diese section können beliebig viele Einträge gemacht werden.

FIX Die Kennwörter vor dem Gleichheitszeichen und deren Anzahl ist festgelegt. In diesen sections sind die möglichen Kennwörter bereits eingetragen. Es können keine weiteren ergänzt werden. Kennwörter, die nicht verwendet werden, sollten einfach ohne zugewiesenen Wert stehen bleiben.

ReferenceImagePath Verweis auf ein Hilfsbild. Dies wird im Dialog zum Editieren der editierbaren Einstellungsdateien angezeigt.

Beispiel:

[SECTION INFORMATION]

[SECTION A]

Line1=Text for section A

Line2=max. 5 lines

Line3=#123

SectionType=FILTER

ReferenceImagePath=%DHPABB%\GWE___04.bmp

[SECTION A ENDSEC]

[SECTION B]

..

[SECTION B ENDSEC]

..

[SECTION INFORMATION ENDSEC]

Einstellungen, [DATASET EDITDSI]

Die eigentlichen Einstellungen werden in den sections DATASET EDITDSI definiert.

• Für jede Einstellung gibt es eine solche section. Der section Name ist dabei immer gleich, enthält also keine fortlaufende Nummer oder den Namen der Einstellung.

• Die Anzeigereihenfolge der Einstellungen entspricht der Reihenfolge in der Datei.

[DATASET EDITDSI]

...

[DATASET EDITDSI ENDSEC]

[DATASET EDITDSI]

...

[DATASET EDITDSI ENDSEC]

Jede der Einstellungen enthält zuerst die Informationen zu der Einstellung:

Name Der Name der Einstellung mit dem sie in Einstellungen Auswahl angezeigt wird. Die Namen der Einstellungen in einer Datei müssen eindeutig sein; kein Name darf doppelt vergeben werden.

CategoryName Gruppe zu der die Einstellung gehört. Mögliche Gruppen sind in der section CATEGORY aufgeführt.

ReferenceImagePath Verweis auf ein Hilfsbild. Dieses wird in Einstellungen Auswahl angezeigt und kann sehr hilfreich für den Bediener sein.

Die Zuordnung des Hilfsbildes sollte in Einstellungen verwalten geschehen, da hier die möglichen Bezüge in den Pfaden automatisch eingetragen werden.

Danach folgen die eigentlichen Daten-sections. Diese wurden weiter oben in der section [SECTION INFORMATION] definiert.

Der Kommentar zu der Einstellung wird in der letzten section in dieser Einstellung festgehalten: [DATASET EDITDSI MULTILINE_STRING] Mit den Kennwörtern Line1 bis Line5 können bis zu 5 Zeilen Kommentartext angegeben werden. Dieser wird in Einstellungen Auswahl angezeigt und kann sehr hilfreich für den Bediener sein. Der Kommentar kann auch in Einstellungen verwalten eingegeben werden.

Beispiel:

[DATASET EDITDSI]

Name=Dataset one

CategoryName=group abc

ReferenceImagePath=%DHPABB%\DietrichsLogo.png

[SECTION A]

AW*=(WL<12.0[m])//use double slash for commentary

[SECTION A ENDSEC]

[SECTION B]

..

[SECTION B ENDSEC]

..

[DATASET EDITDSI MULTILINE_STRING]

Line1=Text for setting Dataset one

Line2=max. 5 lines

[DATASET EDITDSI MULTILINE_STRING ENDSEC]

[DATASET EDITDSI ENDSEC]

Datenzeilen

Innerhalb der Daten section besteht jede Zeile aus Kennwort - Gleichheitszeichen - Wert. Danach kann durch doppelten Schrägstrich abgetrennt ein Kommentar folgen.

Kennwort = Wert

Kennwort = Wert//Kommentar

Die Möglichkeiten und Bedeutungen für die Kennwörter und Werte ist abhängig von der Funktion, die diese Daten verarbeitet. In der Datei befinden sich dazu entsprechende Hinweise in den sections [FILE INFO] und [SECTION INFORMATION].

Der Kommentar wird bei vorgegebenen Kennwörtern oft für eine Definition des Kennwortes genutzt. Bei selbst definierten Kennwörtern oder Anwendervariablen sollte der Kommentar ebenfalls für eine Beschreibung genutzt werden, da es eine spätere Bearbeitung erheblich erleichtert.