Primitiv-Editor
Der Primitiv-Editor ist der Editor zur Bearbeitung der Datenwerte.
Datenmodell aus Primitiven/Datenwerten
Das Datenmodell einer Komponente (Eingabedaten, Ausgabedaten) wird in TOP-Energy mit Hilfe von sogenannten Primitiven organisiert: Jeder Wert, der mit einem Projekt oder einer Komponente abgespeichert wird, benötigt dafür ein dazugehöriges Primitiv. Ein Primitiv ist ein Datencontainer für einen einfachen Datentyp.
Die einzelnen Bestandteile von Formularseiten sind die Formlets.
Verschiedene Formlettypen stellen unterschiedliche Datenfelder zur Anzeige und Einpflege von Primitiven (Datenwerten) zur Verfügung.
Die Primitive, aus denen das Datenmodell von Modulen, Komponenten, Elementarkomponenten und Konnektoren besteht, repräsentieren
Die meisten Primitive befinden sich in den zugehörigen Elementarys oder Konnektoren.
Auf der obersten Ebene einer Komponentenvorlage gibt es nur wenige Primitive: normalerweise nur die Bundles für jeden Pin der Komponente, die Tooltip-Tabelle zur Beschreibung des Tooltips und ggf. noch die Information, ob die Komponente strukturoptimiert wird oder nicht.
Primitive können zur besseren Übersichtlichkeit in eigene Container (vom Datentyp Bundle) sortiert werden.
Das detaillierte Hinzufügen und Bearbeiten des Datenmodells wird im Kapitel Modellierung eigener Elementarkomponenten beschrieben.
Allgemeine Eigenschaften
Die allgemeinen Eigenschaften werden beim Erstellen eines Primitivs festgelegt und können im Primitiv-Editor (siehe folgende Abbildung) bearbeitet werden.
Die Kategorien der allgemeinen Eigenschaften eines Primitivs sind bei allen Datentypen gleich:
Der Name/die Bezeichnung wird als der Bezeichner auf der linken Seite eines Formlets angezeigt.
Die Definition wird als Tooltip eingeblendet, wenn der Benutzer den Mauszeiger über den Bezeichner hält. Die Bezeichnung und die Definition sollten in Deutsch und Englisch angegeben werden.
Der Identifikator ist ein einmaliger Name, mit dem das Primitiv im Template-Explorer angezeigt wird. Prinzipiell kann der Identifikator frei gewählt werden, er darf nur keine Leerzeichen, Umlaute oder Sonderzeichen und nicht mehr als einen Doppelpunkt enthalten. Üblicherweise besteht der Identifikator aus zwei Teilen, die durch einen Doppelpunkt voneinander getrennt sind. Der erste Teil ist eine Abkürzung für den Datentyp. Diese wird automatisch beim Fertigstellen gesetzt oder kann bereits beim Erstellen des Primitivs eingetragen werden. Der zweite Teil wird automatisch von der Bezeichnung abgeleitet, im Feld angezeigt und kann geändert werden.
Datentypen
Die Datentypen sind zur Speicherung der Daten erforderlich. Ein Datentyp kann verschiedene Visualisierungen durch die Formlets haben.
Es gibt folgende Datentypen:
| Datentyp | Identifikator (1. Teil) | Funktion |
|---|---|---|
| Number | nb: | Gleitkommazahl mit Einheit, auch Zeitreihe |
| Bool | bool: | Zweiwertige Entscheidung: Checkbox |
| Bundle | bndl: | Ordnung von Primitiven |
| Characteristic1D | c1d: | Kennlinie |
| ComponentRef | misc: | Komponentenverweise |
| DateTime | misc: | Kalenderformlet |
| Duration | misc: | Zeitintervallfeld, Minimum, Maximum |
| Excel | tbl: | |
| ExcelButton | method: | |
| Integer | int: | ganze Zahl, auch Zeitreihe |
| Method | method: | Schaltflächen, Methodeditor (z. B. PML) |
| Option | opt: | Auswahlfeld |
| String | str: | Textfeld |
| Table | tbl: | Tabelle |
Die typspezifischen Daten sind die typabhängigen Daten. Details dazu enthält der Artikel über das Anlegen eines Primitivs.
