Erstellen eines Berichts mit Parametern

Zunächst erstellen Sie einen Bericht, dessen Daten aus der Xtreme-Musterdatenbank abgerufen werden.

Anmerkung

Die mit den meisten Crystal Reports-Versionen bereitgestellte Musterdatenbank hat den Namen "Xtreme.mdb". Um die Ihrer Crystal Reports-Version entsprechende Datenbank "Xtreme.mdb" auf der Festplatte zu suchen, informieren Sie sich unter Verzeichnis für die Xtreme-Musterdatenbank. Sie stellen über den zugehörigen ODBC DSN-Eintrag eine Verbindung zur Datenbank her. Wie Sie den Eintrag für Ihre Crystal Reports-Version herausfinden, erfahren Sie unter ODBC DSN-Eintrag für die Xtreme-Musterdatenbank.

So erstellen Sie einen Bericht mit Parametern

1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den fett formatierten Projektnamen, zeigen Sie auf Hinzufügen, und klicken Sie dann auf Neues Element hinzufügen.

2. Wählen Sie im Dialogfeld Neues Element hinzufügen in der Ansicht Vorlagen die Vorlage mit dem Namen "Crystal Report".

3. Geben Sie im Feld Name den Namen "CustomersByCity.rpt" ein, und klicken Sie auf Hinzufügen.

4. Falls Sie noch nicht registriert sind, werden Sie jetzt aufgefordert, sich zu registrieren. Informationen zur Registrierung finden Sie unter Crystal Reports-Produktschlüsselcode und -Registrierungsnummer.

5. Aktivieren Sie im Dialogfeld Crystal Reports-Galerie im Bereich Neues Crystal Reports-Dokument erstellen die Option Mit dem Bericht-Assistenten.

6. Wählen Sie im Bereich Assistenten auswählen die Option Standard, und klicken Sie dann auf OK.

7. Erweitern Sie im Bereich Verfügbare Datenquellen des Fensters Assistent für die Standardberichterstellung den Ordner neue Verbindung herstellen.

   Anmerkung
   In Versionen von Visual Studio .NET 2003, in denen Crystal Reports noch nicht auf die Vollversion aktualisiert wurde, ist der Ordner "Neue Verbindung herstellen" nicht vorhanden. Die Inhalte werden auf der obersten Ebene angezeigt.

8. Erweitern Sie im daraufhin geöffneten Unterordner den Ordner OLE DB (RDO).

9. Wählen Sie im Fenster "ODBC (RDO)" entsprechend den Anweisungen unter ODBC DSN-Eintrag für die Xtreme-Musterdatenbank den richtigen ODBC DSN-Eintrag für Ihre Crystal Reports-Version aus, und klicken Sie dann auf Fertig stellen.

Der Ordner "ODBC (RDO)" wird erweitert, und Sie sehen die Xtreme-Musterdatenbank.

10. Erweitern Sie den Knoten Tabellen, und wählen Sie die Tabelle Kunde.

11. Doppelklicken Sie auf die Tabelle Kunde, um die Tabelle in den Bereich Ausgewählte Tabellen zu verschieben, und klicken Sie dann auf Weiter.

12. Erweitern Sie die Tabelle Kunde, und klicken Sie, während Sie STRG gedrückt halten, auf Kundenname, Anrede Kontakt, Adresse1, Nachname Kontakt und Ort.

13. Klicken Sie auf das Symbol >, um diese Felder in den Bereich Anzuzeigende Felder zu verschieben, und klicken Sie dann auf die Schaltfläche Weiter.

14. Wählen Sie im Bereich Verfügbare Felder unter Berichtfelder den Eintrag Kunde.Ort aus, und klicken Sie dann auf das Symbol >, um das Feld in den Bereich Gruppieren nach zu verschieben. Klicken Sie abschließend auf Fertig stellen.

    Der Bericht "CustomersByCity" wird erstellt und in das Hauptfenster von Visual Studio geladen.

Jetzt können Sie einen Parameter mit dem Namen "Ort" hinzufügen und diesen mit Standardwerten füllen.

So fügen Sie einen Parameter "Ort" hinzu

Der Feld-Explorer muss angezeigt werden, da er Zugriff auf die verschiedenen Berichtfunktionen einschließlich Parametern gewährt.

1. Wenn der Feld-Explorer nicht angezeigt wird, klicken Sie auf der Crystal Reports-Symbolleiste auf Feldansicht ein/aus.

   Anmerkung
   Sie können den Feld-Explorer auch anzeigen lassen, indem Sie in das Menü Crystal Reports wechseln und auf Feld-Explorer klicken.

2. Klicken Sie im Feld-Explorer mit der rechten Maustaste auf Parameterfelder, und wählen Sie dann Neu.

3. Im Dialogfeld Parameterfeld erstellen:

   • Setzen Sie Name auf "Ort".
   • Setzen Sie Aufforderungstext auf "Wählen Sie einen oder mehrere Orte aus".
   • Setzen Sie Werttyp auf Zeichenfolge.
   • Wählen Sie Mehrfachwerte zulassen.
   • Wählen Sie Diskrete Werte.
   • Klicken Sie auf Standardwerte.

     Anmerkung
     Solange Crystal Reports nicht auf die Vollversion aktualisiert wurde, hat diese Schaltfläche in Visual Studio .NET 2003 die Bezeichnung "Standardwerte festlegen".

4. Im Dialogfeld Standardwerte festlegen:

   • Setzen Sie Tabelle durchsuchen auf "Kunde".
   • Setzen Sie Feld durchsuchen auf "Ort".
   • Klicken Sie auf >> (doppelter Rechtspfeil), um die gesamte Ortsliste in die Liste Standardwerte zu verschieben.

5. Klicken Sie auf OK, um das Dialogfeld Standardwerte festlegen zu schließen.

6. Klicken Sie auf OK, um das Dialogfeld Parameterfeld erstellen zu schließen.

Die Standardwerte sind jetzt so konfiguriert, dass sie eine umfangreiche Ortsliste enthalten. Später in diesem Lernprogramm werden Sie über die DefaultValues-Eigenschaft der ParameterFieldDefinition-Klasse programmgesteuert auf diese Liste von Standardwerten zugreifen.

Sie verwenden jetzt den Auswahl-Assistenten, um eine Formel festzulegen, über die die Datenbankspalte "Ort" mit dem neu erstellen Parameterfeld "Ort" verbunden wird.

So verbinden Sie den Parameter "Ort" mit der Datenbankspalte "Ort"

1. Klicken Sie auf der Crystal Reports-Symbolleiste auf Auswahl-Assistent.

2. Wählen Sie im Dialogfeld Feld auswählen unter Berichtfelder erst Kunde.Ort, und klicken Sie dann auf OK.

3. Legen Sie im Dialogfeld Auswahl-Assistent innerhalb der Registerkarte Kunde.Ort für die Dropdownliste "ist gleich" fest.

4. Wählen Sie in der rechts angezeigten neuen Dropdownliste den obersten Listenbegriff {?Ort} aus, und klicken Sie dann auf OK.

<table>
<colgroup>
<col style="width: 100%" />
</colgroup>
<thead>
<tr class="header">
<th><img src="images\xkh1wxd8.alert_note(de-de,VS.90).gif" alt="Note" class="note" />Anmerkung</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td><p>In dieser Auswahl entspricht {?Ort} dem zuvor erstellten Parameter &quot;Ort&quot;.</p></td>
</tr>
</tbody>
</table>

5. Wählen Sie im Menü Datei die Option Alle speichern.

Sie können den Bericht jetzt an das CrystalReportViewer-Steuerelement binden und den Parameter "Ort" mit den beiden Ausgangswerten "Paris" und "Tokyo" festlegen.