Binden an Serverdateien (VS .NET 2003)

Objektmodell

In diesem Berichtbindungsszenario wird CrystalReportViewer verwendet (siehe Berichtbindung mit CrystalReportViewer-Objektmodell).

Ort des Berichts

Die Berichte befinden sich in einem Berichtordner im lokalen Dateiverzeichnis (siehe Verzeichnis "Samples"). Berichte an diesem Speicherort werden als Berichtswebdienste verfügbar gemacht.

Übersicht über Crystal Services

Dieses Berichtbindungsszenario bezieht sich auf Berichte, auf die über den Serverknoten "Crystal Services" im Server-Explorer zugegriffen wird.

Anmerkung
Eine Übersicht der Crystal Services finden Sie unter Verwenden von Crystal Services.

In diesem Abschnitt wird der Unterknoten "Serverdateien" des Knotens "Crystal Services" in Visual Studio .NET 2003 behandelt.

[SERVERNAME]

• Crystal Services
  • Serverdateien

Beschreibung

Über den Unterknoten "Serverdateien" greifen Sie auf Berichte zu, die als Berichtswebdienste aus einem lokalen Dateiverzeichnis verfügbar gemacht wurden, und lassen sie anzeigen. Diese Berichte werden unter Verwendung des Berichtswebdienstprotokolls verfügbar gemacht. Um in Visual Studio .NET 2003 auf die Serverdateien zuzugreifen, klicken Sie unter "Crystal Services" auf den Knoten "Serverdateien".

Eine Vergleichstabelle zu Crystal Services finden Sie unter CrystalReportViewer-Bindungsszenarien mit Verwendung von Crystal Services und unter ReportDocument-Bindungsszenarien mit Verwendung von Crystal Services (VS .NET 2002 und 2003).

Der Unterknoten "Serverdateien" des Knotens "Crystal Services" wird in Crystal Reports 9 und 10 durch andere Unterknoten von "Crystal Services" ersetzt, über die eine direkte Verbindung zu einem Report Application Server (RAS)-Server hergestellt wird. Dabei wird das Berichtswebdienst-Protokoll umgangen:

• Binden an Report Application Server (Crystal Reports 9 und höher)
• Binden an Report Application Server (Crystal Reports 10 und höher)

Pro

• Zentraler Zugriff auf Berichte: Bietet einen zentralen Zugriffspunkt auf alle Berichte in Ihrem Musterberichtverzeichnis (siehe Verzeichnis "Samples"), wodurch ein effizientes Bericht-Repository auf Ihrem lokalen Festplattenlaufwerk entsteht.

Contra

• Wurde in Crystal Reports 9 und 10 durch den Knoten "Crystal Services" für einen unverwalteten RAS ersetzt. Weitere Einzelheiten können Sie dem Abschnitt "Beschreibung" oben entnehmen.
• Begrenztes Objektmodell: Dieses Bindungsszenario bietet nur das begrenzte Objektmodell, das Teil des CrystalReportViewer-Steuerelements ist. Siehe Welches Objektmodell sollte verwendet werden?.

Konfigurieren von Serverdateien

"Serverdateien" ist in Crystal Reports für Visual Studio 2003 als Knoten "Crystal Services" enthalten. Wenn Crystal Reports 9 oder 10 (die Vollversionen) über der in Visual Studio 2003 enthaltenen Version installiert wird, wird der Knoten "Serverdateien" als sichtbarer Knoten entfernt.

Jede Edition von Was ist Crystal Reports für Visual Studio? unterstützt weiterhin "Serverdateien" im SDK. Um in dieser Version mit "Serverdateien" zu arbeiten, ist jedoch eine manuelle Codierung erforderlich.

Ausführliche Informationen zur Konfiguration der Serverdateien finden Sie unter Konfigurieren von Serverdateien in Crystal Services.

So installieren Sie Crystal Services

Crystal Reports für Visual Studio .Net 2003 muss installiert sein.

Crystal Services werden bei der Installation von Visual Studio .NET 2003 nicht standardmäßig installiert. In diesem Arbeitsschritt installieren Sie Crystal Services von der Visual Studio .Net 2003-Installations-CD.

1. Suchen Sie auf der Microsoft Visual Studio .NET-Installations-CD Crystal Reports.
2. Wählen Sie "Crystal Services".
3. Klicken Sie auf die Schaltfläche "Aktualisieren".

So verwenden Sie den Knoten "Crystal Services" > "Serverdateien"

• Crystal Reports für Visual Studio .NET 2003 oder wurde installiert und ist funktionsbereit.
• Oder Crystal Reports 9 oder höher wurde installiert und ist funktionsbereit.

  Anmerkung
  In Crystal Reports 9 und 10 wurde "Serverdateien" ersetzt (der Knoten wird nicht mehr als Knoten unterhalb von "Crystal Services" angezeigt). Sie können Serverdateien jedoch weiterhin manuell codieren.

Anmerkung
Diese Prozedur funktioniert nur bei Projekten, die in Projekt-Setup erstellt wurden. Projekt-Setup enthält spezifische Namespaceverweise und Codekonfigurationen, die für diese Prozedur erforderlich sind. Die Prozedur kann ohne diese Konfiguration nicht ausgeführt werden. Führen Sie deshalb vor Beginn dieser Arbeitsschritte die Schritte unter Projekt-Setup aus.

1. Klicken Sie im Menü "Ansicht" auf Weitere Fenster und dann auf Server-Explorer.

2. Erweitern Sie zunächst Crystal Services und dann Serverdateien.

3. Wählen Sie einen Bericht aus der Struktur Serverdateien aus, und ziehen Sie ihn auf das Formular.

   Anmerkung

   Wenn ein Bericht aus der Struktur "Serverdateien" in einem Formular abgelegt wird, wird dem Bereich "Vom Designer generierter Code" Ihres Formulars eine Instanz der ServerFileReport-Klasse hinzugefügt. Wenn Klassen, die von System.ComponentModel.Component erben (wie ServerFileReport), innerhalb des Bereichs "Vom Designer generierter Code" instantiiert und konfiguriert werden, wird im unteren Bereich des Formulars in der Entwurfsansicht ein Symbol dieser instantiierten Klasse angezeigt.

   Im unteren Bereich des Formulars der Entwurfsansicht wird ein serverFileReport1-Objekt angezeigt.

4. Wechseln Sie zur Codeansicht, und öffnen Sie den Bereich Vom Web/Windows Form-Designer generierter Code.

   Innerhalb dieses Bereichs wurde eine ServerFileReport-Klasse instantiiert und konfiguriert.

5. Weisen Sie der ReportSource-Eigenschaft des CrystalReportViewer-Steuerelements innerhalb der (im Projekt-Setup erstellten) ConfigureCrystalReports()-Methode die ServerFileReport-Instanz zu.

   myCrystalReportViewer.ReportSource = serverFileReport1
   

   crystalReportViewer.ReportSource = serverFileReport1;
   

Um den Bericht anzeigen zu lassen, erstellen Sie Ihr Projekt und führen es aus.

So codieren Sie die Serverdateien manuell

• Crystal Reports für Visual Studio .NET 2003 oder wurde installiert und ist funktionsbereit.
• Oder Crystal Reports 9 oder höher wurde installiert und ist funktionsbereit.

  Anmerkung
  In Crystal Reports 9 und 10 wurde "Serverdateien" ersetzt (der Knoten wird nicht mehr als Knoten unterhalb von "Crystal Services" angezeigt). Sie können Serverdateien jedoch weiterhin manuell codieren.

Anmerkung
Diese Prozedur funktioniert nur bei Projekten, die in Projekt-Setup erstellt wurden. Projekt-Setup enthält spezifische Namespaceverweise und Codekonfigurationen, die für diese Prozedur erforderlich sind. Die Prozedur kann ohne diese Konfiguration nicht ausgeführt werden. Führen Sie deshalb vor Beginn dieser Arbeitsschritte die Schritte unter Projekt-Setup aus.

1. Deklarieren Sie innerhalb der (im Projekt-Setup erstellten) ConfigureCrystalReports()-Methode eine Instanz von ServerFileReport.

   Dim myServerFileReport As CrystalDecisions.Shared.ServerFileReport = _
   New CrystalDecisions.Shared.ServerFileReport()
   

   CrystalDecisions.Shared.ServerFileReport serverFileReport = new CrystalDecisions.Shared.ServerFileReport();
   

2. Setzen Sie die ObjectType-Eigenschaft von ServerFileReport auf REPORT.

   myServerFileReport.ObjectType = CrystalDecisions.[Shared].EnumServerFileType.REPORT
   

   serverFileReport.ObjectType = CrystalDecisions.Shared.EnumServerFileType.REPORT;
   

3. Legen Sie für die ReportPath-Eigenschaft von ServerFileReport den Bericht und sein Unterverzeichnis fest. Informationen zu Musterberichten finden Sie unter Verzeichnis "Samples".

   myServerFileReport.ReportPath = "\General Business\World Sales Report.rpt"
   

   serverFileReport.ReportPath = "\\General Business\\World Sales Report.rpt";
   

4. Legen Sie für die WebServiceURL-Eigenschaft von ServerFileReport das virtuelle Viewerverzeichnis Ihrer installierten Crystal Reports-Version fest, siehe Virtuelles Viewerverzeichnis.

   Anmerkung
   In diesem Codebeispiel ist das virtuelle Viewerverzeichnis für Crystal Reports 10 konfiguriert.

   myServerFileReport.WebServiceUrl = "https://localhost/crystalreportviewers10/ServerFileReportService.asmx"
   

   serverFileReport.WebServiceUrl = "https://localhost/crystalreportviewers10/ServerFileReportService.asmx";
   

5. Legen Sie für die ReportSource-Eigenschaft des CrystalReportViewer-Steuerelements die ServerFileReport-Instanz fest.

   myCrystalReportViewer.ReportSource = myServerFileReport
   

   crystalReportViewer.ReportSource = serverFileReport1;
   

Siehe auch

• Binden an Crystal Enterprise (VS .NET 2003)