Condividi tramite

Utilizzo di script per l'esecuzione di attività di distribuzione e di amministrazione

  • Articolo

Data aggiornamento: 12 dicembre 2006

Reporting Services supporta l'utilizzo di script per automatizzare installazioni di routine, distribuzioni e attività amministrative. La distribuzione di un server di report è un processo costituito da più passaggi. Per configurare una distribuzione è necessario utilizzare diversi strumenti e processi, in quanto non è disponibile un unico programma o approccio che consenta di automatizzare tutte le attività.

Non è consigliabile automatizzare tutti i passaggi. In alcuni casi, l'esecuzione di un passaggio in modo manuale oppure tramite uno strumento grafico costituisce l'approccio migliore e più efficace. Se, ad esempio, si desidera distribuire un numero elevato di report e modelli, è consigliabile copiare i database del server di report anziché scrivere codice per ricreare i contenuti del server di report.

Per alcuni passaggi è necessario utilizzare codice personalizzato. È ad esempio possibile configurare le directory virtuali e il servizio Web in modo automatico, ma solo scrivendo codice personalizzato per l'esecuzione di chiamate nel provider WMI (Windows Management Instrumentation) per Server report. Se non si desidera scrivere codice, per eseguire il passaggio è necessario utilizzare lo strumento Gestione configurazione Reporting Services.

Per eseguire script per la configurazione di un server di report, è necessario essere un amministratore locale nel computer che si sta configurando. Per ulteriori informazioni, vedere Configurazione di un server di report per l'amministrazione remota.

In questo argomento vengono descritti gli approcci consigliati per l'automatizzazione di passaggi specifici. Sono menzionati vari programmi e interfacce programmatiche, per ognuno dei quali è disponibile una descrizione di seguito in questo argomento.

Attività di distribuzione e modalità di automatizzazione di tali attività

Nella tabella seguente sono riepilogate tutte le attività di installazione e configurazione necessarie per la distribuzione di un server di report. È possibile utilizzare la tabella per individuare, per un'attività specifica, un approccio che consenta di eseguire l'attività in modo automatico.

Attività Approccio

Installazione di Reporting Services.

Per eseguire un'installazione automatica, è possibile avviare il programma di installazione dalla riga di comando.

È possibile utilizzare il programma di installazione sia per installare che per configurare un server di report, ma solo se si sceglie la configurazione predefinita e se il sistema soddisfa tutti i requisiti per il tipo di installazione. Se non è possibile installare la configurazione predefinita, è necessario eseguire un'installazione di tipo "solo file". Per ulteriori informazioni sulle opzioni di installazione, vedere Installazione di Reporting Services mediante il programma di installazione.

Configurazione di un sito Web in Internet Information Services (IIS).

In Reporting Services non è disponibile il supporto per la creazione o la configurazione di un sito Web. Per ulteriori informazioni sull'automatizzazione di questa attività, vedere la documentazione di IIS.

Configurazione del servizio Web ReportServer e delle directory virtuali.

È necessario scrivere codice personalizzato per l'esecuzione di chiamate nel provider WMI per Server report. Non sono disponibili utilità della riga di comando o modelli di script per la configurazione del servizio Web e la definizione delle directory virtuali.

Se i requisiti relativi al codice non consentono di automatizzare questo passaggio, è possibile configurare in modo semplice il servizio Web e le directory virtuali manualmente, eseguendo lo strumento Gestione configurazione Reporting Services. Per ulteriori informazioni, vedere Configurazione delle directory virtuali del server di report.

Creazione, aggiornamento o configurazione del database del server di report.

Per configurare il database in modo automatico, scegliere uno degli approcci seguenti:

  • Creare gli script GenerateNewDatabaseScript.sql, UpgradeDatabaseScript.sql o GrantRightsScript.sql da modelli di script predefiniti. È possibile generare questi script tramite lo strumento Gestione configurazione Reporting Services oppure chiamando il provider WMI (Windows Management Instrumentation). Gli script possono essere eseguiti a livello di programmazione dalla riga di comando tramite l'utilità osql o da una finestra Query in Management Studio.
  • Eseguire l'utilità rsconfig per configurare la connessione. Non è possibile utilizzare rsconfig.exe per creare o aggiornare il database. Se si utilizza rsconfig, accertarsi di eseguire lo script GrantRightsScript per concedere le autorizzazioni per il database del server di report. È necessario rigenerare ed eseguire lo script per ogni account di servizio. Il numero di rigenerazioni ed esecuzioni dello script dipende dalla modalità di configurazione della connessione al database del server di report. Poiché esistono due account di servizio, è necessario rigenerare ed eseguire gli script due volte.

Configurazione di una distribuzione con scalabilità orizzontale.

Per eseguire in modo automatico una distribuzione con scalabilità orizzontale, scegliere uno degli approcci seguenti:

Backup delle chiavi di crittografia.

Per eseguire in modo automatico il backup delle chiavi di crittografia, scegliere uno degli approcci seguenti:

Configurazione della posta elettronica del server di report.

Scrivere codice personalizzato che viene eseguito nel provider WMI per Reporting Services. Il provider supporta un subset delle impostazioni di configurazione della posta elettronica.

Sebbene il file RSReportServer.config includa tutte le impostazioni, non utilizzare questo file in modo automatizzato. In particolare, non utilizzare un file batch per copiare il file in un altro server di report. Ogni file di configurazione include valori specifici per l'istanza corrente. Tali valori non saranno validi in altre istanze del server di report.

Per ulteriori informazioni sulle impostazioni, vedere Configurazione di un server di report per il recapito tramite posta elettronica.

Configurazione dell'account di esecuzione automatica.

Per configurare l'account di esecuzione automatica in modo automatico, scegliere uno degli approcci seguenti:

Distribuzione di un ambiente del server di report esistente, includendo gerarchia di cartelle, assegnazioni di ruolo, report, sottoscrizioni, pianificazioni, origini dei dati e risorse.

Il modo migliore per ricreare un ambiente del server di report esistente consiste nel copiare il database del server di report in una nuova istanza del server di report.

Un approccio alternativo consiste nello scrivere codice personalizzato per ricreare il contenuto del server di report esistente a livello di programmazione. Tenere presente, tuttavia, che le sottoscrizioni, gli snapshot dei report e la cronologia dei report non possono essere ricreati a livello di programmazione.

Per alcune distribuzioni può essere vantaggioso utilizzare entrambe le tecniche, ovvero ripristinare un database del server di report e quindi eseguire codice personalizzato per modificare il database per un'installazione specifica.

Per ulteriori informazioni sullo spostamento di un database del server di report, vedere Spostamento di un database del server di report in un altro computer. Per ulteriori informazioni sulla creazione di un ambiente del server di report a livello di programmazione, vedere la sezione "Duplicazione di un ambiente server di report" di questo argomento.

Strumenti e tecnologie per l'automatizzazione della distribuzione del server

Nell'elenco seguente vengono riepilogati i programmi e le interfacce che è possibile utilizzare per automatizzare la distribuzione e le attività di manutenzione:

  • È possibile eseguire il programma di installazione in modalità automatica per installare e, in alcuni casi, configurare i componenti del server di report. Per configurare un'istanza del server di report con il programma di installazione, è necessario scegliere un'installazione di tipo "solo file".
  • È possibile utilizzare il provider WMI per Server report e le utilità della riga di comando di Reporting Services per la configurazione locale e remota del server.
    Il provider WMI per Server report espone classi, proprietà e metodi che consentono di configurare tutti gli aspetti di un'installazione di Reporting Services, tra cui la definizione di account di servizio, la configurazione di directory virtuali, la creazione e la configurazione del database del server di report o la configurazione di un server di report per il recapito tramite posta elettronica. Per utilizzare il provider WMI è necessario scrivere codice personalizzato o script. Per ulteriori informazioni, vedere Reporting Services WMI Provider.
    Se non si desidera scrivere codice, è possibile utilizzare le utilità della riga di comando rsconfig.exe e rskeymgmt.exe. È possibile scrivere file batch che consentano di eseguire le utilità. Queste utilità consentono di automatizzare alcune attività di configurazione, ma non tutte.
  • I modelli di script consentono di generare script da utilizzare per la creazione, l'aggiornamento e la configurazione del database del server di report. È possibile generare script tramite lo strumento Gestione configurazione Reporting Services.
  • Lo strumento host di scripting del server di report (rs.exe) consente di eseguire codice Visual Basic scritto per ricreare contenuti esistenti o spostarli da un server di report a un altro. Per utilizzare questo approccio, scrivere lo script in Visual Basic, salvarlo come file con estensione rss e quindi utilizzare l'utilità rs.exe per eseguire lo script nel server di report di destinazione. Lo script creato può chiamare l'interfaccia SOAP per il servizio Web ReportServer. Gli script di distribuzione vengono creati utilizzando questo approccio poiché consente di ricreare i contenuti e lo spazio dei nomi della cartella del server di report, nonché la protezione basata sui ruoli.
    È inoltre possibile utilizzare rs.exe per eseguire script generati o personalizzati creati in SQL Server Management Studio. Per Reporting Services, la funzionalità di generazione di script di Management Studio consente di creare codice Visual Basic per un'attività estremamente specifica, ad esempio per la creazione di un ruolo, per l'impostazione delle proprietà del report, per la definizione di una pianificazione e così via. Il codice generato è incompleto e consente di acquisire le pressioni dei tasti e gli eventi del mouse. Per utilizzare il codice, copiarlo in un programma più ampio creato.

[!NOTA] A differenza delle versioni precedenti di Reporting Services, non è più possibile utilizzare il programma di installazione per distribuire tutte le configurazioni possibili del server di report. Se si desidera configurare una distribuzione con scalabilità orizzontale o utilizzare un'istanza remota di SQL Server per ospitare il database del server di report, è necessario creare script o eseguire un'utilità della riga di comando. Il provider WMI è stato aggiornato in SQL Server 2005. Se si desidera riutilizzare script creati per la versione precedente del provider WMI, modificare gli script per l'utilizzo nel nuovo endpoint.

Duplicazione di un ambiente server di report

È possibile creare script per duplicare un ambiente del server di report in un'altra istanza del server di report. Gli script di distribuzione vengono in genere scritti in Visual Basic e successivamente elaborati utilizzando l'utilità host di scripting del server di report.

Utilizzare gli script per copiare cartelle, origini dei dati condivise, risorse, report, assegnazioni di ruoli e impostazioni da un server all'altro. È possibile scrivere uno script per un'istanza del server di report, quindi eseguirlo in un altro server per ricreare lo spazio dei nomi del server di report. In presenza di più server di report nella distribuzione dei servizi di reporting, è possibile eseguire lo script in ogni server per configurarli tutti allo stesso modo.

Nell'elenco seguente viene descritta la procedura per migrare report da un server in un altro.

  1. Impostare la variabile script sull'URL del server di report di origine.
  2. Utilizzare il metodo GetReportDefinition e il metodo GetProperties per recuperare la definizione e le proprietà del report.
  3. Impostare l'URL in modo che punti al server di destinazione.
  4. Utilizzare il metodo CreateReport, passando le proprietà restituite da GetProperties e la definizione del report restituita da GetReportDefinition.

Utilizzando una combinazione di metodi Get e Create, è possibile eseguire una procedura simile per migrare impostazioni, cartelle, origini dei dati condivise e risorse. Per ulteriori informazioni sui metodi utilizzabili dall'utente, vedere la documentazione di riferimento gestita per Reporting Services.

[!NOTA] Gli script vengono eseguiti con le credenziali di Microsoft Windows dell'utente che esegue lo script, a meno che non si decida di impostare le credenziali esplicitamente.

Per ulteriori informazioni sugli esempi di script, vedere Script di esempio (Reporting Services). Per ulteriori informazioni sulla formattazione ed esecuzione di un file script, vedere Scripting with the rs Utility and the Web Service.

Script di esempio per l'impostazione delle proprietà del server

È possibile scrivere uno script o il codice che consente di impostare le proprietà di sistema nel server di report. Nello script di Microsoft Visual Basic .NET seguente viene illustrato un modo per impostare le proprietà. Nell'esempio il controllo ActiveX RSClientPrint viene disattivato, tuttavia è possibile sostituire EnableClientPrinting e False con qualsiasi nome e valore di proprietà valido. Per visualizzare un elenco completo di proprietà del server, vedere Report Server System Properties.

Per utilizzare lo script, salvarlo in un file con estensione rss e quindi utilizzare l'utilità della riga di comando rs.exe per eseguire il file nel server di report. Lo script non è compilato, pertanto non è necessario disporre di un'installazione di Visual Basic. Nell'esempio si presuppone che l'utente disponga delle autorizzazioni per il computer locale che ospita il server di report. Se non è stato eseguito l'accesso con un account che dispone delle autorizzazioni, sarà necessario specificare le informazioni sull'account tramite ulteriori argomenti della riga di comando. Per ulteriori informazioni, vedere Utilità rs.

Public Sub Main()
        Dim props(0) As [Property]
        Dim setProp As New [Property]
        setProp.Name = "EnableClientPrinting"
        setProp.Value = “False” 
        props(0) = setProp
        Try
            rs.SetSystemProperties(props)
        Catch ex As System.Web.Services.Protocols.SoapException
            Console.Write(ex.Detail.InnerXml)
        Catch e as Exception
            Console.Write(e.Message)
        End Try
End Sub

Vedere anche

Concetti

Amministrazione di Reporting Services
Utilità della riga di comando del server di report
Supporto browser in Reporting Services
Panoramica dei componenti di Reporting Services

Altre risorse

GenerateDatabaseCreationScript Method (WMI MSReportServer_ConfigurationSetting Class)
GenerateDatabaseRightsScript Method (WMI MSReportServer_ConfigurationSetting Class)
GenerateDatabaseUpgradeScript Method (WMI MSReportServer_ConfigurationSetting Class)
Procedura: Installazione di SQL Server 2005 dal prompt dei comandi
Configurazione predefinita per l'installazione di un server di report
Distribuzione di Reporting Services

Guida in linea e informazioni

Assistenza su SQL Server 2005

Cronologia modifiche

Versione Cronologia

12 dicembre 2006
Contenuto modificato:
  • Creazione, aggiornamento o configurazione del database del server di report.
  • Configurazione della posta elettronica del server di report.

17 luglio 2006
Nuovo contenuto:
  • Aggiunta di un esempio relativo all'impostazione delle proprietà del server tramite script.

14 aprile 2006
Contenuto modificato:
  • Revisione significativa.