Registrare un provider di dati .NET Framework standard (SSRS)

Articolo
03/23/2023

Per usare un provider di dati .NET Framework di terze parti per recuperare dati per un set di dati di un report di Reporting Services, è necessario distribuire e registrare l'assembly del provider di dati .NET Framework in due posizioni, ovvero nel client di creazione dei report e nel server di report. Nel client per la creazione del report, è necessario registrare il provider di dati come tipo di origine dei dati e associarlo a una finestra Progettazione query. Sarà quindi possibile selezionare il provider di dati come tipo di origine dei dati per la creazione di un set di dati di report. La finestra Progettazione query associata verrà aperta per consentire la creazione di query per il tipo di origine dei dati specifico. Nel server di report il provider di dati deve essere registrato come tipo di origine dei dati. Sarà quindi possibile elaborare i report pubblicati che recuperano i dati da un'origine mediante il provider di dati.

I provider di dati di terze parti possono non offrire tutte le funzionalità disponibili nelle estensioni per l'elaborazione dati di Reporting Services. Per altre informazioni, vedere Origini dati supportate da Reporting Services (SSRS). Per informazioni sull'estensione della funzionalità di un provider di dati .NET Framework, vedere Implementazione di un'estensione per l'elaborazione dati.

Per installare e registrare i provider di dati è necessario disporre di credenziali di amministratore.

Registrazione di un provider di dati .NET Framework nel server di report

Per elaborare i report pubblicati che usano il provider di dati .NET Framework nel server di report, è necessario installare l'assembly in quest'ultimo. È necessario modificare due file di configurazione. Per registrare il provider di dati, modificare rsreportserver.config. Per assegnare autorizzazioni di sicurezza dell'accesso al codice per l'assembly, modificare rssrvpolicy.config.

Per installare l'assembly di un provider di dati nel server di report

Accedere al percorso predefinito della directory bin nel server di report in cui si vuole usare il provider di dati .NET Framework. Il percorso predefinito della directory bin del server di report è <unità>:\Programmi\Microsoft SQL Server\MSRS10_50.MSSQLSERVER\Reporting Services\ReportServer\bin.
Copiare l'assembly dal percorso di gestione temporanea nella directory bin del server di report. In alternativa, è possibile caricare l'assembly nella Global Assembly Cache (GAC). Per altre informazioni, vedere Utilizzo di assembly e della Global Assembly Cache nella documentazione di .NET Framework SDK in MSDN.

Per registrare un provider di dati .NET nel server di report

Eseguire una copia di backup del file RSReportServer.config nella directory padre di ReportServer per bin.
Aprire RSReportServer.config. È possibile aprire il file di configurazione con Visual Studio o con un semplice editor di testo, ad esempio Blocco note.
Individuare l'elemento Data nel file RSReportServer.config. Una voce relativa al provider di dati .NET Framework dovrà essere inserita nella posizione seguente:
```
<Extensions>  
   <Data>  
      <Extension Your data provider configuration information goes here />  
   </Data>  
</Extensions>  
```

Aggiungere una voce per il provider di dati .NET Framework.

Attributo	Descrizione
Nome	Specificare un nome univoco per il provider di dati, ad esempio ProviderDatiNET. La lunghezza massima consentita per l'attributo Name è 255 caratteri. Il nome deve essere univoco tra tutte le voci dell'elemento Extension di un file di configurazione. Il valore indicato qui viene inserito nell'elenco a discesa dei tipi di origini dei dati per la creazione di una nuova origine.
Type	Immettere un elenco delimitato da virgole che includa lo spazio dei nomi completo della classe che implementa l'interfaccia IDbConnection, seguito dal nome dell'assembly del provider di dati .NET Framework senza l'estensione dll.

La voce relativa a una DLL distribuita nella directory bin del server di report potrebbe essere analoga alla seguente:

<Extension Name="MyNETDataProvider" Type="CompanyName.ExtensionName.DataProviderConnectionClass, DataProviderAssembly" />

Se si carica l'assembly nella Global Assembly Cache (GAC), è necessario impostare le proprietà del nome sicuro. Ad esempio:

<Extension Name="MyNETDataProvider" Type="CompanyName.ExtensionName.DataProviderConnectionClass, DataProviderAssembly,Version=1.0.0.0, Culture=neutral, PublicKeyToken=MyPublicToken"/>

Per impostare criteri di gruppo di codice per un provider di dati .NET.

Eseguire una copia di backup del file rssrvpolicy.config nella directory padre di ReportServer per bin.
Aprire rssrvpolicy.config. È possibile aprire il file di configurazione con Visual Studio o con un semplice editor di testo, ad esempio Blocco note.
Individuare l'elemento CodeGroup nel file rssrvpolicy.config.

Aggiungere un gruppo di codice per l'assembly del provider di dati che concede l'autorizzazione FullTrust . Il gruppo di codice potrà avere l'aspetto seguente:

<CodeGroup class="UnionCodeGroup"  
   version="1"  
   PermissionSetName="FullTrust"  
   Name="ThisDataProviderCodeGroup"  
   Description="Code group for the .NET data provider">  
      <IMembershipCondition class="UrlMembershipCondition"  
         version="1"  
         Url=  
"C:\Program Files\Microsoft SQL Server\MSRS10_50.MSSQLSERVER\Reporting Services\ReportServer\bin\DataProviderAssembly.dll"  
       />  
</CodeGroup>

L'appartenenza URL è solo una delle diverse condizioni di appartenenza selezionabili per il provider di dati.

Verifica della distribuzione e della registrazione

È possibile verificare se la distribuzione del provider di dati nel server di report ha avuto esito positivo aprendo il portale Web e controllando che sia incluso nell'elenco delle origini dati disponibili. Per altre informazioni sul portale Web e sulle origini dati, vedere Creare, modificare ed eliminare origini dati condivise (SSRS).

Registrazione di un provider di dati .NET Framework nel client di Progettazione report

Per creare report che usino il provider di dati .NET Framework per un'origine dei dati, è necessario installare l'assembly nel computer client che esegue Progettazione report. È necessario modificare due file di configurazione. Modificare RSReportDesigner.config per registrare il provider di dati come origine dei dati e per utilizzare la finestra Progettazione query standard. Modificare RSPreviewPolicy.config per assegnare autorizzazioni di sicurezza dell'accesso al codice per l'assembly del provider di dati.

Per installare l'assembly di un provider di dati nel client di Progettazione report

Accedere al percorso predefinito della directory PrivateAssemblies nel client di Progettazione report in cui si vuole usare il provider di dati .NET Framework. Il percorso predefinito di questa directory è <unità>:\Programmi\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies.
Copiare l'assembly dal percorso di gestione temporanea nella directory PrivateAssemblies del client di Progettazione report. In alternativa, è possibile caricare l'assembly nella Global Assembly Cache (GAC). Per altre informazioni, vedere Utilizzo di assembly e della Global Assembly Cache nella documentazione di .NET Framework SDK in MSDN.

Per registrare un provider di dati .NET nel client di Progettazione report

Eseguire una copia di backup del file RSReportDesigner.config nella directory PrivateAssemblies.
Aprire RSReportDesigner.config con Visual Studio o con un semplice editor di testo, ad esempio Blocco note.
Individuare l'elemento Data nel file RSReportDesigner.config. Una voce relativa al provider di dati dovrà essere inserita nella posizione seguente:
```
<Extensions>  
   <Data>  
      <Extension Your data provider configuration information goes here />  
   </Data>  
</Extensions>  
```

Aggiungere una voce per il provider di dati.

Attributo	Descrizione
Nome	Specificare un nome univoco per il provider di dati, ad esempio ProviderDatiNET. La lunghezza massima consentita per l'attributo Name è 255 caratteri. Il nome deve essere univoco tra tutte le voci dell'elemento Extension di un file di configurazione. Il valore indicato qui viene inserito nell'elenco a discesa dei tipi di origini dei dati per la creazione di una nuova origine.
Type	Immettere un elenco delimitato da virgole che includa lo spazio dei nomi completo della classe che implementa l'interfaccia IDbConnection, seguito dal nome dell'assembly del provider di dati .NET Framework senza l'estensione dll.

Ad esempio, la voce per una DLL distribuita nella directory PrivateAssemblies di Visual Studio può essere simile alla seguente:

<Extension Name="MyNETDataProvider" Type="CompanyName.ExtensionName.DataProviderConnectionClass, DataProviderAssembly" />

Se si carica l'assembly nella cache di assembly globale (CAG), è necessario impostare le proprietà del nome sicuro. Ad esempio:

<Extension Name="MyNETDataProvider" Type="CompanyName.ExtensionName.DataProviderConnectionClass, DataProviderAssembly, Version=1.0.0.0, Culture=neutral, PublicKeyToken=MyPublicToken"/>

Individuare l'elemento Designer nel file RSReportDesigner.config. Una voce relativa al provider di dati .NET Framework dovrà essere inserita nella posizione seguente:
```
<Extensions>  
   <Designer>  
      <Your data provider configuration information goes here>  
   </Designer>  
</Extensions>  
```
Aggiungere la voce seguente al file RSReportDesigner.config nell'elemento Designer . È necessario sostituire solo l'attributo Name con il nome specificato nelle voci precedenti.
```
<Extension Name="MyNETDataProvider" Type="Microsoft.ReportingServices.QueryDesigners.GenericQueryDesigner,Microsoft.ReportingServices.QueryDesigners"/>  
```

Per impostare criteri di gruppo di codice per un provider di dati .NET nel client di Progettazione report

Eseguire una copia di backup del file RSPreviewPolicy.config file nella directory PrivateAssemblies.
Aprire RSPreviewPolicy.config con Visual Studio o con un semplice editor di testo, ad esempio Blocco note.
Individuare l'elemento CodeGroup nel file RSPreviewPolicy.config.

Aggiungere un gruppo di codice per l'assembly del provider di dati .NET Framework che concede l'autorizzazione FullTrust. Il gruppo di codice potrà avere l'aspetto seguente:

<CodeGroup class="UnionCodeGroup"  
   version="1"  
   PermissionSetName="FullTrust"  
   Name="ThisDataProviderCodeGroup"  
   Description="Code group for the .NET data provider">  
      <IMembershipCondition class="UrlMembershipCondition"  
         version="1"  
         Url=  
" C:\Program Files\Microsoft Visual Studio 9\Common7\IDE\PrivateAssemblies\DataProviderAssembly.dll"  
       />  
</CodeGroup>

L'appartenenza URL è solo una delle diverse condizioni di appartenenza selezionabili per il provider di dati.

Verifica della distribuzione e della registrazione nel client di Progettazione report

Per poter verificare la distribuzione, è necessario chiudere tutte le istanze di Visual Studio nel computer locale. Dopo aver chiuso tutte le sessioni correnti, è possibile verificare se la distribuzione del provider di dati in Progettazione report è riuscita creando un nuovo progetto di report in Visual Studio. Quando si crea un nuovo set di dati per il report il provider di dati dovrebbe essere incluso nell'elenco dei tipi di origini dei dati disponibili.

Considerazioni relative alla piattaforma

In una piattaforma a 64 bit (x64), SQL Server Data Tools (SSDT) viene eseguito in modalità WOW a 32 bit. Quando si creano report su una piattaforma x64, per visualizzarne l'anteprima è necessario che i provider di dati a 32 bit siano installati nel client per la creazione di report. Se si pubblica il report sul medesimo sistema, per poterlo visualizzare nel portale Web sono necessari provider di dati x64.

SQL Server Data Tools (SSDT) non è supportato per le piattaforme basate su Itanium.

Le estensioni per l'elaborazione dati installate con Reporting Services devono essere compilate in modo nativo per ogni piattaforma e installate nei percorsi corretti. Se si registra un provider di dati personalizzato o un provider di dati .NET Framework standard, sarà necessario compilarlo in modo nativo per la piattaforma appropriata e installarlo nei percorsi adeguati. Se si esegue una piattaforma a 32 bit, il provider di dati deve essere compilato per tale tipo di piattaforma. Se si esegue una piattaforma a 64 bit, il provider di dati deve essere invece compilato di conseguenza per tale tipo di piattaforma. Non è possibile utilizzare un provider di dati a 32 bit di cui è stato eseguito il wrapping con interfacce a 64 bit su una piattaforma a 64 bit. Per informazioni relative al funzionamento del provider di dati sulla piattaforma installata, vedere la documentazione del software di terze parti. Per altre informazioni sui provider di dati e sulle piattaforme supportate, vedere Origini dati supportate da Reporting Services (SSRS).

Vedi anche

Configurare e amministrare un server di report (modalità nativa SSRS)
Implementazione di un'estensione per l'elaborazione dati
File di configurazione di Reporting Services
Sicurezza dall'accesso di codice in Reporting Services