Festlegen von Parametern

Parameter dienen dazu, den Anwender eines Berichts zur Eingabe von Informationen aufzufordern. Stellen Sie sich einen Parameter als eine Frage vor, die der Anwender beantworten muss, bevor der Bericht generiert wird. Die Informationen, die der Anwender eingibt, oder die Art seiner Antwort bestimmen, was im Bericht angezeigt wird. So könnte beispielsweise in einem Bericht für Verkaufspersonal der Anwender durch einen Parameter gebeten werden, eine Region zu wählen. Anschließend würde dieser Bericht die Ergebnisse für diese bestimmte Region ausgeben, anstatt die Ergebnisse für alle Regionen zu liefern.

Mit Hilfe von Parameterfeldern in Formeln, Auswahlformeln und im Bericht selbst können Sie einen Bericht erstellen, der bei Bedarf schnell angepasst werden kann. Parameterfelder können auch in Unterberichten eingesetzt werden.

Falls ein Parameter fehlt oder ungültig ist, gibt das Programm einen Fehler aus. Wenn Sie die "EnableParameterPrompt"-Eigenschaft von Crystal Report Viewer auf "true" setzen, wird der Anwender durch den Bericht stattdessen aufgefordert, den Parameter erneut einzugeben.

Aspekte von Parameterfeldern

Beachten Sie die folgenden Punkte, wenn Sie mit Parameterfeldern arbeiten:

  • Um den Anwender mithilfe eines Parameters zur Eingabe von Informationen aufzufordern, müssen Sie den Parameter in den Bericht einfügen, z.B. in eine Datensatz- oder Gruppenauswahl, in eine Formel oder einfach als Feld in dem Bericht.
  • Sie müssen ein Parameterfeld nicht in Ihren Bericht einfügen, um es in einem Datensatz oder in einer Gruppenauswahlformel zu verwenden. Sie erstellen einfach das Parameterfeld und geben es dann (genauso wie jedes andere Feld) in Ihre Formel ein.
  • Ein Parameterfeld muss vom gleichen Datentyp sein wie das Feld, mit dem es verglichen wird. Wenn z. B. das Feld {Kundenname} vom Typ Zeichenfolge in einem Bericht verwendet wird, in dem die Datensatzauswahl auf einen bestimmten Kundennamen beschränkt ist, muss das zu diesem Zweck erstellte Parameterfeld auch vom Typ Zeichenfolge sein.
  • Parameterfelder können von einem der folgenden Datentypen sein:
    Datentyp
    Erklärung
    Parameterbeispiel
    Boolesch
    Erfordert eine Antwort der Form Ja/Nein oder TRUE/FALSE.
    Sollen im Gruppenergebnis geplante Budgetzahlen einbezogen werden?
    Währung
    Erfordert einen Währungsbetrag.
    Kunden mit Umsätzen über XXXXX anzeigen.
    Datum
    Erfordert eine Antwort in einem Datumsformat.
    Geben Sie Anfangs- und Enddatum des Quartals ein.
    DateTime
    Erfordert die Eingabe eines Datums und einer Uhrzeit.
    Statistische Angaben für das Datum 07.04.2000 zwischen 13:00 und 14:00 Uhr anzeigen.
    Zahl
    Erfordert die Eingabe eines numerischen Wertes.
    Geben Sie die Kundennummer ein.
    Zeichenfolge
    Erfordert eine Zeichenfolge als Antwort.
    Geben Sie die Region ein.
    Uhrzeit
    Erfordert eine Antwort in einem Uhrzeitformat.
    Gesamtzahl aller Anrufe in der Zeit zwischen 13:00 und 14:00 Uhr anzeigen.
  • Sie können eine Auswahlliste für den Anwender erstellen, damit er den Parameterwert auswählen kann, anstatt ihn selbst eingeben zu müssen.
  • Die Länge einer Parameterfeldaufforderung ist auf vier Zeilen mit etwa 60 bis 70 Zeichen pro Zeile (abhängig von der Zeichenbreite, maximal 254 Zeichen) begrenzt. Eingaben, die länger als eine Zeile sind, werden automatisch umbrochen.

In diesem Abschnitt