Binden an Crystal Enterprise (Crystal Reports 9)

NoteAnmerkung

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. Dieses Szenario ist nur für Crystal Reports 9 gültig.

Dieses Bindungsszenario verweist auf eine ältere Technologie und ist für Anwender mit einer vorhandenen Crystal Enterprise-Installation gedacht. Crystal Enterprise wurde durch Crystal Reports Server und BusinessObjects Enterprise ersetzt. Weitere Informationen zu Crystal Reports Server und BusinessObjects Enterprise finden Sie unter Aktualisierungsoptionen.

Objektmodell

In diesem Berichtbindungsszenario wird die Berichtbindung mit CrystalReportViewer-Objektmodell verwendet.

Ort des Berichts

Der Bericht befindet sich auf dem verwalteten RAS-Server (siehe Report Application Server (RAS)). Der Bericht wird von der EnterpriseReportDocument-Klasse eingeschlossen.

Übersicht über Crystal Services

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

NoteAnmerkung

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 9 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.

Wenn Sie einen Bericht vom Knoten "Crystal Services">"Crystal Enterprise" ziehen und auf einem Web Form oder Windows Form ablegen, wird eine Instanz von EnterpriseReportDocument generiert. Die EnterpriseReportDocument-Klasse hat die Funktion einer Wrapperklasse. Ihre Aufgabe ist es, den vom verwalteten RAS-Server übergebenen Bericht einzuschließen (darzustellen).

Dieses Bindungsszenario wurde in Crystal Reports 10 durch das folgende Berichtbindungsszenario ersetzt:

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

Pro

  • Unkomplizierter Zugriff: Einfacher Zugriff auf die Berichte des verwalteten RAS-Servers von einer Web- oder Windows-Anwendung aus.

Contra

Im Hinblick auf die Objektmodellinteraktion ist dieses Modell nicht besonders effektiv:

  • Die Wrapperklasse EnterpriseReportDocument wird nur verwendet, um den Bericht an den verwalteten RAS-Server zu übergeben bzw. von ihm zu empfangen; sie enthält kein Objektmodell.
  • Daher bietet dieses Bindungsszenario nur das begrenzte, in CrystalReportViewer enthaltene Objektmodell. Siehe Welches Objektmodell sollte verwendet werden?.

Eine anspruchsvollere Lösung zum Binden von RAS-Berichten ist unter Binden an unverwalteten RAS mit der ReportDocument.Load()-Methode beschrieben.

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

  • Crystal Enterprise 9 wurde installiert und ist funktionsbereit.
  • Crystal Enterprise wurde installiert und ist funktionsbereit.
  • Crystal Enterprise SDK (einschließlich der .NET-Assemblys) wurde installiert und ist funktionsbereit.
    NoteAnmerkung

    Wenn Sie Crystal Enterprise auf Ihrem Entwicklungscomputer installiert haben, ist das SDK in dieser Installation enthalten.

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.

<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>Der Knoten &quot;Crystal Enterprise&quot; ist nur bei Installation von Crystal Enterprise auswählbar.</p></td>
</tr>
</tbody>
</table>
  1. Wählen Sie einen Bericht aus der Struktur Crystal Enterprise aus, und ziehen Sie ihn auf Ihr Web Form oder Windows Form.
Im unteren Bereich der Formulars in der Entwurfsansicht wird ein enterpriseReportDocument1-Objekt angezeigt.

Wenn Klassen, die von System.ComponentModel.Component erben (wie EnterpriseReportDocument), 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.

<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>Wenn ein Crystal Enterprise-Bericht in einem Formular abgelegt wird, wird dem Bereich &quot;Vom Designer generierter Code&quot; eine Instanz der EnterpriseReportDocument-Klasse hinzugefügt.</p></td>
</tr>
</tbody>
</table>
  1. Wechseln Sie zur Codeansicht, und öffnen Sie den Bereich Vom Web/Windows Form-Designer generierter Code.
<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>Innerhalb dieses Bereichs wurde eine EnterpriseReportDocument-Klasse instantiiert und konfiguriert.</p></td>
</tr>
</tbody>
</table>

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

    myCrystalReportViewer.ReportSource = enterpriseReportDocument1

    crystalReportViewer.ReportSource = enterpriseReportDocument1;

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

  • Last updated on