Leggimi: esempio di estensione per l'elaborazione dati da una condivisione file

Questo esempio funziona solo con SQL Server 2005 e SQL Server 2008. Non funzionerà con le versioni di SQL Server precedenti a SQL Server 2005.

FsiDataExtension è un'estensione di esempio semplice per l'elaborazione dati per il file system di Windows, L'esempio prevede l'utilizzo delle classi System.IO.DirectoryInfo e System.IO.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 Itanium.

Requisiti

Per utilizzare l'esempio FsiDataExtension è necessario conoscere Microsoft Visual Studio e Microsoft Visual C# o Microsoft Visual Basic e aver effettuato le istallazioni seguenti:

• Microsoft Visual Studio 2005 o ambiente di sviluppo compatibile (per la visualizzazione dei file di progetto).
• Microsoft SQL Server incluso Reporting Services.
• Microsoft .NET Framework 2.0.
• Gli esempi di Reporting Services. È possibile scegliere di installare gli esempi durante l'installazione di SQL Server. 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 Start nel gruppo di programmi Microsoft SQL Server.
• 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

Per impostazione predefinita, questo esempio viene installato nella seguente directory:

C:\Programmi\Microsoft SQL Server\100\Samples\Reporting Services\ Extension Samples\FindRenderSave Sample

Generazione dell'esempio

Per eseguire l'esempio, attenersi alla procedura seguente.

Se non è ancora stato 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

1. 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 e quindi fare clic su Prompt dei comandi di SDK.

   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 e quindi fare clic su Prompt dei comandi di SDK.

2. Utilizzare il comando CD per modificare la directory corrente della finestra del prompt dei comandi nella cartella in cui sono 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, Documentazione ed esercitazioni e quindi fare clic su Directory esempi. Se è stato utilizzato il percorso di installazione predefinito, gli esempi si troveranno in <unità_sistema>:\Programmi\Microsoft SQL Server\100\Samples.

3. Al prompt dei comandi eseguire 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

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

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

1. Aprire il file della soluzione FsiDataExtension (FsiDataExtensionCS.sln o FsiDataExtensionVB.sln) in Visual Studio 2005.

2. In Esplora soluzioni selezionare il progetto FsiDataExtension.

3. Scegliere Aggiungi riferimento dal menu Progetto.

4. Nella finestra di dialogo Aggiungi riferimento fare clic sulla scheda .NET.

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

   Nota

   Il riferimento potrebbe essere già aggiunto al progetto. In questo caso, non sarà necessario aggiungere nuovamente un riferimento.

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

1. Copiare Microsoft.Samples.ReportingServices.FsiDataExtension.dll nel server di report. Il percorso predefinito delle estensioni del server di report è C:\Programmi\Microsoft SQL Server\MSRS10.MSSQLSERVER\Reporting Services\ReportServer\bin.

2. Copiare l'assembly in Progettazione report. Il percorso predefinito delle estensioni per Progettazione report è C:\Programmi\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies.

3. Nell'elemento Data all'interno dei file RSReportServer.config e RSReportDesigner.config (il percorso predefinito del file RSReportDesigner.config è C:\Programmi\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies, mentre quello del file RSReportServer.config è C:\Programmi\Microsoft SQL Server\MSRS10.MSSQLSERVER\Reporting Services\ReportServer) aggiungere la voce seguente:

   <Extension Name="FSI" Type="Microsoft.Samples.ReportingServices.FsiDataExtension.FsiConnection,Microsoft.Samples.ReportingServices.FsiDataExtension"/>
   

4. 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 Distribuzione di un'estensione per l'elaborazione dati.

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

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

2. 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\MSRS10.MSSQLSERVER\Reporting Services\ReportServer\bin\Microsoft.Samples.ReportingServices.FsiDataExtension.dll"
          />
   </CodeGroup>
   

3. 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 9.0\Common7\IDE\PrivateAssemblies\Microsoft.Samples.ReportingServices.FsiDataExtension.dll"
          />
   </CodeGroup>
   

   Il percorso predefinito del file rspreviewpolicy.config è C:\Programmi\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies.

   Per ulteriori informazioni sulla protezione di .NET Framework e Reporting Services, vedere Sviluppo protetto (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.

Per creare il progetto report

1. Fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft SQL Server 2008, quindi Business Intelligence Development Studio.

2. Scegliere Nuovo dal menu File e quindi fare clic su Progetto.

3. Nell'elenco Tipi progetto fare clic su Progetti Business Intelligence.

4. Nell'elenco Modelli fare clic su Progetto Server report.

5. Nella casella Nome digitare FsiReportProject.

6. Fare clic su OK per creare il progetto report.

Per creare il report

1. Scegliere Aggiungi nuovo elemento dal menu Progetto.

2. Nell'elenco Categorie fare clic su Progetto report.

3. Nell'elenco Modelli fare clic su Report.

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

1. Nel riquadro Dati fare clic su Nuovo, quindi selezionare Nuovo set di dati.

2. Nella casella di testo Nome della scheda Query digitare FsiDataSource.

3. Nell'elenco Tipo selezionare File Share Information.

4. Lasciare vuota la casella Stringa di connessione. L'estensione di esempio per i dati non utilizza alcuna stringa di connessione.

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

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

Per visualizzare il set di dati

1. In visualizzazione Dati è disponibile lo strumento Progettazione query standard. Nella casella Tipo di comando selezionare Text.

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

3. Sulla barra degli strumenti di Progettazione query standard fare clic sul pulsante Esegui (!).

   I dati della condivisione file verranno visualizzati nel riquadro dei dettagli.

Per progettare il layout del report

1. In visualizzazione Progettazione, nella Casella degli strumenti, fare clic su Tabella.

2. Trascinare il controllo Tabella nell'area di progettazione.

3. Trascinare la casella Nome dal riquadro Dati report nella prima cella della riga Dettaglio. Aggiungere alla tabella i campi desiderati.

Per visualizzare un'anteprima del report

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

Attività

Compilazione ed esecuzione degli esempi di codice
Esempi di Reporting Services

Altre risorse

Estensioni di esempio (Reporting Services)
Implementazione di un'estensione per l'elaborazione dati

Guida e informazioni

Assistenza su SQL Server 2008