Unter Crystal Reports sind folgende Funktionen für bedingte Anweisungen und Schleifen verfügbar:

• If-Then-Else-Formeln
• Select Case
• For
• While Do
• Boolean

If-Then-Else Formeln

If-Then-Else Formeln werden, wie in anderen Programmiersprachen üblich verwendet.

Wichtig unter Crystal Reports ist hierbei, das der If Testteil den üblichen Beschränkungen der Datentypenvergleiche genügen muss. Der Else-Teil der Formeln ist Optional.

Wenn der Else-Teil verwendet wird, muss der Rückgabetyp dem Rückgabetyp des Then-Teils entsprechen.

Nützliche Funktionen

If IsNull  – Prüfung ob Datenfeld ‘Null’ entspricht

Next – Für Vergleiche eines Datensatzes mit einem darauffolgenden

InRepeatedGroupHeader – Für Gruppenköpfe, die auf jeder neuen Seite angezeigt werden, um Neuberechnungen mancher Formeln zu unterdrücken, falls der Gruppenkopf nicht neuer Gruppe entspricht

Select Case

Für Fallunterscheidungen je nach Datenwert.

Select

Case 0….
Case X
Default

Default als Defaultwert, sollte keiner der Case-Fälle zutreffen.

For-Schleifen

Übliche For Schleifen, läßt sich je nach Fall durch Funktionen wie z.B. Split oder Join (Anwendbar auf Strings) ersetzen.

While Do-Schleifen

Benutzung nach üblichem Prozedere, Ausführung der Schleife bis Bedingung nicht mehr zutrifft.

Boolsche Formeln

Formeln, die Booleanwerte zurückgeben und im Berciht angezeigt werden, lassen sich formatieren, so das nicht nur True oder False angezeigt wird, sondern z.B. J oder N

Über Datei->Optionen findet sich die Option ‘ Null-Werte in Datenbank zu Standard konvertieren’. Damit werden alle angetroffenen ‘Null’ konvertiert, und dies in jedem Bericht.

Ein Schritt weiter geht die Option ‘Andere Null-Werte zu Standard konvertieren’ damit werden sogar Null-Werte aus Formel-Resultaten konvertiert.

Möchte man keine dieser Optionen nutzen, bietet sich in jeder Formel noch immer die Möglichkeit, oben per Drop-Down zwischen ‘Ausnahmen für Nullen’ oder ‘Standardwerte für Nullen’ zu wählen. ‘Standardwerte für Nullen’ konvertiert widerrum die Werte, jedoch gilt dies nur für diese Formel. ‘Ausnahmen für Nullen’ verändert nichts an ‘Null-Werten’, so dass man diese mit der If-Then-Else-Formel ‘IsNull’ behandeln kann.

Weitere Details zu If-Then-Else Formeln im Blog Eintrag ‘Schleifen und Bedingte Anweisungen unter Crystal-Reports 2008′

Variablendeklarationen in Crystal Reports unterliegen folgender Syntax:

Variablenart Variablenname;

Den Namen  verschiedenen Variablenarten zu finden, ist in Crystal Reports sehr leicht. Sie sind unter ‘Variablendeklarationen’ unter Operatorenstruktur im Formeleditor zu finden.

Gültigkeitsbereiche

Es gibt 3 Arten von Variablen:

• shared
• global
• local

Shared ist die umfassenste Art von Variabel, sie ist sowohl im Hauptbericht als auch in verketteten Unterberichten zugreifbar.

Global ist im Hauptbericht von jeder Funktion in jedem Berichtsabschnitt zugreifbar.

Local sind lediglich in der Formel gültig, in welcher sie deklariert wurden. Benutzt werden die klassifizierungen durch vorranstellen vor der Variablendeklaration. z.B.

Shared DataVar AktuellesLieferDatum;

Variablen anzeigen

Die Anzeige einer Variablen im Bericht geschieht durch Formeln. Am Ende der Formeln muss die Variable genannt werden und wenn die Formel in den Bericht eingefügt wird, nimmt sie dann den Wert der Variablen an.

D.h. möchte man eine Ergebnisvariable im Bericht anzeigen, so führt man die Berechnungen aus und setzt dann die Variable nochmal ein.

Bespiel:

CurrencyVar Summe;
Summe := x + y + z
Summe

Dies würde die Variable ausgeben.

Erweitert könnte man die Variable auch folgendermaßen ausgeben:

CurrencyVar Summe;
Summe:= x + y + z
“Die Summe beträgt ” & ToText(Summe) & ” Euro.”

Auswertungszeitpunkte bei Crystal Reports 2008

Crystal Reports 2008 kennt 3 Arbeitsschritte:

• Before Reading Records
  • noch keine Daten ausgelesen
  • Ausführung von Formeln die kein Bezug auf Datenbankdaten haben
• While Reading Records
  • Daten werden ausgelesen jedoch unsortiert / gruppiert
  • Formeln die sich auf Datenbankfelder beziehen werden ausgeführt, jedoch keine Summenfunktionen
• While Printing Records
  • während Daten formatiert und gedruckt werden
  • Formeln welche Summen, Mittelwerte o.ä. berechnen

Bei Formeln die auf Variablen basieren, muss z.T. der Auswertungszeitpunkt manuell festgelgt werden ( z.B. WhilePrintingRecords) ansonsten wird die Formel nicht korrekt durchgeführt. Bei Formeln, die zum Zeitpunkt WhilePrintingRecords ausgeführt werden, kann trotzdem nicht auf Summen und Zusammenfassungen zugegriffen werden. Diese werden erst während dieses Arbeitschrittes erstellt.

Reihenfolgen festlegen

Oft ergeben sich die Auswertungszeitpunkte der Formeln durch ihre Plazierung von selbst ( Gruppenfuß, Berichtsfuß etc) sollte es jedoch notwendig sein mehrere Formeln auf gleicher Ebene zu verwenden, welche auf einander aufbauen, fügt man die Zeile EvaluateAfter({@Formelname}) ein, und die Formel wird erst durchgeführt, nach der in dieser Zeile genannten Formel.

Die Möglichkeiten sind immens:

Crystal Reports kann jede Art von Datenformat zu Strings konvertieren und dabei auch formatieren.

Womit? ToText bietet dies.

ToText kann Datumsformate,Zahlen und Zeiten umwandeln und formatieren.

Ein Beispiel: ToText({Datenbank.Zahl},0) konvertiert eine Zahl und kürzt Dezimalstellen.

ToText({Datenbank.Datum}, “dddd, tt. MMM, yy”) würde für heute ausgeben: Mittwoch, 17.Dez,2008

ToWords konvertiert Zahlen zu Wörtern. D.h. ‘30′ wird zu ‘dreizig’

Als letztes konvertierungen zum Thema Datum:

DateValue liest Datenfelder aus und konvertiert sie zu einem Datum! Anwendbar ist dies auf Zahlenfelder im Format wie 17.12.2008 oder auch einem Textfeld wie weiter oben zu sehen.

Dieses Datumsfeld läßt sich dann in Crystal Reports formatieren wie jedes Datum (lang,kurz,mit Tagesnamen etc pp)

Beispiel: Die Parameter

Werden mit DateValue eingelesen und stehen nun als Datum im Bericht zur Verfügung.

Wie zu sehen ist sind nach den beiden Feldern die Tage und Wochen berechnet ( nur ganzzahlig).

Zu realisieren ist dies mit einer weiteren Funktion. DateDiff berechnet die Differenz zwischen zwei Datumswerten und gibt diesen als Zahl aus, dabei muss angegeben werden, in welcher Dimension gerechnet wird, dies kann von Tagesdifferenz, über Monate zu Jahren sein.

In Crystal Reports 2008 wurde im Vergleich zu vorherigen Versionen an den Parametern viel verändert.

Es gibt nun 2 Arten von Parametern:

• Statische
• Dynamische

1. Statische Parameter

Statische Parameter sind vom Grundprinzip simpel.

Bei statischen Parametern kann man diverse Werte fest eintragen, oder aus Datenbankfeldern auslesen.

Diese lassen sich dann noch mit einer Beschreibung verknüpfen. In den Einstellungen bietet Crystal Reports dann noch diverse Möglichkeiten, wie z.B. die Anzeige des Parameters ausschleißlich mit seiner Beschreibung oder auch die Sperrung gegen benutzerdefinierte Werte ( ansonsten kann der Benutzer bei der Parametereingabe noch eigene Werte angeben).

Sollte diese Parameterliste auf einem Datenbankfeld oder einer Abfrage basieren, sind Änderungen manuell vorzunehmen oder die Parameterliste muss neu abgefragt werden.

Sollte also ein Parameterfeld auf Daten beruhen, die oft Änderungen unterliegen, oder wo neue Eintragungen vorgenommen werden,  sollte man dynamische Parameter nutzen.

2. Dynamische Parameter

Dynamische Parameter sind im Gegensatz zu den statischen, wie der Name bereits aussagt, dynamisch. Sie fragen bei Aufruf ad-hoc ihre Daten ab und sind somit immer aktuell. Änderungen in Datenbanken oder Abfragen tauchen sofort bei der nächsten Aufführung auf.

Wie die statischen Parameter lassen sich auch hier Merkmale mit Beschreibungen verknüpfen und auch Optionen wie das Sperren benutzerdefinierter Eingaben gibt es hier.

Der größte Unterschied jedoch liegt in der Möglichkeit kaskadierende Dropdowns aufzubauen, d.h. Dropdowns, die wiederrum weitere Dropdowns aufgrund der Auswahl beeinflussen.

In diesem Beispiel ist es eine 2-Stufige Dropdownliste. Nach Auswahl der Parameter_ID mit der Beschreibung wird entsprechend durch die Filterung der nächste Dropdown mit ‘Hauptgruppe’ aufgerufen. Unter den dynamischen Parametern lassen sich keine Benutzerdefinierten voreintragen, ganz im Gegensatz zu den statischen.

Achtung! Die Namensgebung für dynamische Parameter ist unter Crystal Reports manchmal etwas undurchsichtig, man sollte den Parameternamen mit ‘F2′ zum besseren Verständnis im nachhinein selbst anpassen.

Hinweis:

Nicht nur Berichtsintern verwendete Parameter lassen sich hiermit steuern, auch Parameter aus SQL-Befehlen sind hiermit modifizierbar.

Wenn ich z.B. eine Textbox habe, deren Hintergrund ich bei jedem neuen Datensatz hin und her wechseln möchte, geht man folgendermaßen vor:

Man ruft über das Menü ‘Bericht’ von Formel-Workshop auf. Dort geht man dann in die Formatierungsformeln:

Die Möglichkeiten sind je nach Feld sehr vielfältig:

Man wählt in diesem Beispiel die Formatierungsoption ‘Hintergrundfarbe’.

Dann öffnet sich der Formeleditor und man kann seine Bedingungen angeben, unter welchen Bedingungen welche Farben zu verwenden sind.

Hier ist als Bedingung, das der aktuelle Datensatz durch 2 teilbar ist, dann ist der Hintergrund weiss, ansonsten wird der Hintergrund auf eine benutzerdefinierte Farbe gesetzt.

Die Werte lassen sich über die Farbeauswahl finden -> Weitere Farben, dort lassen dann die Werte für Rot,Grün und Blau ablesen.

Alternativ kann man die Formeln auch über Rechtsklick auf die Felder und ‘Feld formatieren’ erstellen. Man landet direkt in der Formelerstellung zur Formatierung.

Nach Eintrag einer Formel ist dieses hier durch eine Symboländerung ersichtlich: