Wertzuordnungen

Eine Wertzuordnung (Value map/Map) übersetzt eine Eingabe in eine benannte Menge typisierter Ausgaben. Beispielsweise kann ein Zustand zu einer Beschriftung, Schweregradzahl, Verfügbarkeitskennzeichnung, Farbe, Asset-Referenz und optionalem Vorlagenquelltext aufgelöst werden. Der Aufrufer entscheidet über die Verwendung dieser Werte.

Maps sind allgemeine Layoutdaten. Regelvergleich und Rohwertauflösung sind unabhängig vom Rendern einer Liste. Der List-Baustein ist derzeit der einzige Elementverbraucher. Andere Elemente haben noch keine Map-Konfiguration; das Definieren einer Map aktiviert keine Sichtbarkeits-, Bild-, Schaltflächen- oder Schreibaktionsbindung.

Zu den Abbildungen: Die Aufnahmen zeigen die aktuelle Oberfläche mit deutscher Spracheinstellung und ungespeicherten Beispielkonfigurationen. Noch nicht im installierten Katalog übersetzte Beschriftungen, etwa Test map oder Where used, erscheinen mit ihrer englischen Ersatzbeschriftung. Schlüssel, Daten und Quelltext entsprechen den Beispielen.

Grundlagen

Begriff	Aufgabe
Map-Name	Identifiziert eine Map innerhalb ihres Layouts.
Ausgabedefinitionen	Legen die regelübergreifend verfügbaren Schlüssel und Typen fest.
Geordnete Regeln	Wählen Werte über Equals oder Range aus. Die erste passende Regel gewinnt.
Optionaler Fallback	Liefert Werte nur, wenn keine Regel passt.
Verbraucher	Wählt Eingabe und Ausgabeschlüssel sowie die Verwendung des Ergebnisses.
Vorlagenfragment	Erweiterte Zeichenkettenausgabe, die ein Vorlagenverbraucher ausdrücklich rendert.

Namen und Schlüssel sind groß-/kleinschreibungsabhängig und werden selbst gewählt. Namen wie icon, colour oder class lösen kein Verhalten aus. Eine Map allein ergänzt keine sichtbaren Inhalte, verändert kein Element und schreibt keine Variable.

Maps gehören zu einem Layout, gemeinsam mit dessen Bausteinen. Listen desselben Layouts können sie gemeinsam nutzen. Ein separat eingebettetes Baustein-/Dashboardlayout besitzt eigene Definitionen; es gibt keine globale Map-Bibliothek. Die Bearbeitung eines Layouts ändert keine Map-Ziele in einem anderen gespeicherten Layout.

Die List-Integration beschreibt Elementvorlagen und Hilfsfunktionen. Nachvollziehbare Konfigurationen stehen in den Listenbeispielen. Die technische Referenz behandelt Schema und APIs.

Map anlegen und pflegen

1. Öffne den Vorlagen-/Layouteditor und dessen Tab Wertzuordnungen.
2. Verwende Map hinzufügen und wähle einen eindeutigen, aussagekräftigen Namen wie StateAppearance oder TemperatureBand.
3. Ergänze Ausgabedefinitionen mit jeweils eindeutigem Schlüssel und Werttyp. Für gewöhnliche Zeichenketten kann eine Texteingabehilfe gewählt werden.
4. Ergänze Regeln in Prioritätsreihenfolge. Wähle eine Regel in der Übersicht und bearbeite Bedingung und Werte im Detailbereich. Bei schmalen Fenstern steht dieser unter der Übersicht.
5. Setze Werte nur dort, wo sie benötigt werden. Nicht gesetzt entfernt den Schlüssel aus der Regel, nicht seine Ausgabedefinition.
6. Ergänze einen Fallback, falls nicht passende Eingaben ein Ergebnis benötigen.
7. Prüfe Map testen, Warnungen und Verwendung. Speichere danach die umschließende Vorlage/das Dashboard über den normalen Editorablauf.

Die neutrale Map-Auswahl wählt eine bestehende Map. Die Stiftschaltfläche bearbeitet deren Namen direkt; Enter übernimmt die Umbenennung, Esc verwirft sie. Map hinzufügen und Map entfernen betreffen Maps, nicht einzelne Regeln.

Regelkarten fassen Bedingung und konfigurierte Werte zusammen. Symbole, Bibliothekssymbole, Assets und Fragmente können Vorschauen haben; diese sind Darstellungshilfen und keine weiteren gespeicherten Ausgaben. Helle Symbole erhalten einen Kontrastschatten in der Vorschau, ohne ihre konfigurierte Farbe zu ändern.

StateAppearance legt Schlüssel und Typen einmal fest. Symbolschrift und Farbe sind Texteingabehilfen; content verwendet die erweiterte Vorlage im HTML-Modus.

Reihenfolge und Duplizieren

Ziehe Regeln an ihrem Griff zum Sortieren. Bei fokussiertem Griff verschieben Pfeil nach oben/unten die Regel innerhalb der Liste. Bei überlappenden Bedingungen ist die Reihenfolge entscheidend.

Regel duplizieren fügt eine unabhängige Kopie direkt nach der ausgewählten Regel ein und wählt sie aus. Werte, Fragmentquelltext und Asset-Referenzen bleiben erhalten. Änderungen an der Kopie verändern das Original nicht. Prüfe die kopierte Bedingung: Eine unveränderte Kopie kann unerreichbar sein, weil das Original zuerst gewinnt. Der Fallback ist keine gewöhnliche Vergleichsregel und wird so nicht dupliziert.

Ausgabetypen

Der Editor bietet vier gewöhnliche Typen und Vorlage (erweitert) mit Modus Text oder HTML. Das gespeicherte Schema verwendet sechs entsprechende Typkennungen.

Editortyp	Gespeicherter Typ	Gespeicherter Wert	Typische Verwendung
Text	text	Zeichenkette, auch leer	Beschriftung, Farbe, Symbolname, Bibliotheksschlüssel oder CSS-Klassentoken.
Zahl	number	Endliche Zahl	Schweregrad, Anzahl, Schwelle oder Übergabe an number.
Wahrheitswert	boolean	true oder false	Typisierte Kennzeichnung für Bedingungen.
Asset-Referenz	asset	Asset-ID als Zeichenkette	Erfasste Bildreferenz für asset.
Vorlage, Textmodus	textTemplate	Handlebars-Quelltext als Zeichenkette	Aus dem Aufrufkontext berechneter Text.
Vorlage, HTML-Modus	htmlTemplate	HTML-/Handlebars-Quelltext als Zeichenkette	Selbst verfasstes Markup, ausdrücklich durch renderMap gerendert.

Objekte, Arrays, null und undefined sind keine gespeicherten Ausgabewerte. Ein fehlender Wert wird durch Weglassen des Schlüssels im Wertdatensatz einer Regel dargestellt. Verwende mehrere benannte Ausgaben, wenn ein Verbraucher mehrere skalare Werte benötigt.

Texteingabehilfen

Plain, Symbol, Bibliothekssymbol und Farbe sind alternative Editoren einer Textausgabe. Sie erzeugen keine zusätzlichen Laufzeittypen. Symbol-/Bibliothekspicker und die gemeinsame Farbauswahl helfen beim Eingeben einer Zeichenkette; der Verbraucher wählt weiterhin ausdrücklich icon, poolIcon, CSS oder eine andere Interpretation.

Zahlenfelder speichern Zahlen statt numerischer Zeichenketten. Wahrheitswertfelder unterscheiden Nicht gesetzt, Wahr und Falsch. Asset-Felder verwenden die vorhandene Auswahl-/Uploadfunktion; das Zuweisen schließt den Picker.

Ein Typwechsel wandelt bestehende Werte nicht um. Wird eine Textausgabe mit "2" zu Zahl geändert, bleibt sie ungültig, bis eine numerische 2 eingegeben oder der Wert entfernt wird. Nicht-Textdefinitionen dürfen keine Texteingabehilfen enthalten. Korrigiere ungültige Regel-/Fallback-Werte vor dem Speichern.

Lückenhafte Werte und Fallback

Diese Zustände unterscheiden sich:

Regelwert	Bedeutung
Schlüssel fehlt	Nicht gesetzt; Abruf liefert undefined.
""	Gesetzter Textwert ohne Zeichen.
0	Gesetzter Zahlenwert.
false	Gesetzter Wahrheitswert.

Der Fallback ist ein alternatives vollständiges Ergebnis, keine Menge von Standardwerten für jede Regel. Passt eine Regel ohne thumbnail, bleibt thumbnail nicht gesetzt, auch wenn der Fallback es enthält. Setze den Wert für diese Regel ausdrücklich oder ergänze bewusst ein Ersatzverhalten beim Verbraucher.

Ein Wahrheitswerttest reicht nicht allgemein zur Prüfung, ob ein Wert gesetzt ist: false und 0 sind echte Werte. Siehe das Beispiel für typisierte Werte.

Regelvergleich

Regeln werden von oben nach unten ausgewertet; der erste Treffer bestimmt alle Ausgabewerte. Passt keine Regel, wird der optionale Fallback ausgewählt. Ohne Treffer oder Fallback gibt es kein Ergebnis.

Equals

Equals vergleicht String(input) exakt und unter Beachtung der Groß-/Kleinschreibung mit dem konfigurierten Text. Leerraum wird nicht entfernt. Typische Eingaben sind Zeichenketten, Zahlen und Wahrheitswerte: true passt zum Text true, die Zahl 0 zum Text 0. Started und started unterscheiden sich.

Null und undefined passen nie zu Equals, auch nicht zu einer Regel mit dem wörtlichen Inhalt null oder undefined. Sie verwenden nur den Fallback. Die Zeichenketten "null" und "undefined" bleiben gewöhnlicher Text und können passen. Equals ist ein Vergleich der Zeichenkettendarstellung, keine typisierte strikte Gleichheitsbedingung. Zahl-/Wahrheitswertausgaben erhalten den Typ im Ergebnis.

Range

Range akzeptiert eine endliche Zahl oder eine nicht leere Zeichenkette, die in eine endliche Zahl umgewandelt werden kann. Leerer Text, Wahrheitswerte, null, undefined und nicht numerische Werte passen nicht. Numerische Zeichenketten dürfen umgebenden Leerraum haben.

Beide Grenzen sind standardmäßig einschließlich. Exklusiv schließt den jeweiligen Endpunkt aus. Eine fehlende untere/obere Grenze ist in dieser Richtung offen. Ohne beide Grenzen werden alle gültigen numerischen Eingaben akzeptiert.

Konfiguration	Akzeptierter Bereich
Von 8, Bis 25	8 ≤ input ≤ 25
Von 8, Bis 25 exklusiv	8 ≤ input < 25
Bis 8 exklusiv, kein Von	input < 8
Von 25, kein Bis	input ≥ 25

Verwende benachbarte exklusive/inklusive Endpunkte, um versehentlich gemeinsame Grenzen zu vermeiden. Bei bewussten Überschneidungen steht die höher priorisierte Regel zuerst. Siehe durchgängige Zahlenbereiche.

TemperatureBand mit ausgewählter mittlerer Regel: Von ist einschließlich, Bis ausschließlich. Die Übersicht zeigt die drei anschließenden Bereiche und den Fallback.

Warnungen und ungültige Daten

Der Editor warnt vor unmöglichen/leeren Bereichen, doppelten Equals-Regeln und vollständig durch frühere Regeln verdeckten Regeln. Frühere Bereiche können gemeinsam einen späteren Bereich abdecken. Ein-/Ausschluss der Endpunkte wird berücksichtigt; eine verbleibende Punktlücke ist relevant.

Dies sind beratende Vergleichsdiagnosen. Bewusste Überlappungen sind zulässig; teilweise Überschneidungen werden nicht abgelehnt. Ungültige Daten wie nicht endliche Grenzen, nicht deklarierte Ausgabeschlüssel oder falsche Werttypen müssen korrigiert werden. Warnungen ändern keine Auswertungsreihenfolge und wählen keine andere Regel.

Map testen

Map testen ist ein einzelner zugeklappter Bereich der ausgewählten Map. Er prüft den Regelvergleich unabhängig von der gerade bearbeiteten Regel. Wähle den Eingabetyp:

Modus	Testeingabe
Text	Exakter Text, auch eine leere Zeichenkette.
Zahl	Endlicher Zahlenwert. Leer/ungültig ist ein Fehler und wird nicht als 0 ausgewertet.
Wahrheitswert	Wahr oder Falsch.
Kein Wert	Undefined; entspricht dem auch für null/fehlende Eingaben geltenden ausschließlichen Fallback-Verhalten.

Das Ergebnis nennt die passende Regel oder den Fallback und zeigt Typ und Rohwert jeder deklarierten Ausgabe. Nicht gesetzt, false, 0 und leerer Text werden unterschieden. Vorlagenausgaben zeigen Quelltext, ohne ihn zu rendern. Der Link zur passenden Regel/zum Fallback öffnet den jeweiligen Editorbereich. Testen und Navigation verändern keine verfassten Map-Daten und schreiben keine Laufzeitwerte.

Prüfe hier Priorität, numerische Grenzen und fehlende Eingaben. Dieser Bereich rendert kein HTML und bestimmt nicht, wie ein Element einen Wert verwendet.

Capabilities mit der Texteingabe idle. Die Rohwerttabelle unterscheidet false, 0 und leeren Text.

Fragmentvorschau

Die Vorschau unter einer Text-/HTML-Vorlagenausgabe beantwortet: Was rendert das Fragment dieser ausgewählten Regel mit diesem Kontext? Sie verwendet bewusst die bearbeitete Regel/den Fallback, statt anhand der Vorschau-Eingabe eine andere Regel auszuwählen.

Einstellung	Liefert
Eingabewert (@value)	Kontextvariable des zugeordneten Eingabewerts.
Eintrag für Vorschau	Als this verwendeter Eintrag/Kontext; der oberste Wert ist als @root verfügbar.
Ausgewählte Regel/Fallback	Rohe Geschwisterwerte für @outputs.

Eine andere Eingabe kann Inhalte ändern, die @value lesen; sie wechselt nicht die bearbeitete Regel. Aufrufe derselben Map innerhalb dieser Vorschau verwenden ebenfalls die Werte der ausgewählten Regel. Prüfe über Map testen, welche Regel eine echte Eingabe auswählt. Eine Listeneintragsvorschau verwendet den normalen Vergleichsweg.

Die Vorschau zeigt gerenderten Inhalt, Zeilenklassen und Laufzeitdiagnosen. Ein Fragment mit ausschließlich row-Metadaten hat keinen sichtbaren Inhalt; prüfe die gemeldeten Klassen. Ein weißes Symbol benötigt gegebenenfalls den Vorschaukontrastschatten oder einen anderen tatsächlichen Hintergrund.

Fragmentkontext und Modi erläutert Maskierung, verschachtelte Aufrufe und Fehler.

Die ausgewählte error-Regel rendert ihr Warnsymbol. Eingabewert und Vorschaueintrag sind getrennte Kontexteinstellungen; Map testen prüft dagegen die Regelauswahl.

Verwendung, Umbenennen und Entfernen

Verwendung listet Referenzen im aktuellen Layout und kann nach Ausgabe filtern. Einträge nennen Element/Eigenschaft oder Map-Ausgabe und Regel/Fallback, soweit verfügbar mit Quelltextzeile. Die aktuellen Anbieter erfassen List-Elementvorlagen und Vorlagenausgaben in Maps.

Wörtliche Map-/Ausgabenamen können aufgelöst werden. Berechnete Namen/Schlüssel und nicht parsebare Vorlagen erscheinen als mögliche Verwendungen mit ausdrücklich ungeklärtem Status. Der Editor errät ihr Ziel nicht. Die Übersicht gilt für das Layout und durchsucht nicht alle Dashboards im System.

Das Umbenennen einer eindeutigen Map/eines Schlüssels aktualisiert nachweisbare wörtliche Referenzen. Ausgabenumbenennungen verschieben außerdem gespeicherte Regel-/Fallback-Werte und aktualisieren @outputs-/wörtliche lookup-Zugriffe der eigenen Map. Dynamische oder mehrdeutige Referenzen erfordern manuelle Prüfung; Warnungen nennen nicht sicher nachführbare Fälle.

Prüfe vor dem Entfernen einer Ausgabe deren Verbraucher. Entfernen löscht Definition und Werte aus allen Regeln/dem Fallback. Das Entfernen einer Map löscht diese Map. Verbraucherquelltext wird nicht automatisch entfernt; verbleibende Aufrufe können leer werden oder eine fehlende Referenz melden. Nicht gesetzt betrifft nur den Wert einer Regel; Definition und Verbraucher bleiben erhalten.

Verwendungen von StateAppearance: die Events-Elementvorlage und jedes gespeicherte content-Fragment einschließlich Fallback, jeweils mit Ausgabeschlüsseln und Quelltextzeilen.

Assets, Export und Import

Eine Asset-Referenz-Ausgabe ist eine strukturierte Medienreferenz. Jede nicht leere Asset-ID in einer gespeicherten Regel/im Fallback zählt als in Verwendung, unabhängig vom aktuellen Treffer. Der Server ermittelt Verwendungen in gespeicherten Bausteinvorlagen, Dashboardvorlagen und in Seitenpanels eingebetteten Layouts.

Verwende im Fragment {{asset @outputs.thumbnail}} für eine Asset-Ausgabe namens thumbnail. Die Hilfe kann eine vorhandene Asset-Ausgabe wählen oder über Asset-Ausgabe hinzufügen eine Ausgabe mit ausgewähltem/hochgeladenem Asset ergänzen. Der Name thumbnail ist eine Konvention und nicht vorgeschrieben.

Folgende Angaben schützen ein Asset nicht vor dem Löschen:

• Eine ID/ein Titel ausschließlich im Vorlagenquelltext, auch als wörtlicher asset-Aufruf.
• Eine ID aus Laufzeitdaten eines Eintrags.
• Eine Textausgabe, deren Zeichenkette zufällig einer Asset-ID entspricht.
• Eine noch nicht gespeicherte Änderung, die das gespeicherte Dokument nicht erreicht hat.

Das Entfernen und Speichern der letzten strukturierten Referenz gibt das Asset frei. Ein noch verwendetes Asset kann nicht gelöscht werden. Ein fehlendes oder gelöschtes nicht erfasstes Asset ergibt kein Bild.

Übertragbarkeit

Vorlagen-/Dashboardexporte leeren strukturierte Asset-Ausgabe-IDs und Bild-/Draggable-Referenzen in jedem enthaltenen Layout. Ausgabedefinitionen, Regeln, Fragmentquelltext, gewöhnlicher Text, Symbol-/Bibliotheksschlüssel, false und 0 bleiben erhalten. Der Export bearbeitet eine Kopie; die gespeicherte Quelle bleibt unverändert. Der private Server-Verwendungsindex wird nicht exportiert.

Weise nach dem Import Assets des Zielsystems über den Picker zu und speichere. Nur im Quelltext enthaltene feste IDs/Titel bleiben als Quelltext erhalten und müssen gesondert geprüft werden; sie sind im Ziel möglicherweise nicht auflösbar. Bibliotheksschlüssel bleiben ebenfalls erhalten und benötigen die passende Zielbibliothek. Importe prüfen die aktuelle Map-Struktur und Vorlagensyntax vor der Übernahme in die Arbeitskopie.

Fehlersuche

Symptom	Prüfung
Eine Regel gewinnt nie	Frühere Regeln, Duplikate und vollständig abgedeckte Bereiche prüfen; mit Map testen bestätigen.
Null passt nicht zum Text null	Kein Wert wählen und Fallback definieren; Text null ist eine andere Eingabe.
Nach einem Treffer fehlt eine Fallback-Ausgabe	Lückenhafte passende Regeln erben keine Fallback-Schlüssel.
Quelltext erscheint wörtlich	renderMap für Vorlagenausgaben verwenden; map liefert bewusst Quelltext.
Das Fragment bleibt trotz anderer Eingabe bei derselben Regel	Die Fragmentvorschau verwendet die ausgewählte Regel. Map testen prüft die Auswahl.
Farbe/Symbol hat keine Wirkung	Texteingabehilfen unterstützen die Eingabe. Passenden Helfer aufrufen/Wert in Markup verwenden.
Eine Zeilenklasse ist ungültig	Tokens, Präfix und fehlende Werte prüfen; lückenhafte Ergebnisse absichern.
Ein Typwechsel verhindert Speichern	Alte Werte korrigieren/entfernen; es findet keine automatische Umwandlung statt.
Ein Asset bleibt löschbar	Typisierte Asset-Referenz speichern; Quelltext-/Laufzeitreferenzen werden nicht erfasst.
Umbenennen hinterlässt Warnungen	Berechnete Referenzen oder Syntaxfehler manuell prüfen.

Maps speichern ihren Namen, Ausgabedefinitionen, Regeln und optionalen Fallback direkt, ohne Versionsfeld.