Output.Rocks bietet leistungsstarke Funktionen zur strukturierten Darstellung von Daten in Tabellen. Mit diesen Funktionen können Sie:

Zeilen basierend auf Bedingungen ein- oder ausblenden
Datenzeilen dynamisch wiederholen
Spalten bedingt anzeigen oder entfernen
Zeilenfarben alternieren
Komplexe, verschachtelte Tabellenstrukturen erstellen

Tabellen in Output.Rocks werden als .docx-Tabellen in der Vorlage formatiert und bei der Verarbeitung automatisch editiert und gefüllt.

Die Vorlagen-Syntax verwendet spezielle Marker, wodurch die Tabellen beim Rendern wachsen und strukturiert werden.

Bedingte Zeilen

Mit bedingten Zeilen können Sie eine Zeile oder eine Gruppe aufeinanderfolgender Zeilen basierend auf einer Bedingung anzeigen oder ausblenden.

Zusatzleistung	Details
<<cr_hatSonderkonditionen>>
Sonderkonditionen	Ja, <<rabatt>>
<<er_hatSonderkonditionen>>

Die Marker <<cr_hatSonderkonditionen>> und <<er_>> kennzeichnen den Anfang und das Ende des bedingten Bereichs. Wenn hatSonderkonditionen den Wert true hat, wird die Zeile angezeigt. Die Zeilen, die die Marker enthalten, werden immer entfernt.

Die Endmarker für bedingte Zeilen können auch ohne den Namen definiert werden. Im obigen Beispiel könnte das Feld <<er_hatSonderkonditionen>> auch zu <<er_>> vereinfacht werden.

Wiederholende Zeilen

Mit wiederholenden Zeilen können Sie Tabellenzeilen basierend auf einer Datenliste dynamisch generieren.

Zählpunkt	Verbrauch	Kosten
<<rr_verbrauchsdaten>>
<<zaehlpunkt>>	<<verbrauch>> kWh	<<kosten>> €
<<er_>>

Die Marker <<rr_verbrauchsdaten>> und <<er_>> kennzeichnen den Anfang und das Ende des Wiederholungsbereichs. Solange Daten für verbrauchsdaten vorhanden sind, wird die Zeile wiederholt.

Bei großen Datenmengen (über 1000 Zeilen) sollten Sie die Performance im Auge behalten. Verwenden Sie Filter für bessere Verarbeitungszeiten.

Schrittweise Wiederholung in Zeilen

Mit der Schrittfunktion können Sie Daten in kleineren Untergruppen darstellen:

Die Step-Funktion: Syntax und Variablen

Syntax:

<<rr_arrayName:step3>>
Teilt das Array in Gruppen von X (hier 3) Elementen pro Zeile

Automatische Variablen:

$i1, $i2, $i3 werden automatisch erstellt
Jede Zeile erhält die nächsten X (hier 3) Array-Elemente

Die Variablen $i1 bis $iX ergeben sich aus dem Teiler N in :stepN und werden in jeder Zeile neu mit den entsprechenden Array-Elementen befüllt.

Q1	Q2	Q3	Q4
<<rr_quartalsverbrauch:step4>>
<<$i1>> kWh	<<$i2>> kWh	<<$i3>> kWh	<<$i4>> kWh
<<er_>>

Sortierung von sich wiederholenden Zeilen

Mit der Sortierfunktion können Sie Daten vor der Anzeige nach einem Prinzip ordnen. Hier werden zBsp. die Kunden nach ihrem Verbrauch sortiert:

Kunde	Verbrauch (kWh)	Kategorie
<<rr_kunden:sort(verbrauch)>>
<<name>>	<<verbrauch>>	<<kategorie>>
<<er_>>

Die Sortierung kann angepasst werden mit:

:sort(DESC, WERT) für absteigende Sortierung
:sort(ASC, WERT) für aufsteigende Sortierung (Standard)
:sort(CASE_SENSITIVE, WERT) für Groß-/Kleinschreibung beachtende Sortierung
:sort(NULLS_LAST, WERT) oder :sort(NULLS_FIRST, WERT) für die Behandlung fehlender Werte

Sortierung ist besonders nützlich für Verbrauchsauswertungen, Kundenlisten oder Rechnungspositionen.
Die Sortierung erfolgt vor der Darstellung und beeinflusst nicht die ursprünglichen JSON-Daten.

Filter

Mit der Filterfunktion können Sie nur bestimmte Daten anzeigen:

Kunde	Verbrauch (kWh)	Status
<<rr_kunden:filter(status='Aktiv')>>
<<name>>	<<verbrauch>>	<<status>>
<<er_>>

Filter können auch Expressions benutzen, wie z.B. {verbrauch > 20000}.

Wichtig: In Output.Rocks werden String-Werte in Filterausdrücken für Tabellen immer mit einfachen Anführungszeichen (') angegeben, nicht mit doppelten Anführungszeichen (").

<<rr_kunden:filter(status='Aktiv')>>    ✓ Richtig
<<rr_kunden:filter(status="Aktiv")>>    ✗ Falsch

Erweiterte Filteroptionen

Filter können sehr komplex sein, solange sie als Expression { ... } geschrieben werden.

Für komplexere Filter können Sie alle verfügbaren Text-Funktionen und Numerische Funktionen verwenden. Diese ermöglichen erweiterte String-Manipulation, mathematische Berechnungen und logische Verknüpfungen in Ihren Filterausdrücken.

Gruppierung in wiederholenden Zeilen

Mit der Gruppierungsfunktion können Sie Daten nach bestimmten Kriterien zusammenfassen:

Rechnungspositionen nach Kategorie
<<rr_positionen:group(kategorie)>>
<<$groupKey>>
<<rr_$groupItems>>
<<beschreibung>>	<<betrag>> €
<<er_>>
<<er_>>

Das Tag <<rr_positionen:group(kategorie)>> wird verwendet, um über die Positionen zu iterieren, gruppiert nach der "kategorie". Innerhalb der Gruppe verwenden wir <<$groupKey>>, um den Schlüssel für die aktuelle Gruppe auszugeben, und <<rr_$groupItems>>, um über die Elemente in der Gruppe zu iterieren.

Gruppierung ist ideal für strukturierte Rechnungen, Verbrauchsauswertungen nach Zeiträumen oder Kundenlisten nach Regionen. Die Gruppierung erfolgt automatisch basierend auf dem angegebenen Feld.

Bedingte Spalten

Mit bedingten Spalten können Sie Spalten basierend auf Bedingungen entfernen:

Kunde	<<cc_zeigeRabatt>> Rabatt	Status
<<rr_kunden>>
<<name>>	<<rabatt>>%	<<status>>
<<er_>>

Der Marker <<cc_zeigeRabatt>> wird in der Spaltenüberschrift platziert und bestimmt, ob die gesamte Spalte angezeigt wird. Wenn zeigeRabatt den Wert false hat, wird die komplette Rabatt-Spalte ausgeblendet.

Weitere Möglichkeiten zur Datenvisualisierung finden Sie unter Datenvisualisierung mit Tabellen und Diagrammen.