Binden an Crystal Enterprise (Crystal Reports 10 und höher)

Anmerkung
Auf dieser Seite werden Funktionen beschrieben, die nicht in Crystal Reports für Visual Studio, jedoch in einer der aktualisierten Versionen verfügbar sind. Weitere Informationen zu Crystal Reports für Visual Studio finden Sie unter Was ist Crystal Reports für Visual Studio? Weitere Informationen zu aktualisierten Versionen finden Sie unter Aktualisierungsoptionen.

Objektmodell

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

Ort des Berichts

Berichte befinden sich auf dem verwalteten RAS-Server (siehe Report Application Server (RAS)). Berichte sind in die ReportDocument-Klasse eingeschlossen.

Ü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 "Crystal Enterprise" des Knotens "Crystal Services" in Crystal Reports Developer behandelt.

[SERVERNAME]

• Crystal Services
  • Crystal Enterprise

Beschreibung

Über den Unterknoten "Crystal Enterprise" greifen Sie auf Berichte zu, die von einem verwalteten RAS-Server in Crystal Enterprise verfügbar gemacht wurden, und lassen sie anzeigen.

Durch den Knoten "Crystal Services">"Crystal Enterprise" werden Berichte von Crystal Enterprise über den verwalteten RAS-Server verfügbar gemacht. Der Knoten "Crystal Enterprise" ist funktionsbereit. Wenn Crystal Enterprise jedoch nicht auf dem Entwicklungscomputer installiert wurde, rufen Sie die Eigenschaften dieses Knotens auf, und legen Sie den Crystal Enterprise-Servernamen im Netzwerk fest.

Wenn Sie einen Bericht vom Knoten "Crystal Services>"Crystal Enterprise" ziehen und auf einem Web Form oder Windows Form ablegen, wird eine Instanz von ReportDocument generiert. Die ReportDocument-Klasse funktioniert als Wrapperklasse und hat den Zweck, den Bericht einzuschließen (darzustellen), der vom RAS-Server innerhalb von Crystal Enterprise übergeben wird.

Eine Vergleichstabelle zu "Crystal Services" finden Sie unter einem der folgenden Themen:

• CrystalReportViewer-Bindungsszenarien mit Verwendung von Crystal Services
• ReportDocument-Bindungsszenarien mit Verwendung von Crystal Services (VS .NET 2002 und 2003).

Eine Übersicht der von Crystal Enterprise unterstützten Berichtbindungsszenarien finden Sie unter Zusammenfassung empfohlener Szenarien.

Pro

• Einfacher Zugriff: Leichter Zugriff auf RAS-Berichte innerhalb von Crystal Enterprise über eine Webanwendung.
• Umfangreiche programmatische Interaktion: Bietet Zugriff auf das leistungsfähige ReportDocument-Objektmodell. Die Wrapperklasse des Berichts in dieser Version ist ReportDocument. Dies ist die erste Version von Crystal Services, die Ihnen Zugriff auf das ReportDocument-Objektmodell gewährt.

Contra

• Indirektere Codierung: Die Codierung ist nicht so direkt wie die Codierung von RAS-Berichten mit dem ReportClientDocument-Objektmodell. Siehe Binden an verwalteten RAS-Server mit der ReportAppFactory.OpenDocument()-Methode.

So verwenden Sie "Crystal Services">"Crystal Enterprise"

• Crystal Reports 10 oder XI wurde installiert und ist funktionsbereit.

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. Öffnen Sie in Visual Studio Server-Explorer.

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

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

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

   Anmerkung

   Wenn ein Crystal Enterprise-Bericht in das Formular eingefügt wird, wird dem Bereich "Vom Designer generierter Code" des Formulars eine Instanz der ReportDocument-Klasse hinzugefügt. Wenn Klassen, die von System.ComponentModel.Component erben (wie ReportDocument), 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.

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

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

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

``` vb
myCrystalReportViewer.ReportSource = reportDocument1
```

``` csharp
crystalReportViewer.ReportSource = reportDocument1;
```

6. Erstellen und führen Sie das Webprojekt aus, um den Bericht anzeigen zu lassen.

Siehe auch

• Durch Aktualisierung verfügbare Objektmodelle