Grundlagen der Crystal-Syntax

Ergebnis einer Formel

Das Ergebnis einer Formel bzw. der Wert, der ausgegeben oder ausgedruckt wird, wenn die Formel in einen Bericht eingefügt wird, wird als der von der Formel zurückgegebene Wert bezeichnet. Jede Formel in Crystal Reports muss einen Wert zurückgeben. Die folgende Beispielformel in ganz einfacher Crystal-Syntax gibt den Wert 10 zurück:

10

Der Wert, der von einer Formel zurückgegeben wird, kann einer der sieben unterstützten einfachen Datentypen sein. Bei diesen einfachen Datentypen handelt es sich um Zahl (Number), Währung (Currency), Zeichenfolge (String), boolescher Wert (Boolean), Datum (Date), Uhrzeit (Time) und DatumUhrzeit (DateTime).

Anmerkung
Darüber hinaus unterstützt Crystal Reports Bereichstypen und Arraytypen, die jedoch nicht von Formeln zurückgegeben werden können.

Nehmen wir beispielsweise an, eine Firma schließt beim Versand von Bestellungen mit einem Wert von über 1.000 € grundsätzlich eine Transportversicherung ab, für Aufträge mit niedrigerem Bestellwert dagegen nicht:

If {Orders.Order Amount} >= 1000 Then
"Versicherter Versand"
Else
"Normaler Versand"

Die oben angegebene Formel gibt die Zeichenfolge "Versand mit Versicherung" zurück, falls der Wert des Datenbankfeldes {Aufträge.Auftragsvolumen} größer als oder gleich 1000 ist, und bei allen niedrigeren Werten wird die Zeichenfolge "Normaler Versand" zurückgegeben.

Auf Ausdrücken basierende Syntax

Eine in Crystal-Syntax geschriebene Formel besteht aus einer Folge von Anweisungen. Ein Ausdruck ist eine Kombination von Schlüsselwörtern, Operatoren, Funktionen und Konstantenwerten, die einen Wert eines gegebenen Typs ergeben. Der Wert des endgültigen Ausdrucks ist der Wert, der von der Formel zurückgegeben wird, sowie das, was gedruckt wird. Jeder Ausdruck muss vom vorhergehenden Ausdruck durch ein Semikolon (;) abgetrennt sein.

Die Tatsache, dass es sich bei einer Formel in Crystal-Syntax um eine Folge von Ausdrücken handelt, deren Ergebnis der Wert des letzten Ausdrucks sind, stellt das wichtigste Konzept dar, das für ein Verständnis der Crystal-Syntax begriffen werden muss. Aufgrund dieser auf Ausdrücken basierenden Syntax können Sie in sehr kurzen Formeln viel Funktionalität unterbringen.

Groß- und Kleinschreibung

Bei allen Variablennamen, Funktionen und Schlüsselwörtern, die in einer in Crystal-Syntax geschriebenen Formel verwendet werden, wird nicht zwischen Groß- und Kleinschreibung unterschieden. Das Then-Schlüsselwort könnte beispielsweise auch then oder THEN geschrieben werden.

Die einzige Ausnahme zu dieser Regel bilden die Zeichenfolgenwerte. Die Zeichenfolge "Hallo" ist keineswegs identisch mit der Zeichenfolge "hallo".

Übung anhand der Xtreme-Musterdatenbank

Viele der in diesem Abschnitt aufgeführten Beispiele beziehen sich auf die Xtreme-Musterdatenbank.

Anmerkung
Weitere Informationen zur Konfiguration dieser Datenbank und ihres ODBC-Eintrags finden Sie unter Verzeichnis für die Xtreme-Musterdatenbank und ODBC DSN-Eintrag für die Xtreme-Musterdatenbank.