Labels Tab

Value Format

Mit dem Value Format definieren Sie die Art der Darstellung der Werte in der Matrix.
Sie können mehrere Formate definieren und diese bestimmten Spalten über Filterung zuordnen.

Value Format Assignment

Die Konfiguration erreichen Sie durch Klick auf ein Element in der Liste. Ein weiteres Value Format definieren Sie durch Klick auf das -Symbol.

Value Format Pop-Up

Definieren Sie das Zahlenformat über folgende Optionen:

• Filter: Über einen Klick in die leere Liste oder auf das -Symbol definieren Sie ein oder mehrere Dimensionsmember, für die diese  Formateinstellungen gelten soll. Eine Kennzahlenspalte wählen Sie beispielsweise über die Dimension "measures" und den Namen der zu formatierenden Spalte aus.
• Locale: Legt Abkürzungen, Dezimal- und Tausendertrennzeichen für die jeweilige Sprache fest. Sie können zwischen en, de, fr und auto wählen.
  Bei Auswahl von auto wird die in der jeweiligen Host-Applikation hinterlegte Locale verwendet. 
• Format Type: Legt die Art der Zahlenausgabe fest. Sie können zwischen number (Dezimalzahl), percent (Prozentzahl), ordinal (Ordnungszahl) und time (Zeiteinheit) wählen.
• Abbreviations: Legt die Art der Abkürzungen für alle zu formatierenden Zahlen fest. Sie können zwischen mean (Abkürzung des Mittelwerts), min (Abkürzung des Minimalwerts), max (Abkürzung des Maximalwerts), auto (am besten passende Abkürzung), trillion (immer Billionen-Abkürzung), billion (immer Milliarden-Abkürzung), million (immer Millionen-Abkürzung), thousand (immer Tausender-Abkürzung) und none (keine Abkürzung) wählen.
  Mittels dieser Eigenschaft können Sie z.B. erreichen, dass Zahlenwerte immer in Tausendern - z.B. 0,1k oder 1000k - dargestellt werden.
• Negative Sign: Legt fest, wie negative Zahle dargestellt werden. Sie können zwischen minus (Minuszeichen), parenthesis (Klammern), und none (kein Zeichen) wählen.
• Prefix: Der Eingabewert wird vor die Zahl gesetzt.
• Suffix: Der Eingabewert wird hinter die Zahl gesetzt.
• Thousands Separator: Ersetzt das von der ausgewählten Locale festgesetzte Tausendertrennzeichen.
• Decimal Separator: Ersetzt das von der ausgewählten Locale festgesetzte Dezimaltrennzeichen.
• Total Digits: Legt fest, aus wie vielen Ziffern die Zahl bestehen darf. Total Digits wird gegenüber Decimal Digits priorisiert.
• Decimal Digits: Legt fest, wie viele Nachkommastellen der formatierten Zahl angezeigt werden.
• Scaling Factor: Der Wert jedes Datenpunktes wird mit der eingegebenen Zahl multipliziert, um Werte zu skalieren.
• Zero Format: Wenn die Checkbox aktiviert ist, wird jeder Datenwert, der 0 (der Zahl Null) gleicht, durch den eingegebenen Wert ersetzt.
• Null Format: Jeder Datenwert, der NULL (kein Wert) gleicht, wird durch den eingegebenen Wert ersetzt.
• Infinity Format: Wenn ein Datenwert undefiniert oder das Resultat eines arithmetischen Fehlers, wie das Teilen durch 0 (Null), ist, wird der Datenwert durch den eingegebenen Wert ersetzt.
• Rounding Method: Legt die Rundungsmethode fest. Sie können zwischen half up (23.5 → 24, -23.5 → -23), commercial (kaufmännisches Runden: 23.5 → 24, -23.5 → -24) und trim (trimmen: 23.5 → 23, -23.5 → 23) wählen.
• Explicit Positive Sign: Legt fest, ob vor einer positiven Zahl immer ein + (Pluszeichen) stehen soll.
• Time Units: Wenn für den Format Type Time festgelegt wurde, können hier die time units eingestellt werden. Die Standardeinstellung interpretiert Datenwerte als Sekundenwerte und stellt sie als Stunden und Minuten mit Nachkommastellen im Format h:mm.m dar. 
• Description: Legt eine Beschreibung für die eingestellte Konfiguration fest.

Time Units Pop-Up

Im Format Type Time kann mit Hilfe der Time Units ein Einheitensystem konfiguriert werden, das in der Standardeinstellung aus Stunden und Minuten besteht. Jede so formatierte Zahl wird dann in ihren Anteilen entsprechend der Einheiten dargestellt, erhält also für jede Einheit einen Wert. Die Reihenfolge der Einheitenliste definiert ihre Beziehung von der größten Einheit (oben) zur kleinsten Einheit (unten). Jede Einheit enthält folgende Optionen:

• Modulus: Legt die arithmetische Verknüpfung zwischen den Einheiten fest. Die Zahl spiegelt im Sinne modularer Arithmetik wieder, wie viele Entitäten der nächstkleineren Einheit in eine Entität der aktuell betrachteten Einheit passen. Wenn die aktuell betrachtete Einheit die kleinste des Einheitensystems ist, stellt der Modulus den Bezug zum Rohwert her, der formatiert werden soll. Im Falle eines Einheitensystems aus Stunden und Minuten mit Rohwerten, die in Minuten vorliegen, trägt also die Einheit Stunden den Modulus 60 und die Einheit Minuten den Modulus 1.
• Prefix: Legt den lokalen Prefix fest, mit dem der Wert dieser Einheit beginnen soll. Er kann als Trennzeichen zu Werten größerer Einheiten verwendet werden.
• Suffix: Legt den lokalen Suffix fest, der dem Wert dieser Einheit nachgestellt sein soll. Er kann beispielsweise ein Einheitenkürzel enthalten oder als Trennzeichen zu Werten kleinerer Einheiten verwendet werden.
• Omit If Zero: Stellt ein, ob Werte dieser Einheit ausgeblendet werden sollen, wenn sie 0 entsprechen.
• Leading Zeros: Stellt ein, ob Werte dieser Einheit mit einer oder mehreren (abhängig vom Bezug zur nächstgrößeren Einheit) vorangestellten Nullen dargestellt werden sollen.
• Description: Legt eine Beschreibung für die Einheit fest, um sie in der Liste leichter wiederzuerkennen.

Text Align

Legt fest, wie Zahlenwerte in der Matrix gesetzt werden: linksbündig (left), zentriert (center) und rechtsbündig (right).

Scripted Formatting

CFL Rules

Nach unseren Erfahrungen mit anderen Tabellenkomponenten haben wir uns entschieden unseren Kunden eine Möglichkeit zu bieten, die graphomate matrix sehr individuell entsprechend ihren Vorstellungen zu formatieren. Die Cell Formatting Language (CFL) definiert Regeln, die für jede Zelle der matrix ausgeführt werden. Diese Regeln können dazu genutzt werden um die Darstellung der Zellen, auf Basis von Eigenschaften der Zelle, der Daten oder der Properties der matrix, zu beeinflussen.
Auf diese Weise können Sie mit wenig Zeilen Code aus der graphomate matrix eine Heat-Map erzeugen, Elemente einfärben oder bedingte Formatierungen umsetzen.

CFL Rules Pop-Up

Folgende Eigenschaften können definiert werden:

• Enable: Diese Boolean-Property ermöglicht es, die Regel zu (de)aktivieren.
• Name: Ein Name, der zur Identifikation der Regel dient.
• Script Body: Hier wird das CFL-Skript hineinkopiert.

CFL Variables

An dieser Stelle können Sie eigene Variablen definieren, die Sie in einer CFL-Regel verwenden möchten. In der CFL-Rule wird die Variable über die Methode .getCflVariable abgerufen. Der Wert der Variable muss dem JSON-Format entsprechen (Beispiele: 5 oder "center" oder [1,2,3] oder null oder {"foo":"bar"}.

CFL Variables Pop-Up

Folgende Eigenschaften können definiert werden:

• Identifier: Vergeben Sie einen eindeutigen Namen, auf den in einer CFL Regel referenziert werden kann.
• Value: Der Wert der Variable muss dem JSON-Format entsprechen (Beispiele:  "car" für eine Zeichenkette oder 3.14159 für einen Zahlenwert.)

Custom CSS

Nutzen Sie direkt CSS Code für die matrix, wenn Sie komplexe Selektoren im Styling nicht über die CFL ansprechen können.

Custom CSS Pop-Up

Folgende Eigenschaften können definiert werden:

• Enable: Diese Boolean-Property ermöglicht es, das CSS Skript zu (de)aktivieren.
• Name: Ein Name, der zur Identifikation des CSS Skripts dient.
• CSS: Hier wird das CSS eingefügt, das aus mehreren CSS Regeln bestehen kann.