Zum Hauptinhalt springen
Version: 25.2

Berichts Funktionen

Einfache Berechnungen (Calc)​

Hiermit können Sie einfache Berechnungen durchführen ohne SQL.

Bitte beachten

Das verwenden von Calc ist immer performanter als das verwenden eines SQLs und macht den Bericht schneller!

Für komplexere Berechnungen verwenden Sie bitte C# Scripting. Sie können in den Berechnungen auch andere {} Ausdrücke wie {Sql.Name} oder {Fun.Name} etc. verwenden.

Beachten Sie, dass die Groß-/Kleinschreibweise beim Ausdruck "Report.Calc" genau eingehalten werden muss.

Ausdruck |
------------------------------|----- {Report.Calc("{A.LENGTH}*10")}| Richtig {REPORT.CALC("{A.LENGTH}*10")}| Falsch !! {Report.CALC("{A.LENGTH}*10")}| Falsch !! {Report.Calc("{A.length}*10")}| Falsch !!

Beispiele:

{Report.Calc("{A.LENGTH}*10")}
{Report.Calc("{A.WERT1}/{A.WERT2}*10/{A.WERT3}")}

Sie können hiermit auch Wahr/Falsch aussagen berechnen. Diese können Sie dann bei der Funktion "Unterdrückung" als Bedingung einsetzen.

Beispiele:

{Report.Calc("'{A.STATUS}'='Offen'")}
{Report.Calc("'{A.STATUS}'!='Offen'")}
{Report.Calc("{A.STATUS_ZAHL} IN (100,200,500)")}

Beachten Sie das Textwerte immer in einfache Anführungszeichen gesetzt werden müssen auch wenn es sich um Ausdrücke handelt.

Beispiele:

{Report.Calc("'{A.VORNAME}'||' - '||'{A.NACHNAME}'")}

Was passiert wenn in einem Datenbankfeld NULL (Datenbank NULL) steht?

NULL wird eingesetzt.

Bei Berechnungen mit Zahlen ist darauf zu achten das wenn Spalten NULL werte enthalten das dann keine Berechnung ausgeführt werden kann.
Es erscheint dann ein Leerer text oder in manchen Fällen "#Error#".
Mit der Funktion NVL können NULL Werte in eine Zahl umgewandelt werden damit die Berechnung funktioniert.

{Report.Calc("NVL({A.HEIGHT},0)*10")}

Bei Report.Calc unterstützte Operatoren und Funktionen​

Bei Report.Calc können Formelausdrücke verwendet werden.
Für eine Liste der möglichen Formel Funktionen siehe:
Formelausdrücke

Beachten Sie das in diese Fall anders als dort Beschrieben Variablennamen in eckige Klammern geschrieben werden müssen.
Also {A.COLUMN} statt COLUMN.

Beachten Sie auch das Variablen mit Textwerten in einfach Anführungszeichen gesetzt werden müssen.

Seiten Nummer/Index (PageIndex)​

Gibt die aktuelle Seiten Nummer aus.

Beispiel:

{Report.PageIndex}

Seiten Anzahl (PageCount)​

Gibt die Seiten Anzahl aus.

Beispiel:

{Report.PageCount}

Seiten x von y (Page)​

Gibt einen Ausdruck wie "1 von 100" aus. Der Wert in Anführungszeichen gibt an welches Wort zwischen den Seiten Index und die Seiten Anzahl ausgegeben werden soll.

Beispiele:

{Report.Page("/")}
{Report.Page("of")}
{Report.Page("von")}

Ausgabe des aktuellen Datum​

Beispiele:

{Report.Date("dd.MM.yyyy")}
{Report.Date("MM/dd/yyyy")}

Ausgabe des aktuellen Uhrzeit​

Beispiele:

{Report.Time("hh:mm")}
{Report.Time("hh:mm tt")}

Datensatz Nummer (RowIndex)​

Gibt die Laufende Nummer des aktuellen Datensatzes zurück.

Anzahl Datensätze (RowCount)​

Gibt die Anzahl der Datensätze zurück.

Ersten Datensatz identifizieren (IsFirstRow/IsNotFirstRow)​

IsFirstRow gibt true zurück wenn es sich um den ersten Datensatz handelt. Ansonsten wird false zurück geliefert.

IsNotFirstRow gibt true zurück wenn es sich NICHT um den ersten Datensatz handelt. Ansonsten wird false zurück geliefert.

Diese Funktionen sind im Zusammenhang mit der Funktion "Unterdrücken" nützlich. Wenn Sie wollen das ein Text nur einmalig für die erste Zeile ausgegeben werden soll aber bei allen anderen Zeilen nicht dargestellt werden soll dann geben Sie bei Unterdrücken folgendes ein:

{Report.IsNotFirstRow}

Letzten Datensatz identifizieren (IsLastRow/IsNotLastRow)​

IsLastRow gibt true zurück wenn es sich um den letzten Datensatz handelt. Ansonsten wird false zurück geliefert.

IsNotLastRow gibt true zurück wenn es sich NICHT um den letzten Datensatz handelt. Ansonsten wird false zurück geliefert.

Diese Funktionen sind im Zusammenhang mit der Funktion "Unterdrücken" nützlich. Wenn Sie wollen das ein Text nur einmalig bei der letzten Zeile ausgegeben werden soll aber bei allen anderen Zeilen nicht dargestellt werden soll dann geben Sie bei Unterdrücken folgendes ein:

{Report.IsNotLastRow}

Summenbildung (Sum/RunSum)​

Unter Andere Berichts Funktionen steht auch eine Summenbildung (Sum) und Laufende Summe (RunSum) zur Verfügung, die sie im Bereich Fuss einfügen können.

Beispiele:

{Report.Sum("A.LENGTH")}
{Report.RunSum("A.LENGTH")}

Der Name der Spalte die aufsummiert werden soll muss im Bericht vorhanden sein und muss in Großbuchstaben geschrieben werden.

Die Summe und laufende Summe wird immer dann zurück auf 0 gesetzt wenn der Bericht im Ablauf auf ein {Report.Sum( stößt. Setzen Sie {Report.Sum( also nicht in den Seiten Fuss, sonst wird die Summe nach jeder Seite zurück gesetzt. Setzen Sie die Summe immer in einen Bereichs Fuss.

Decode Funktion​

Die Decode Funktion funktioniert analog zur in SQL bekannten Decode Funktion.

D.h. hiermit können Werte umgemappt werden.

Weitere Informationen zu DECODE finden Sie im Internet unter SQL und DECODE.

Beispiele:

{Report.Decode({A.MATERIAL},'PVC','blue','METAL','green','STONE','#FF0000','black')}
{Report.Decode({Report.IsFirstRow},True,'green','blue')}

Beispiele mit NULL (Datenbank NULL)

{Report.Decode({A.MATERIAL},'PVC','blue','METAL','green','STONE','#FF0000',NULL,'Undefined','black')}

IIf Funktion​

Die IIf Funktion funktioniert ähnlich wie die in SQL bekannte IIf-Funktion.

Wenn der übergeben erste Wert True (Wahr) ist dann wird der zweite Parameter zurück gegeben ansonsten der dritte Parameter.

Der Zahlenwert "0" wird als False (Falsch) gewertet, alle anderen Zahlen werden als True gewertet.
D.h. Wenn ein Feld den Wert 0 enthält wird dies als "False" interpretiert.
Wenn ein Feld den Wert -1 oder 1 (oder je andere Zahl) enthält wird dies als "True" interpretiert.
Datenbank NULL Werte werden als "False".

Beispiele:

{Report.IIf({Report.IsFirstRow},"erste Zeile","andere Zeile")}
{Report.IIf({A.FID}>5094,"wert groesser 5094","wert kleiner 5094")}

Beispiele:

{Report.IIf({A.IS_OPEN},"offen","geschlossen")}

Optional kann als 4ter Parameter ein Wert angegeben der zurückgegeben wird wenn der Wert NULL ist.

Beispiele:

{Report.IIf({A.IS_OPEN},"offen","geschlossen","undefiniert")}

FormatNumber (Zahlenwerte formatieren)​

Verfügbar ab Version 25.1.37

Hiermit können Zahlenwerte Formatiert werden.

Beispiel:

{Report.FormatNumber("0.00",{A.AREA})}
WertFormatAusgabe
5.123450.05.1
5.123450.005.12
5.123450.0005.123
3777.12345#,##0.003,777.12
3777.12345# ##0.003 777.12

FormatDate (Datumsangaben formatieren)​

Verfügbar ab Version 25.1.37

Hiermit können Datumswerte Formatiert werden.

Beispiel:

{Report.FormatDate("dd.MM.yyyy",{A.DATE_CREATED})}

Beispiele für Datumsformate

FormatAusgabe
dd.MM.yyyy31.12.1999
hh:mm:ss21:30:59
dd.MM.yyyy hh:mm:ss31.12.1999 21:30:59
MM-dd-yyyy12-31-1999
MM-dd-yyyy hh:mm:ss12-31-1999 21:30:59
MMMJan
MMMMJanuary
d.MMMM yyyy7.January 1999

Das Programm benutzt Microsoft Format angaben.
Für weitere Informationen und andere Beispiele siehe:
https://learn.microsoft.com/en-us/dotnet/standard/base-types/custom-date-and-time-format-strings