Estensione di esempio per l'elaborazione dati da una condivisione file

Articolo
12/15/2008

Data aggiornamento: 5 dicembre 2005

FsiDataExtension è un'estensione di esempio semplice per l'elaborazione dati per il file system di Windows, che utilizza le classi DirectoryInfo e FileSystemInfo della libreria Microsoft .NET Framework per eseguire query sul contenuto di qualsiasi condivisione file di rete valida. Nell'esempio vengono utilizzate interfacce dell'estensione per l'elaborazione dati e altre classi di .NET Framework. Per l'esempio viene utilizzata la convenzione di denominazione basata sul prefisso "Fsi" (File Share Information). Questo esempio non è supportato nei sistemi operativi basati su processori Itanium.

Gli esempi di SQL Server non vengono installati automaticamente durante l'installazione. Per informazioni sulle procedure di installazione degli esempi, vedere Installazione degli esempi.

Importante:
Gli esempi vengono offerti esclusivamente a scopo didattico. Non sono progettati per l'utilizzo in un ambiente di produzione e non sono stati testati in un ambiente di produzione. Microsoft non fornisce servizi di supporto tecnico per questi esempi. Le applicazioni e gli assembly di esempio non devono essere connessi o utilizzati con il database di SQL Server o il server di report in un ambiente di produzione senza l'autorizzazione dell'amministratore di sistema.

Gli esempi vengono offerti esclusivamente a scopo didattico. Non sono progettati per l'utilizzo in un ambiente di produzione e non sono stati testati in un ambiente di produzione. Microsoft non fornisce servizi di supporto tecnico per questi esempi. Le applicazioni e gli assembly di esempio non devono essere connessi o utilizzati con il database di SQL Server o il server di report in un ambiente di produzione senza l'autorizzazione dell'amministratore di sistema.

Requisiti

Per utilizzare l'esempio FsiDataExtension, è necessario avere familiarità con Microsoft Visual Studio e Microsoft Visual C# o Microsoft Visual Basic e deve essere installato quanto segue:

Microsoft Visual Studio 2005 o ambiente di sviluppo compatibile (per la visualizzazione dei file di progetto).
Microsoft SQL Server 2005 con Reporting Services.
Microsoft .NET Framework versione 2.0.
Esempi di Reporting Services. È possibile scegliere di installare gli esempi durante l'installazione di SQL Server 2005. Con questa versione, se si sceglie di installare gli esempi, nel computer viene installato un programma di installazione distinto che consente di estrarre e installare gli esempi. È possibile eseguire il programma di installazione dal menu di avvio nel gruppo di programmi Microsoft SQL Server 2005.
Un server di report per cui si dispone di autorizzazioni di accesso in rete, se si intende utilizzare l'estensione di esempio per aggiungere ulteriori funzionalità di elaborazione dati al server.

Percorso

L'esempio è disponibile nella sottodirectory Extension Samples\FsiDataExtension Sample della directory degli esempi di Reporting Services.

Ad esempio:

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

Generazione dell'esempio

Eseguire la procedura seguente per generare l'esempio.

Se non è stato ancora creato un file di chiave con nome sicuro, generare il file di chiave seguendo le istruzioni seguenti.

Per generare un file di chiave con nome sicuro

Aprire il prompt dei comandi di Microsoft Visual Studio 2005. Fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft .NET Framework SDK 2.0, quindi SDK Command Prompt.

-- oppure --

Aprire il prompt dei comandi di Microsoft .NET Framework. Fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft .NET Framework SDK 2.0, quindi SDK Command Prompt.
Utilizzare il comando CD (change directory) per passare dalla directory corrente della finestra del prompt dei comandi alla cartella in cui sono stati installati gli esempi.

[!NOTA] Per determinare la cartella in cui si trovano gli esempi, fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft SQL Server 2005, Documentazione ed esercitazioni, quindi Samples. Se è stato utilizzato il percorso di installazione predefinito, gli esempi si troveranno in <unità_sistema>:\Programmi\Microsoft SQL Server\100\Samples.

Al prompt dei comandi digitare il comando seguente per generare il file di chiave:

sn -k SampleKey.snk

Importante:
Per ulteriori informazioni sulla coppia di chiavi con nome sicuro, vedere l'argomento relativo ai nomi sicuri e alla protezione in .NET Framework nel centro per sviluppatori di .NET su MSDN.

Per compilare l'esempio mediante .NET Framework SDK

Copiare Microsoft.ReportingServices.Interfaces.dll dalla directory \bin del server di report nella cartella degli esempi.

Per creare la libreria Microsoft.Samples.ReportingServices.FsiDataExtension.dll dell'estensione di esempio per l'elaborazione dati, eseguire i comandi seguenti.

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

Per compilare l'esempio mediante Visual Studio .NET

Aprire il file di soluzione FsiDataExtension (FsiDataExtensionCS.sln o FsiDataExtensionVB.sln) in Visual Studio 2005.
In Esplora soluzioni selezionare il progetto FsiDataExtension.
Scegliere Aggiungi riferimento dal menu Progetto.

Verrà visualizzata la finestra di dialogo Aggiungi riferimento.
Fare clic sulla scheda .NET.
Fare clic su Sfoglia e individuare Microsoft.ReportingServices.Interfaces nell'unità locale. Per impostazione predefinita, l'assembly è disponibile nella directory ReportServer\bin. Fare clic su OK.

Il riferimento selezionato verrà aggiunto al progetto.
Scegliere Genera soluzione dal menu Genera.

Distribuzione dell'esempio

Dopo aver completato i passaggi precedenti, è possibile distribuire Microsoft.Samples.ReportingServices.FsiDataExtension.dll in un server di report o in Progettazione report per l'esecuzione di report con un'origine dei dati personalizzata.

Per distribuire l'esempio

Copiare Microsoft.Samples.ReportingServices.FsiDataExtension.dll nel server di report. Il percorso predefinito delle estensioni del server di report è C:\Programmi\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin.
Copiare l'assembly in Progettazione report. Il percorso predefinito delle estensioni per Progettazione report è C:\Programmi\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies.
Nell'elemento Data all'interno dei file RSReportServer.config e RSReportDesigner.config (il percorso predefinito del file RSReportDesigner.config è C:\Programmi\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies, mentre quello del file RSReportServer.config è C:\Programmi\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer) aggiungere la voce seguente:
```
<Extension Name="FSI" Type="Microsoft.Samples.ReportingServices.FsiDataExtension.FsiConnection,Microsoft.Samples.ReportingServices.FsiDataExtension"/>
```
Per attivare Progettazione query standard per l'estensione di elaborazione dei dati di esempio, aggiungere la voce seguente nell'elemento <Designer> del file RSReportDesigner.config.
```
<Extension Name="FSI" Type="Microsoft.ReportingServices.QueryDesigners.VDTQueryDesigner,Microsoft.ReportingServices.QueryDesigners"/>
```

Per ulteriori informazioni sulla distribuzione di estensioni per l'elaborazione dati, vedere Deploying a Data Processing Extension.

Per configurare la protezione per l'accesso al codice dell'esempio

Aprire il file di configurazione dei criteri del server di report (rssrvpolicy.config). Il percorso predefinito del file è C:\Programmi\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer.

Le estensioni per l'elaborazione dei dati devono avere attendibilità totale. A questo scopo, aggiungere il gruppo di codice seguente alla fine della sezione dei gruppi di codice nel file di configurazione:

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

Se si utilizza l'estensione di esempio per l'elaborazione dati in Progettazione report, ripetere i passaggi 1 e 2 utilizzando il file di configurazione dei criteri di Progettazione report (rspreviewpolicy.config) e il gruppo di codice seguente:
```
<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>
```
Il percorso predefinito del file rspreviewpolicy.config è C:\Programmi\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies.

Per ulteriori informazioni sulla protezione .NET Framework e su Reporting Services, vedere Understanding Code Access Security in Reporting Services.

Creazione di un report che utilizza FsiDataExtension

In questa sezione è disponibile un'esercitazione rapida che illustra come creare un report di esempio che utilizza l'estensione di esempio per i dati.

[!NOTA] Prima di creare un report, è necessario distribuire l'estensione di esempio per i dati di una condivisione file in Progettazione report e nel server di report. È inoltre necessario attivare lo strumento Progettazione query standard per l'estensione. Per ulteriori informazioni, vedere "Distribuzione dell'esempio" più indietro in questo argomento.

Per creare il progetto report

Fare clic sul pulsante Start, scegliere Programmi, Microsoft SQL Server 2005 e quindi Business Intelligence Development Studio.
Scegliere Nuovo dal menu File e quindi fare clic su Progetto.
Nell'elenco Tipi progetto fare clic su Progetti Business Intelligence.
Nell'elenco Modelli fare clic su Progetto Server report.
Nella casella Nome digitare FsiReportProject.
Fare clic su OK per creare il progetto report.

Per creare il report

Scegliere Aggiungi nuovo elemento dal menu Progetto.
Nell'elenco Categorie fare clic su Progetto report.
Nell'elenco Modelli fare clic su Report.
Nella casella Nome digitare FsiReport e quindi fare clic su Apri.

Per aggiungere un'origine dei dati che utilizza l'estensione di esempio per i dati

In visualizzazione Dati selezionare <Nuovo set di dati...> in Set di dati.

Verrà visualizzata la finestra di dialogo Origine dati.
Nella casella di testo Nome della scheda Generale digitare FsiDataSource.
Nell'elenco Tipo selezionare File Share Information.
Lasciare vuota la casella Stringa di connessione. L'estensione di esempio per i dati non utilizza alcuna stringa di connessione.

Nella scheda Credenziali fare clic su uno dei tipi di accesso al server. È possibile specificare il nome utente e la password relativi alla condivisione file a cui accede l'estensione di esempio per i dati. Fare clic su Usa autenticazione di Windows (protezione integrata), quindi su Usa nome utente e password specifici e immettere le credenziali oppure fare clic su Richiedi credenziali e immettere una stringa di richiesta.

Nota sulla protezione:
Se possibile, utilizzare l'autenticazione di Windows. Verranno richieste le credenziali di rete ogni volta che si tenta di accedere a una condivisione file di rete, se tali credenziali non sono state memorizzate nella cache.

Fare clic su OK per salvare l'origine dei dati.

Per visualizzare il set di dati

In visualizzazione Dati è disponibile lo strumento Progettazione query standard. Nella casella Tipo di comando selezionare Text.
Nel riquadro Query, immediatamente sotto la barra degli strumenti di Progettazione query standard, immettere il percorso di una condivisione file di rete disponibile in rete. Digitare ad esempio \\Computer1\Public.
Sulla barra degli strumenti di Progettazione query standard fare clic sul pulsante Esegui (!).

I dati della condivisione file verranno visualizzati nel riquadro Risultati sottostante.

Per progettare il layout del report

In visualizzazione Layout fare clic su Tabella nella casella degli strumenti.
Trascinare il controllo Tabella nell'area di progettazione.
Trascinare la casella Name dalla finestra Campi nella prima cella della riga Dettaglio. Aggiungere alla tabella i campi desiderati.

Per visualizzare un'anteprima del report

Per visualizzare un'anteprima del report fare clic sulla scheda Anteprima. A seconda delle impostazioni delle credenziali per FsiDataSource, è possibile che venga richiesto di immettere nome utente e password.

Vedere anche

Cronologia modifiche

Versione	Cronologia
5 dicembre 2005	Contenuto modificato: Modifica delle istruzioni per la generazione di un file di chiave, inclusi il nome e il percorso del file di chiave.

Condividi tramite