Beispiel für eine Dateifreigabe-Datenverarbeitungserweiterung

Artikel
12/15/2008

Aktualisiert: 05. Dezember 2005

FsiDataExtension ist eine einfache Datenverarbeitungserweiterung für das Windows-Dateisystem. Diese Erweiterung verwendet die Microsoft .NET Framework-Bibliotheksklassen DirectoryInfo und FileSystemInfo, um den Inhalt einer beliebigen gültigen Netzwerkdateifreigabe abzufragen. In diesem Beispiel werden die Schnittstellen der Datenverarbeitungserweiterung sowie andere .NET Framework-Klassen verwendet. Als Benennungskonvention wird das Präfix Fsi (File Share Information, Dateifreigabeinformationen) verwendet. Dieses Beispiel wird nicht auf Itanium-basierten Betriebssystemen unterstützt.

Die SQL Server-Beispiele werden während des Setups nicht automatisch installiert. Anweisungen zum Installieren der Beispiele finden Sie unter Installieren von Beispielen.

Wichtig:
Die Beispiele dienen nur zu Lernzwecken. Sie sind nicht für die Verwendung in einer Produktionsumgebung gedacht und wurden nicht in einer Produktionsumgebung getestet. Microsoft bietet für diese Beispiele keinen technischen Support. Beispielanwendungen und Assemblys sollten nicht ohne die Erlaubnis des Systemadministrators mit der SQL Server-Datenbank oder dem Berichtsserver verbunden sein oder verwendet werden.

Die Beispiele dienen nur zu Lernzwecken. Sie sind nicht für die Verwendung in einer Produktionsumgebung gedacht und wurden nicht in einer Produktionsumgebung getestet. Microsoft bietet für diese Beispiele keinen technischen Support. Beispielanwendungen und Assemblys sollten nicht ohne die Erlaubnis des Systemadministrators mit der SQL Server-Datenbank oder dem Berichtsserver verbunden sein oder verwendet werden.

Anforderungen

Damit Sie das FsiDataExtension-Beispiel verwenden können, sollten Sie mit Microsoft Visual Studio und entweder mit Microsoft Visual C# oder Microsoft Visual Basic vertraut sein und Folgendes installiert haben:

Microsoft Visual Studio 2005 oder eine kompatible Entwicklungsumgebung (zum Anzeigen der Projektdateien)
Microsoft SQL Server 2005, einschließlich Reporting Services.
Microsoft .NET Framework, Version 2.0.
Reporting Services-Beispiele. Sie können die Beispiele beim Ausführen des SQL Server 2005-Setups installieren. Wenn Sie sich in dieser Version für die Installation der Beispiele entscheiden, wird ein separates Installationsprogramm auf Ihrem Computer installiert, mit dessen Hilfe Sie Beispiele extrahieren und installieren können. Sie können dieses Installationsprogramm über das Menü Start in der Programmgruppe Microsoft SQL Server 2005 ausführen.
Ein Berichtsserver, für den Sie in Ihrem Netzwerk die Zugriffsberechtigung haben, falls Sie mit der Beispielerweiterung zusätzliche Datenverarbeitungsfunktionen zu Ihrem Server hinzufügen möchten.

Speicherort

Dieses Beispiel befindet sich im Unterverzeichnis Extension Samples\FsiDataExtension Sample des Reporting Services-Beispielverzeichnisses.

Beispiel:

C:\Program Files\Microsoft SQL Server\90\Samples\Reporting Services\Extension Samples\FindRenderSave Sample

Erstellen des Beispiels

Verwenden Sie die folgenden Schritte, um das Beispiel zu erstellen.

Generieren Sie die Schlüsseldatei mithilfe der folgenden Anweisungen, falls Sie noch keine Schlüsseldatei mit starkem Namen erstellt haben.

So generieren Sie eine Schlüsseldatei mit starkem Namen

Öffnen Sie eine Microsoft Visual Studio 2005-Eingabeaufforderung. Klicken Sie auf Start, zeigen Sie auf Alle Programme und danach auf Microsoft .NET Framework SDK 2.0, und klicken Sie anschließend auf SDK-Eingabeaufforderung.

– oder –

Öffnen Sie eine Microsoft .NET Framework-Eingabeaufforderung. Klicken Sie auf Start, zeigen Sie auf Alle Programme und dann auf Microsoft .NET Framework SDK 2.0, und klicken Sie anschließend auf SDK-Eingabeaufforderung.

Wechseln Sie an der Eingabeaufforderung mit dem Befehl CD (Verzeichnis wechseln) im Eingabeaufforderungsfenster vom aktuellen Verzeichnis zu dem Ordner, in dem die Beispiele installiert sind.

Hinweis:
Klicken Sie auf Start, zeigen Sie auf Alle Programme, Microsoft SQL Server und auf Dokumentation und Lernprogramme, und klicken Sie dann auf Beispielordner, um den Ordner zu ermitteln, in dem sich die Beispiele befinden. Wenn das Standardverzeichnis verwendet wurde, befinden sich die Beispiele im Verzeichnis <Systemlaufwerk>:\Programme\Microsoft SQL Server\100\Samples.

Führen Sie an der Eingabeaufforderung den folgenden Befehl zum Generieren der Schlüsseldatei aus:

sn -k SampleKey.snk

Wichtig:
Weitere Informationen zum Schlüsselpaar mit starkem Namen finden Sie unter "Security Briefs: Starke Namen und Sicherheit im .NET Framework" unter ".NET-Entwicklung" auf der MSDN-Website.

So kompilieren Sie das Beispiel mit dem .NET Framework SDK

Kopieren Sie die Datei Microsoft.ReportingServices.Interfaces.dll vom Berichtsserververzeichnis \bin in Ihren Beispielordner.

Führen Sie die folgenden Befehle aus, um die Beispiel-Datenverarbeitungserweiterung Microsoft.Samples.ReportingServices.FsiDataExtension.dll zu erstellen.

csc.exe /t:library /out:Microsoft.Samples.ReportingServices.FsiDataExtension.dll *.cs .\properties\*.cs /res:.\properties\Resources.resx  /r:Microsoft.ReportingServices.Interfaces.dll

So kompilieren Sie das Beispiel mit Visual Studio .NET

Öffnen Sie die FsiDataExtension-Projektmappendatei (FsiDataExtensionCS.sln oder FsiDataExtensionVB.sln) in Visual Studio 2005.
Wählen Sie im Projektmappen-Explorer das Projekt FsiDataExtension aus.
Klicken Sie im Menü Projekt auf Verweis hinzufügen.

Das Dialogfeld Verweis hinzufügen wird geöffnet.
Klicken Sie auf die Registerkarte .NET.
Klicken Sie auf Durchsuchen, und suchen Sie auf dem lokalen Laufwerk nach Microsoft.ReportingServices.Interfaces. Standardmäßig befindet sich die Assembly im Verzeichnis ReportServer\bin. Klicken Sie auf OK.

Der ausgewählte Verweis wird dem Projekt hinzugefügt.
Klicken Sie im Menü Erstellen auf Projektmappe erstellen.

Bereitstellen des Beispiels

Nachdem Sie die vorherigen Schritte abgeschlossen haben, kann Microsoft.Samples.ReportingServices.FsiDataExtension.dll auf einem Berichtsserver oder für den Berichts-Designer zum Ausführen von Berichten für eine benutzerdefinierte Datenquelle bereitgestellt werden.

So stellen Sie das Beispiel bereit

Kopieren Sie Microsoft.Samples.ReportingServices.FsiDataExtension.dll auf den Berichtsserver. Standardmäßig werden Berichtsservererweiterungen im Verzeichnis C:\Programm\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin gespeichert.
Kopieren Sie die Assembly in den Berichts-Designer. Standardmäßig werden Erweiterungen für den Berichts-Designer im Verzeichnis C:\Programme\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies gespeichert.
Fügen Sie folgenden Eintrag den Dateien RSReportServer.config und RSReportDesigner.config unter dem Element Data (der Standardspeicherort für die Datei RSReportDesigner.config ist C:\Programme\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies, und der Standardspeicherort für die Datei RSReportServer.config ist C:\Programme\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer) hinzu:
```
<Extension Name="FSI" Type="Microsoft.Samples.ReportingServices.FsiDataExtension.FsiConnection,Microsoft.Samples.ReportingServices.FsiDataExtension"/>
```
Um den Designer für generische Abfragen für die Beispiel-Datenverarbeitungserweiterung zu aktivieren, fügen Sie unter <Designer> den folgenden Eintrag zur Datei RSReportDesigner.config hinzu.
```
<Extension Name="FSI" Type="Microsoft.ReportingServices.QueryDesigners.VDTQueryDesigner,Microsoft.ReportingServices.QueryDesigners"/>
```

Weitere Informationen zum Bereitstellen von Datenverarbeitungserweiterungen finden Sie unter Deploying a Data Processing Extension.

So konfigurieren Sie die Codezugriffssicherheit für das Beispiel

Öffnen Sie die Richtlinienkonfigurationsdatei für den Berichtsserver (rssrvpolicy.config). Standardmäßig wird die Datei im Verzeichnis C:\Programme\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer gespeichert.

Den Datenverarbeitungserweiterungen muss volle Vertrauenswürdigkeit erteilt werden. Fügen Sie hierzu am Ende des Codegruppenabschnitts in der Konfigurationsdatei die folgenden Codegruppeninformationen hinzu:

<CodeGroup class="UnionCodeGroup"
   version="1"
   PermissionSetName="FullTrust"
   Name="FSICodeGroup"
   Description="Code group for my FSI data processing extension">
      <IMembershipCondition class="UrlMembershipCondition"
         version="1"
         Url="C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin\Microsoft.Samples.ReportingServices.FsiDataExtension.dll"
       />
</CodeGroup>

Wenn Sie die Beispiel-Datenverarbeitungserweiterung im Berichts-Designer verwenden, wiederholen Sie die Schritte 1 und 2 mit der Richtlinienkonfigurationsdatei für die Vorschau im Berichts-Designer (rspreviewpolicy.config) und der folgenden Codegruppe:
```
<CodeGroup class="UnionCodeGroup"
   version="1"
   PermissionSetName="FullTrust"
   Name="FSICodeGroup"
   Description="Code group for my FSI data processing extension">
      <IMembershipCondition class="UrlMembershipCondition"
         version="1"
         Url="C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies\Microsoft.Samples.ReportingServices.FsiDataExtension.dll"
       />
</CodeGroup>
```
Standardmäßig wird die Datei rspreviewpolicy.config im Verzeichnis C:\Programme\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies gespeichert.

Weitere Informationen zur .NET Framework-Sicherheit und zu Reporting Services finden Sie unter Understanding Code Access Security in Reporting Services.

Erstellen eines Berichts, der FsiDataExtension verwendet

Dieser Abschnitt enthält kurze exemplarische Vorgehensweisen für das Erstellen eines Beispielberichts, der die Beispieldatenerweiterung verwendet.

Hinweis:
Sie müssen das Beispiel einer Dateifreigabe-Datenerweiterung im Berichts-Designer und auf dem Berichtsserver bereitstellen, bevor Sie einen Bericht erstellen. Darüber hinaus müssen Sie den Designer für generische Abfragen für die Erweiterung aktivieren. Weitere Informationen finden Sie weiter oben in den Erläuterungen zum Bereitstellen von FsiDataExtension.

So erstellen Sie das Berichtsprojekt

Klicken Sie auf Start, zeigen Sie auf Programme, zeigen Sie auf Microsoft SQL Server 2005, und klicken Sie dann auf Business Intelligence Development Studio.
Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
Klicken Sie in der Liste Projekttypen auf Business Intelligence-Projekte.
Klicken Sie in der Liste Vorlagen auf Berichtsserverprojekt.
Geben Sie FsiReportProject in das Feld Name ein.
Klicken Sie auf OK, um das Berichtsprojekt zu erstellen.

So erstellen Sie den Bericht

Klicken Sie im Menü Projekt auf Neues Element hinzufügen.
Klicken Sie in der Liste Kategorien auf Berichtsprojekt.
Klicken Sie in der Liste Vorlagen auf Bericht.
Geben Sie FsiReport in das Feld Name ein, und klicken Sie dann auf Öffnen.

So fügen Sie eine Datenquelle hinzu, die die Beispieldatenerweiterung verwendet

Wählen Sie in der Datenansicht unter Dataset die Option <Neues Dataset...> aus.

Das Dialogfeld Datenquelle wird geöffnet.
Geben Sie auf der Registerkarte Allgemein in das Textfeld Name die Zeichenfolge FsiDataSource ein.
Wählen Sie in der Liste Typ die Option Dateifreigabeinformationen aus.
Lassen Sie ConnectionString leer. Die Beispieldatenerweiterung verwendet keine Verbindungszeichenfolge.

Klicken Sie auf der Registerkarte Anmeldeinformationen auf einen der Serveranmeldetypen. Sie können den Benutzernamen und das Kennwort für die Dateifreigabe eingeben, auf die die Beispieldatenerweiterung zugreifen wird. Klicken Sie auf Windows-Authentifizierung verwenden (Integrierte Sicherheit), klicken Sie auf Verwenden Sie einen bestimmten Benutzernamen und ein bestimmtes Kennwort, und geben Sie Anmeldeinformationen ein, oder klicken Sie auf Anmeldeinformationen anfordern, und geben Sie eine Eingabeaufforderungs-Zeichenfolge ein.

Sicherheitshinweis:
Verwenden Sie nach Möglichkeit die Windows-Authentifizierung. Sie werden bei jedem Zugriff auf eine Netzwerkdateifreigabe zur Eingabe von Netzwerkanmeldeinformationen aufgefordert, es sei denn, Ihre Anmeldeinformationen wurden zwischengespeichert.

Klicken Sie auf OK, um die Datenquelle zu speichern.

So zeigen Sie das Dataset an

In der Datenansicht wird der Designer für generische Abfragen angezeigt. Wählen Sie in Befehlstyp die Option Text aus.
Geben Sie im Abfragebereich direkt unter der Symbolleiste des Designers für generische Abfragen den Pfad zu einer Netzwerk-Dateifreigabe ein, die in Ihrem Netzwerk verfügbar ist. Geben Sie z. B. \\Computer1\Public ein.
Klicken Sie auf der Symbolleiste des Designers für generische Abfragen auf die Schaltfläche Ausführen (!).

Die Dateifreigabe sollte im Ergebnisbereich darunter angezeigt werden.

So entwerfen Sie das Berichtslayout

Klicken Sie in der Layoutansicht in der Toolbox auf Tabelle.
Ziehen Sie das Steuerelement Tabelle auf die Entwurfsoberfläche.
Ziehen Sie im Fenster Felder das Feld Name in die erste Zelle in der Reihe Detail. Fügen Sie bei Bedarf der Tabelle zusätzliche Felder hinzu.

So zeigen Sie eine Vorschau des Berichts an

Klicken Sie auf die Registerkarte Vorschau, um eine Vorschau des Berichts anzuzeigen. Je nach Ihren Einstellungen für die Anmeldeinformationen für FsiDataSource müssen Sie möglicherweise einen Benutzernamen und ein Kennwort eingeben.

Siehe auch

Änderungsverlauf

Version	Verlauf
05. Dezember 2005	Geänderter Inhalt: Die Anweisungen zum Generieren einer Schlüsseldatei wurden geändert, einschließlich des Namens und Speicherortes der Schlüsseldatei.

Freigeben über