Erweiterte Formatierung

Sie können Arcade-Ausdrücke zur erweiterten Formatierung der Listen- und Indikator-Elemente verwenden, um das Rendern der Datenpunkte anzupassen. Ein Datenpunkt kann je nachdem, wie das Element konfiguriert ist, entweder ein Feature oder eine Summenstatistik (Anzahl, Durchschnitt, Minimum, Maximum, Summe oder Standardabweichung) darstellen. Bei Verwendung von Features stellt ein einzelner Datenpunkt ein einzelnes Feature dar. Bei Verwendung einer Statistik stellt jeder Datenpunkt das Ergebnis dieser Statistik dar. Das Listenelement rendert Feature-Datenpunkte als Zeilenelemente, wobei jede Zeile für einen Datenpunkt steht. Das Indikator-Element rendert einen Datenpunkt nach dem anderen.

Anders als es bei Attributausdrücken (die in Layer-Pop-ups, -Styles und -Beschriftungen verwendet werden) der Fall ist, wird für jedes Element ein einzelner Ausdruck erstellt. Der Ausdruck wird für jeden Datenpunkt ausgeführt und zeigt systemdefinierte und benutzerdefinierte Eigenschaften des betreffenden Elements an. Systemdefinierte Eigenschaften sind die Einstellungen, die Sie ansonsten für ein Element konfigurieren würden, wie z. B. die Text- und Hintergrundfarbe. Benutzerdefinierte Eigenschaften werden vom Benutzer in dem Ausdruck definiert und können beim Konfigurieren des Elements referenziert werden.

Hinweis:

In Webkarten erstellte Attributausdrücke werden nicht zur Verwendung in Dashboard-Elementen übernommen.

In der folgenden Tabelle ist zusammengefasst, welche Daten aus einem Layer in den Ausdruck übergeben werden.

Variablenname	Typ	Beschreibung
$datapoint	Feature oder Wörterbuch	Gilt für den Indikator und die Liste
$reference	Wörterbuch	Gilt für den Indikator

Hinweis:

Beim Schreiben von Arcade-Ausdrücken sind die folgenden Hinweise zu beachten:

• Fügen Sie nach jeder Eigenschaft in einem Wörterbuch ein Komma hinzu, außer bei der letzten Eigenschaft.
• Attributnamen dürfen keine Leerzeichen oder Sonderzeichen enthalten.

Erweiterte Formatierung in einer Liste

Für das Listenelement können Sie Arcade-Ausdrücke verwenden, indem Sie die Option Erweiterte Formatierung aktivieren. Sobald Sie sich entschieden haben, die erweiterte Formatierung zu verwenden, sind die Eingaben für die Farbe und sonstige systemdefinierte Eigenschaften nicht mehr verfügbar.

Mithilfe des Ausdrucks, der für jedes Zeilenelement ausgeführt wird, wird definiert, wie jede Zeile in Ihrer Liste verwendet wird. Darüber hinaus kann ein Ausdruck zum Erstellen neuer Attribute verwendet werden, die in der Vorlage für das Zeilenelement referenziert werden können.

Datenpunktattribute können mithilfe der globalen Variablen $datapoint im Arcade-Editor referenziert werden. Die folgende Tabelle enthält eine Liste der Eigenschaften, die von dem Ausdruck in Form eines Wörterbuchs zurückgegeben werden können.

Eigenschaft	Wertetyp	Beschreibung
textColor	Zeichenfolge	Basistextfarbe des Zeilenelements
backgroundColor	Zeichenfolge	Hintergrundfarbe des Zeilenelements
separatorColor	Zeichenfolge	Farbe des unteren Rahmens des Zeilenelements
selectionTextColor	Zeichenfolge	Bei Auswahl des Elements für den Linienelementtext verwendete Farbe
selectionColor	Zeichenfolge	Bei Auswahl des Elements verwendete Basistextfarbe
Attribute	Wörterbuch	Ein Wörterbuch mit Attributwertpaaren
yourAttributeName	Zeichenfolge, Ziffer, Datum, boolescher Wert	Attribut, das in der Zeilenelementvorlage mithilfe der {expression/yourAttributeName}-Syntax referenziert werden kann

Hinweis:

Geometriefunktionen werden nicht unterstützt.

Wenn Sie beispielsweise möchten, dass die Hintergrundfarbe der Liste rot wird, wenn der Wert einen bestimmten Schwellenwert überschritten hat, können Sie eine Variable erstellen, die wie folgt aussieht:

var color = IIF($datapoint.[field]>[threshold], '#F3DED7','')

In dieser Variablen ist [field] das Feld für Ihre Werte, während [threshold] der Wert ist, bei dem sich die Hintergrundfarbe ändern soll. Die Variable kann als Eigenschaftswert verwendet werden, wie etwa in dem folgenden Beispiel:

backgroundColor: color,

Wenn Sie diese Variable in der Hintergrundfarbeigenschaft verwenden, erhalten Sie einen Ausdruck, der wie folgt aussieht, wobei die Hintergrundfarbe des Listenelements rot wird, wenn der Geschwindigkeitswert über 40 liegt:

Verwenden der erweiterten Formatierung in einer Liste

Gehen Sie wie folgt vor, um Formatierungsausdrücke in einem Listenelement zu verwenden:

1. Klicken Sie im Konfigurationsmenü des Elements auf die Registerkarte Liste.
2. Klicken Sie im Abschnitt Erweiterte Formatierung auf Aktivieren.

   Hinweis:

   Sobald die erweiterte Formatierung aktiviert ist, sind die Eingaben für die Farbe nicht mehr verfügbar und werden stattdessen in dem Ausdruck festgelegt. Wenn Sie die Farben festlegen, bevor Sie die erweiterte Formatierung aktivieren, werden sie dem Ausdruck automatisch hinzugefügt.

3. Erstellen Sie Ihren Formatierungsausdruck im Editor.

Tipp:

Wenn Sie Hilfe zu einer der Arcade-Funktionen benötigen, klicken Sie neben der jeweiligen Funktion auf die Informationsschaltfläche, um weitere Details anzuzeigen.
4. Wenn Sie möchten, dass der Ausdruck in einem bestimmten Intervall ausgeführt wird, z. B. wenn der Ausdruck die Funktion now() verwendet, aktivieren Sie die Umschaltfläche Skript aktualisieren und legen ein Aktualisierungsintervall fest.
5. Geben Sie in Vorlage für Zeilenelement neue Attribute ein, die die {expression/yourAttributeName}-Syntax verwenden.

Erweiterte Formatierung in einem Indikator

Für das Indikator-Element können Sie Arcade-Ausdrücke verwenden, indem Sie die Option Erweiterte Formatierung aktivieren. Sobald Sie sich entschieden haben, die erweiterte Formatierung zu aktivieren, sind die systemdefinierten Eigenschaften, wie z. B. die Farboptionen und die Wertformatierung, nicht mehr verfügbar, und die bedingte Formatierung wird deaktiviert. Der Ausdruck dient zum Definieren der Rendering-Eigenschaften und der Bedingungslogik. Zudem kann ein Ausdruck benutzerdefinierte Attribute enthalten, die in den Feldern Titel und Beschreibung auf der Registerkarte Allgemein referenziert werden.

Wenn Sie einen Referenzwert in den Indikator einbeziehen, ist auf der Registerkarte Daten, sobald die erweiterte Formatierung aktiviert ist, nur ein statistikbasierter Referenztyp verfügbar. Wenn Sie zuvor einen Referenztyp mit einem festgelegten Wert definiert haben, wird er dem Ausdruck gemeinsam mit etwaigen Konvertierungsfaktoren und Text- und Farbformatierungen automatisch hinzugefügt. Die Formatierung von Werten, die vor Aktivierung der erweiterten Formatierung erfolgt ist, wird entfernt und muss mithilfe von Wertmustern in dem Ausdruck definiert werden.

Hinweis:

Ein vorheriger Wert wird in Arcade nicht unterstützt. Wenn Sie als Referenztyp einen vorherigen Wert festgelegt haben, bevor Sie die erweiterte Formatierung aktiviert haben, wird er in den aktuellen Wert konvertiert.

Datenpunktattribute können mithilfe der globalen Variablen $datapoint im Arcade-Editor referenziert werden. Je nachdem, ob der Wertetyp "Feature" oder "Statistik" lautet, ist $datapoint vom Typ "Feature" bzw. "Wörterbuch". Wenn auf der Registerkarte Daten eine Referenzstatistik konfiguriert wurde, ist auch die globale $reference-Variable im Editor verfügbar.

Die folgende Tabelle enthält eine Liste der Eigenschaften, die von dem Ausdruck in Form eines Wörterbuchs zurückgegeben werden können.

Eigenschaft	Wertetyp	Beschreibung
textColor	Zeichenfolge	Basistextfarbe des Indikatorelements
backgroundColor	Zeichenfolge	Hintergrundfarbe des Indikatorelements
topText	Zeichenfolge	Anzeige als Text oben
topTextColor	Zeichenfolge	Farbe des Textes oben
topTextOutlineColor	Zeichenfolge	Farbe des Rahmens des Textes oben
topTextMaxSize	Zeichenfolge	Maximale Größe des Textes oben (sehr, sehr klein | sehr klein | klein | mittel | groß | sehr groß | sehr, sehr groß)
middleText	Zeichenfolge	Anzeige als mittlerer Text
middleTextColor	Zeichenfolge	Farbe des mittleren Textes
middleTextOutlineColor	Zeichenfolge	Farbe des Rahmens des mittleren Textes
middleTextMaxSize	Zeichenfolge	Maximale Größe des Textes oben (sehr, sehr klein | sehr klein | klein | mittel | groß | sehr groß | sehr, sehr groß)
bottomText	Zeichenfolge	Anzeige als Text unten
bottomTextColor	Zeichenfolge	Farbe des Textes unten
bottomTextOutlineColor	Zeichenfolge	Farbe des Rahmens des Textes unten
bottomTextMaxSize	Zeichenfolge	Maximale Größe des Textes oben (sehr, sehr klein | sehr klein | klein | mittel | groß | sehr groß | sehr, sehr groß)
iconName	Zeichenfolge	Name des für den Indikator definierten Symbols
iconAlign	Zeichenfolge	Platzierung des Symbols neben dem mittleren Text (links | rechts)
iconColor	Zeichenfolge	Füllfarbe des Symbols
iconOutlineColor	Zeichenfolge	Rahmenfarbe des Symbols
noValue	Boolean	Kennzeichnung, um Text ohne Wert anstelle des Indikators (true | false) anzuzeigen
Attribute	Wörterbuch	Ein Wörterbuch mit Attributwertpaaren
yourAttributeName	Zeichenfolge, Zahl, Datum, boolescher Wert	Attribute, die in den Feldern Titel und Beschreibung mithilfe der {expression/yourAttributeName}-Syntax referenziert werden können

Wenn Sie beispielsweise einen Indikator haben, der einen Wert in einer Maßeinheit aufweist, denselben Wert aber auch in einer weiteren Einheit darunter anzeigen möchten, können Sie eine Variable erstellen, um Ihre vorhandenen Werte zu konvertieren. Mit einem Indikator, der die Durchschnittstemperatur in Grad Celsius anzeigt, können Sie zur Verwendung in Ihrem Ausdruck eine Fahrenheit-Variable erstellen, damit Ihre Werte auch in Grad Fahrenheit angezeigt werden.

var fahrenheit = Floor(($datapoint["avg_Temperature"]/5*9)+32)

Anschließend können Sie die Variable z. B. wie folgt als Eigenschaftswert einbeziehen:

bottomText: fahrenheit,

Wenn Sie diese Variable in der Eigenschaft für Text unten verwenden, erhalten Sie einen Ausdruck, der wie folgt aussieht, wobei die Durchschnittstemperatur (in Grad Celsius) im mittleren Text des Indikators angezeigt wird, während der Fahrenheit-Wert im Text unten angezeigt wird:

Verwenden der erweiterten Formatierung in einem Indikator

Gehen Sie wie folgt vor, um Formatierungsausdrücke in einem Indikator-Element zu verwenden:

1. Klicken Sie im Konfigurationsmenü des Elements auf die Registerkarte Indikator.
2. Klicken Sie im Abschnitt Erweiterte Formatierung auf Aktivieren.

   Hinweis:

   Sobald die erweiterte Formatierung aktiviert ist, sind die Textfelder oben, in der Mitte und unten nicht mehr verfügbar. Diese Konfigurationen werden in Ihrem Ausdruck erstellt. Wenn Sie Werte eingeben, bevor Sie die erweiterte Formatierung aktivieren, werden sie dem Ausdruck automatisch hinzugefügt.
3. Erstellen Sie Ihren Formatierungsausdruck im Editor.

Tipp:

Wenn Sie Hilfe zu einer der Arcade-Funktionen benötigen, klicken Sie neben der jeweiligen Funktion auf die Informationsschaltfläche, um weitere Details anzuzeigen.
4. Wenn Sie möchten, dass der Ausdruck in einem bestimmten Intervall ausgeführt wird, z. B. wenn der Ausdruck die Funktion now() verwendet, aktivieren Sie die Umschaltfläche Skript aktualisieren und legen ein Aktualisierungsintervall fest.
5. Wenn Sie ein neues Attribut mit Ihrem Ausdruck erstellt haben, können Sie es mithilfe der {expression/yourAttributeName}-Syntax in den Feldern Titel und Beschreibung referenzieren.

Farbwerte

Wenn Sie Farbwerte in einen Ausdruck einbeziehen, müssen sie als Zeichenfolgen (in Anführungszeichen) angegeben werden. Für Farbwerte, die nicht definiert oder ungültig sind, werden automatisch Standardwerte verwendet. Als Farbwerttypen werden u. a. HEX-Werte, RGB, RGBA, HSL und HSLA akzeptiert. Im Folgenden finden Sie einige Beispiele sowie die jeweils unterstützte Syntax:

HEX-Farben

• #090
• #009900
• #090a
• #009900aa

RGB und RGBA

• rgb(34, 12, 64)
• rgba(34, 12, 64, 0,6)

HSL und HSLA

• hsl(50, 33 %, 25 %)
• hsla(50, 33 %, 25 %, 0,75)