Formeloperator (zeilenweise)

• Variablen werden zur Erkennung mit # umfasst. #Breite#*#Höhe# bedeutet, dass Werte von der Spalte "Breite" mit Werte von der Spalte "Höhe" multipliziert werden.
• Durch Klicken auf das Symbol kann eine Variable (inkl der #) nach oben kopiert werden.

Wenn Wert in Spalte größer als 3 ist, schreibe 1, ansonsten schreibe 0 in die Ergebnisspalte.

 #Spalte# > 3.0 ? 1.0 : 0.0

Wenn das Datum der Spalte im Zeitraum von 1.1.2003 bis 30.9.2003 liegt, schreibe 1, ansonsten schreibe 0 in die Ergebnisspalte.

 #Datum#.Year == 2003 && #Datum#.Month <= 9 ? 1 : 0

Beispiel für geschachteltes If:

 #zeitvon# > 1000.0 ? "N" : (#zeitvon# < 100.0 ? "Frei" : "F")

Den gleichen Text in jede Zeile einer Spalte schreiben: Der Text muß immer unter Hochkomma stehen. Zusätzlich muss der Typ der Ergebnisspalte auf Text gesetzt werden.

 "Gleicher Text"

Falls die Funktionalität von Spalten zusammenfassen erweitert werden soll

 #datumsSpalte#.ToString() + "_" + #textSpalte#

In der Spalte 'Von' steht das Datum und die Uhrzeit. Ein reines Datum ohne Zeitanteil sei gewünscht.

 #Von#.Date 

(#Bis# - #Von#).TotalMinutes

Umgang mit Sonderzeichen: \" als zeichen für " geht nicht weil Formeloperator keine Escape sequenz erlaubt
aber das geht:
#Abt#.Length > 0 ? #Abt#.Substring(1, #Abt#.Length - 1) : "" um das erste Zeichen zu entfernen.

#name#.Substring(0,#name#.Length-2)

Es soll eine Spalte erzeugt werden, die Zeilen fortlaufend nummeriert oder diese soll in einer Formel verwendet werden, dann wird eingegeben

 rowNumber

Das liefert die Zeilennummer. (Achtung beginnend mit 0. - Sonst rowNumber +1 verwenden)

Es soll eine Spalte erzeugt werden, die Gesamtzahl der Zeilen zeigt oder diese soll in einer Formel verwendet werden, dann wird eingegeben.

rows

Komplexere Nummerierungen (zB nur weiterzählen wenn bestimmter Sachverhalt gegeben ist) werden so realisiert: Dazu muss zuerst eine eigene Zählervariable angelegt werden und dann auf diese die Formel angewandt werden. Typ der Ergebnisspalte ist Zahl mit Nachkommastellen.

Hinweis: Die Variablenzuweisung muss links stehen (wie üblich). Den Typ (in diesem Fall zB double) muss man mitgeben, weil Array untypisiert ist. Was hinter dem = steht, landet im Record. Das links steht, kommt in die Variable.

  Hier zum Kopieren für eine Variable VAR Zahl mit Startwert 0:
  additionalParameters["VAR"] = (double) additionalParameters["VAR"] + 1

Es soll eine Spalte erzeugt werden, die Gruppen von Zeilen fortlaufend numeriert (zB für verschiedene Linien in Grafik). Dazu muss zuerst eine eigene Zählervariable angelegt werden und dann auf diese die Formel angewandt werden. Typ der Ergebnisspalte ist Zahl mit Nachkommastellen. Hinweis: Die Variablenzuweisung muss links stehen (wie üblich). Den Typ (in diesem Fall zB double) muss man mitgeben, weil Array untypisiert ist. Was hinter dem = steht, landet im Record. Das links steht, kommt in die Variable.

In diesem Beispiel waren Sätze so sortiert, dass der erste Satz einer gruppe immer den Wert "Von" in der Variable WAS hatte

  Hier zum Kopieren für eine Variable VAR Zahl mit Startwert 0:

  additionalParameters["VAR"] = (double) additionalParameters["VAR"] + (#Was# =="Von" ? 1 : 0)

Es soll eine Spalte erzeugt werden, die eine andere fortlaufend summiert. Dazu muss zuerst eine eigene Zählervariable angelegt werden, diese mit 0 initialisiert werden und dann auf diese die Formel angewandt werden. Typ der Ergebnisspalte ist Zahl mit Nachkommastellen.

Hinweis: Die Variablenzuweisung muss links stehen (wie üblich). Den Typ (in diesem Fall zB double) muss man mitgeben, weil Array untypisiert ist. Was hinter dem = steht, landet im Record. Das links steht, kommt in die Variable.

  Hier zum Kopieren für eine Variable VAR Zahl mit Startwert 0:
  additionalParameters["VAR"] = (double) additionalParameters["VAR"] + #spalte#

Zusatzvariante Die folgende Anweisung führt dazu, dass der Wert aus #Tag# eingefügt wird, wenn in Ausgangsspalte was steht, und sonst der Wert der Vorgängerzeile. Achtung. ERgebnis muss auf Text gestellt sein.

  additionalParameters["VAR"] = (#Tag#.Length == 0 ? (string) additionalParameters["VAR"] :  (string) #Tag#)

Zusatzvariante Die folgende Anweisung führt dazu, dass der Wert aus #Daten# dazugezählt wird. Bei jedem neuen Identifiziererwert (vorher richtig sortieren!) wird neu begonnen. Unter- und Obergrenzen werden eingehalten

   additionalParameters["Hilfswert"] = (double) System.Math.Max(#Minimalwert#, (double) System.Math.Max(#Minimalwert#, (double)
            ((#Bis#-#Von#).Hours + (#Bis#-#Von#).Days*24 + (#Bis#-#Von#).Minutes / 60.0 >=#Zähler zurück setzen nach Stunden# ? #Daten# :
            (#Identifizierer# == #Id vorher# ? (double) additionalParameters["Hilfswert"] + #Daten# : #Daten#))))

In der Spalte 'Von' steht das Datum und die Uhrzeit . Es soll der Minutenabstand seit Beginn gerechnet werden.

 (#Von# - (System.DateTime) cc.CSharp.DataHelper.GetValue
     (dataRow, "Von", 0, (int) 0)).TotalMinutes

In der Spalte 'Von' steht das Datum und die Uhrzeit . Es soll der Minutenabstand seit X-Zeilen vorher gerechnet werden. Die konkrete Zahl soll von den Benutzern eingegeben werden können.

Es muss im Formeloperator eine Variable angelegt werden, die die Eingabe der Zahl erlaubt: z.B. #Zeilen vorher#.

Für die ersten Zeilen oder bei negativer Zeilenzahl kann es nicht berechenet werden, aber dann geht es los

 rowNumber < #Zeilen vorher# || 0 > #Zeilen vorher# ? 0 : 
 (#Von# - (System.DateTime) cc.CSharp.DataHelper.GetValue
 (dataRow, "Von", rowNumber, (int) -#Zeilen vorher#) ).TotalMinutes

Nachdem die Werte immer vom Typ object sind, müssen diese zur Weiterverarbeiten auf den richtigen Typen konvertiert werden.

 System.Convert.ToDouble(dataRow[3])

Double-Wert der vierten Spalte der aktuellen Zeile. Die Spaltenindizierung beginnt mit 0! Die Art der Konvertierung ist notwendig, weil dataRow[i] immer einen Datentyp object liefert.

 System.Convert.ToDouble(dataRow.Table.Rows[0][0])

Double-Wert der ersten Spalte in der ersten Zeile. Die Art der Konvertierung ist notwendig, weil dataRow.Table.Rows[i][j] immer einen Datentyp object liefert. ZB Liefert auf Datum/Uhrzeit Wert in erster Spalte #Von# und ABSTEIGEND sortierten Daten

(System.Convert.ToDateTime(dataRow.Table.Rows[0][0]) - #Von#).Days

die Zahl der Tage

 #Anzahl# > 3.0 ? 
 "<img src=images/Tree/Icons/bullet_ball_glass_red.gif>" : 
 "<img src=images/Tree/Icons/bullet_ball_glass_green.gif>" 

Es soll geprüft werden, ob in bestimmter Stelle ein null-Wert steht (also ein Wert fehlt). Damit kann z.B. gesteuert werden, dass wenn der Wert fehlt, ein bestimmter Rechenschritt anders gemacht wird, als sonst.

 dataRow.Table.Rows[rowNumber][3] == System.DBNull.Value ? #Wert A# : #Wert B#
 Wenn in der Spalte 4 (Achtung: Zählung startet mit 0, daher hat die 4. Spalte die Nummer 3) kein Wert vorliegt, wird auf Wert A zurück gegriffen, sonst auf Wert B.

Hinweise:

• Wenn Nullwerte ersetzt werden sollen, dann ist der Operator: Null-Werte ersetzen einfacher.
• Man muss direkt über die dataRow-Variable auf die Inhalte zugreift, da im #<feldname>#-Syntax immer sofort eine Umwandlung durchgeführt wird.

1. Mögliche Ursache ... ein Punkt im Spaltennamen
2. Mögliche Ursache ... 2 Leerzeichen im Spaltennamen
3. Mögliche Ursache ... Nullwerte in Zeilen ... zB bei Berechnen: wert aus vorhergehendem Satz

• HÄUFIGE URSACHE: Im Formeloperator wird auf einen Spaltennamen verwiesen, den es nicht mehr so gibt (Spalte gelöscht, umbenannt) oder es ist Spalte dazu gekommen, die aber nicht über mehrere Formeloperatoren weiter gereicht wurde.

LÖSUNG: In Formeloperator hineingehen, bei der Liste der Spaltenbezeichnungen "bearbeiten", dann wird diese Liste aktualisiert und das Problem verschwindet häufig.

• Seltenere URSACHE: Im Formeloperator wird auf einen Spaltennamen verwiesen, der " im Spaltennamen verwendet.

Lösung: Spalten umbenennen

Gegenmassnahmen gegen "Formelwürste":

1. Kommentare einbauen: /*Das hier ist ein Kommentar*/
2. Zeilenumbruch und Leerzeichen zur Formatierung nutzen. Z.B. wie in folgendem Bild

• Grundsätzlich gilt für C#-Compiler: Ganzzahl dividiert durch Ganzzahl ergibt wieder Ganzzahl.
  Beispiel: 5 / 2 = 2 (abgerundet).
• Will man als Ergebnis eine Dezimalzahl, muss man die Daten auf Double konvertierten.
  Beispiel: 5.0 / 2.0 = 2.5
• (double) #Ganzzahlspalte# wandelt eine Ganzzahl in eine Dezimalzahl um.

AUSGANGSSITUATION:

• aus Allgemeinem Kalender #TagNr# als Text zB 19 exportiert
• im Formeloperator: 120.00 + #TagNr# ergibt aber 12.019,00
• 120.00 + System.Convert.ToInt32(#TagNr#) ergibt 139,00

URSACHE:

• Der Typ von TagNr ist string, also wird 120.00 zuerst in einen Text konvertiert,
• dieser wird dann mit + (Stringverknüpfung!) zusammengefügt und - da der Ergebnistyp vermutlich eine Zahl ist - wieder in eine Zahl umgewandelt.
• Mit System.Convert.ToInt32 wird dem Formeloperator vor der Addition explizit mitgeteilt, daß der +-Operator für Zahlen verwendet werden muß, da alle beteiligten Datentypen Zahlen sind.
• Bei 120.09 wäre es günstig, System.Convert.ToDouble zur Konvertierung einzusetzen, damit der Formeloperator nicht auf die Idee kommt, den +-Operator für Integer-Zahlen zu verwenden.

• Vermutlich liefert die eigentlich Formel als Ergebnis einen Text. ABER
• Als Ergebnisformat im Operator ist nicht TEXT sobdern zB Ganzzahl eingestellt.