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

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.

Objektmodell

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

Ort des Berichts

Der Bericht befindet sich auf dem unverwalteten 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 "Report Application Server" des Knotens "Crystal Services" in Crystal Reports 9 behandelt.

[SERVERNAME]

  • Crystal Services
    • Report Application Server

Beschreibung

Über den Unterknoten "Report Application Server" greifen Sie auf Berichte zu, die von einem unverwalteten RAS-Server verfügbar gemacht wurden, und lassen sie anzeigen.

Wenn Sie einen Bericht vom Knoten "Crystal Services">"Report Application Server" auf ein Web Form oder Windows Form ziehen und dort ablegen, wird eine Instanz von EnterpriseReportDocument generiert. Die EnterpriseReportDocument-Klasse hat die Funktion einer Wrapperklasse. Ihre Aufgabe ist es, den vom unverwalteten 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:

Eine anspruchsvollere Lösung zum Binden von Report Application Server (RAS)-Berichten ist im Berichtbindungsszenario Binden an unverwalteten RAS mit der ReportDocument.Load()-Methode beschrieben.

Pro

  • Unkomplizierter Zugriff: Berichte vom unverwalteten RAS-Server können problemlos in einer Strukturansicht angezeigt und auf ein Web Form gezogen werden.

Contra

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

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

So verwenden Sie "Crystal Services" > "Report Application Server"

  • Crystal Enterprise 9 wurde installiert und ist funktionsbereit.
  • Der unverwaltete Report Application Server (RAS) ist installiert und funktionsbereit.
NoteAnmerkung

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

<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 Crystal Reports 9 werden unter dem Knoten &quot;Serverdateien&quot; Berichte für den RAS-Server und nicht Berichte aus dem lokalen Dateiverzeichnis angezeigt.</p></td>
</tr>
</tbody>
</table>

  1. Wählen Sie einen Bericht aus der Struktur Serverdateien aus, und ziehen Sie ihn auf Ihr Web Form oder Windows Form.

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

    NoteAnmerkung

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

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

``` vb
myCrystalReportViewer.ReportSource = enterpriseReportDocument1
```

``` csharp
crystalReportViewer.ReportSource = enterpriseReportDocument1;
```
  1. Um den Bericht anzeigen zu lassen, erstellen Sie Ihr Projekt und führen es aus.

Siehe auch

  • Last updated on