Skip to main content

Hauptfenster

Das Hauptfenster weist im großen Ganzen zwei Menüleisten und eine Liste auf. Die Funktionen werden im Folgenden Abschnitt näher erläutert.

Menüleisten

Die Hauptoberfläche weist eine obere Menüleiste mit fünf Buttons und eine weitere mit zwei Texten auf, die allerdings am unteren Rand des Fensters zu sehen ist.

asje_maingui_barziffern.pngDie wichtigere der beide Leisten ist die obere, da durch diese Menüleiste sämtliche Bedienungen des Programms ermöglicht werden.

Der 1. Button ermöglicht eine appsettings.json in das Programm zu laden. Dadurch wird die darunterliegende Liste mit den Objekten der ausgewählten Json-Datei gefüllt und der Pfad zu dieser Datei in der unteren Menüleiste links angezeigt.

Während Button 2 das aktuell ausgewählte Json-File auf dem gleichen Pfad abspeichert, wo es zuvor aufgerufen wurde, öffnet Button 3 ein Fenster, in dem der Benutzer dazu aufgefordert wird, einen Pfad anzugeben, wo diese Datei abgespeichert werden soll. Durch Button 3 wird auch der Text vom Textfeld 6 angepasst.

Durch Button 4 kann in einem Standardeditor die appsettings.json geöffnet und somit eingesehen werden.

Der 5. Button öffnet eine kleine Übersicht über das Programm und den Entwickler zurück.

Das Textfeld, welches mit der Nummer 6 gekennzeichnet ist, wird erst gefüllt, wenn mithilfe des 1. Buttons eine Datei geladen worden ist. Dieses Textfeld zeigt den Pfad zu dieser Datei an.

Nummer 7 kennzeichnet ein Textfeld, welches auch erst gefüllt wird, wenn eine Datei geladen wird. Dieses Textfeld weist auf den Zeitpunkt des letzten Speicherns der zurzeit geladenen Json-Datei hin. Dieses Feld wird durch das Speichern, das Öffnen des aktuellen Json-Files oder durch das Laden einer neuen appsettings.json geupdatet.

asje_maingui_barziffern.png

TreeList

Die Hauptsteuerung des Programms befindet sich allerdings in der Mitte der Hauptoberfläche: die TreeList. Diese listet nach dem Laden einer Json-Datei den hierarchischen Aufbau der Objekte innerhalb der Datei auf.

Für die Visualisierung und Editierung der Daten werden vier Spalten benötigt.

Die Spalte Nummer 1, auch Key, stellt die Schlüsselwörter der Objekte dar, die das appsettings.json beinhält.

Nicht jedes Objekt weist allerdings einen eindeutig, lesbare Wert auf. Deshalb existieren zwei Spalten für die eindeutige Identifizierung der Werte dieser Objekte: die Spalten Value (2) und Datatype (3).  Einige Zellen beider Spalten können leer sein, da aufgrund der hierarchischen Objektdarstellung in der ersten Spalte nicht jedes Objekt die in Spalte 2 und 3 unterstützten Value-Datentypen aufweisen. Dies wird im späteren Verlauf näher erläutert.

Um die Werte in den Spalten 2 und 3 anzupassen, weisen jene Zellen in der Spalte Edit einen Button auf, der einen Editor öffnet. Auf der Seite Editor kann mehr über diesen gelesen werden.

asje_maingui_treelist_ziffern.png

Im Folgenden wird auf die Interpretation dieser Ansicht eingegangen. 

Nach dem erfolgreichen Laden einer appsettings.json füllt sich die TreeList. Dies kann wie im folgenden Beispiel aussehen:

asje_maingui_treelist_overview.png

Die Hierarchie der Schlüsselwörter (auch Keys) ist ähnlich zu interpretieren wie die einer Ordnerstruktur. Untergeordnete Objekte werden dem Übergeordneten entsprechend weiter rechts eingerückt.

Jede Zelle der Spalte Key weist neben dem Schlüsselwort des Weiteren ein bestimmtes Icon. Dieses Icon passt sich dem Datentyp der Zeile, der in der dritten Spalte einzusehen ist, an. Allerdings existieren davon drei Icons, die anderes bestimmt werden.

Folgende Liste an Icons existieren:

  1. Objekt - Zeigt an, dass dieses Objekt weitere untergeordnete Objekte besitzt. Kann nicht editiert werden. Spalten 2 bis 4 sind leer.
  2. Integer - Zeigt an, dass diese Zeile eine ganze Zahl kleiner 2.147.483.648 als Value und als Datatype Integer aufweist. Die Werte dieser Zeile können mithilfe des Editors editiert werden.
  3. Array - Zeigt an, dass eine Liste an Elementen vorliegt. Die Anzahl an Elementen ist gekennzeichnet durch Zahlen, welche einen Punkt als Suffix aufweist. Diese Zeile kann nicht editiert werden. Spalten 2 bis 4 sind leer.
  4. String - Zeigt an, dass diese Zeile eine Zeichenkette als Value und als Datatype String aufweist. Die Werte dieser Zeile können mithilfe des Editors editiert werden.
  5. Float - Zeigt an, dass diese Zeile eine Dezimalzahl als Value und als Datatype Float aufweist. Die Werte dieser Zeile können mithilfe des Editors editiert werden.
  6. Boolean - Zeigt an, dass diese Zeile die Werte true/false (wahr/falsch) als Value und als Datatype Boolean aufweist. Die Werte dieser Zeile können mithilfe des Editors editiert werden.
  7. DateTime - Zeigt an, dass diese Zeile ein Datum mit Uhrzeit und als Datatype DateTime aufweist. Die Werte dieser Zeile können mithilfe des Editors editiert werden.

Zusätzlich existiert noch ein achtes Icon, welches ein Zahnrad darstellt und die aktuell ausgewählte Zeile angibt.

Des Weiteren können die Zeilen der TreeList zusammengefasst oder ausgefahren werden, indem man auf die Pfeile klickt, die sich links neben den Zellen der Key-Spalte, die weitere untergeordnete Elemente aufweisen, befinden.

Der Button, der mit der Nummer 8 markiert ist, taucht nur in jenen Zeilen auf, deren Werte geändert werden können. Das sind Zeilen, die Werte in den Spalten Value und Datatype stehen haben. Mit diesem Button lässt sich eine kleine Oberfläche öffnen, die es ermöglicht Werte anzupassen. Mehr dazu kann auf der Seite Editor gelesen werden.