Procedura: Modifica di un file di configurazione di Reporting Services
In Reporting Services le impostazioni dell'applicazione vengono archiviate in un insieme di file di configurazione. Durante l'installazione vengono creati i file di configurazione per ogni istanza del server di report installata. All'interno di ogni file, i valori vengono impostati in questa fase o nel momento in cui si utilizzano strumenti e applicazioni per configurare un server per l'esecuzione di operazioni. In alcuni casi, è necessario modificare direttamente un file per aggiungere o configurare impostazioni avanzate. Le impostazioni di configurazione sono specificate come elementi o attributi XML. Se si conoscono il linguaggio XML e i file di configurazione, è possibile utilizzare un editor di testo o di codice per modificare le impostazioni definibili dall'utente.
Alcune impostazioni di configurazione possono essere impostate solo tramite uno strumento specifico. Impostazioni che contengono valori crittografati devono essere modificate ad esempio tramite lo strumento di configurazione di Reporting Services, il programma di installazione o l'utilità della riga di comando rsconfig. Per eseguire questi strumenti, è necessario essere membro del gruppo Administrators locale.
.gif "Nota importante") Importante |
|---|
Prestare attenzione in caso di modifiche al file di configurazione. Se si modifica un'impostazione riservata per l'uso interno, l'installazione potrebbe essere disabilitata. Non è in genere consigliabile modificare le impostazioni di configurazione, a meno che non sia necessario risolvere un problema specifico. Per ulteriori informazioni sulle impostazioni sicure da modificare, vedere File di configurazione RSReportServer o File di configurazione RSReportDesigner. Per ulteriori informazioni sui file di configurazione, vedere la documentazione del prodotto Microsoft.NET Framework. |
Lettura e utilizzo di valori di configurazione
In un server di report i file di configurazione vengono letti all'avvio del servizio e tutte le volte in cui il file di configurazione viene salvato. I valori nuovi e quelli modificati diventano effettivi in un nuovo dominio applicazione dopo che quello precedente è scaduto. Tutte le volte in cui è possibile, le richieste attualmente in corso nel dominio applicazione corrente vengono completate. Per alcune impostazioni è necessario tuttavia che venga eseguita immediatamente un'operazione di riciclo del dominio applicazione. In questo caso tutte le richieste attualmente in corso vengono riavviate in un nuovo dominio applicazione.
Se il server di report rileva un valore non valido, nel registro applicazioni di Windows viene inserito un errore a seconda del quale il server di report non si avvia o utilizza un valore predefinito:
Se l'errore è causato da XML con formato non valido, il server di report non verrà avviato. Se il server di report è in esecuzione quando si verifica l'errore, il file di configurazione non valido verrà ignorato finché il server di report non verrà riavviato o fino a quando il dominio applicazione non verrà riciclato. Dopo aver rilevato l'errore, il server di report non verrà avviato.
Se l'errore è un valore di configurazione non valido, il server utilizzerà valori predefiniti interni e registrerà un errore nei file di log di traccia. In un numero ridotto di casi non sono disponibili valori predefiniti interni e di conseguenza il server restituirà l'errore rsServerConfigurationError se l'impostazione di configurazione non valida è critica per le operazioni del server. Gli errori relativi a impostazioni mancanti o non valide vengono restituiti all'applicazione client in una pagina degli errori HTML e inseriti nel registro eventi.
Tutte le modifiche apportate al file di configurazione, incluse quelle con esito positivo, vengono registrate nel file di log di traccia del server di report. Nel registro eventi applicazioni vengono inseriti solo gli errori.
Informazioni sui valori predefiniti
La maggior parte delle impostazioni di configurazione dispone di valori predefiniti specificati internamente nel server di report che li utilizzerà se un valore definito dall'utente non è valido o non è stato specificato. Se è necessario utilizzare un valore predefinito a causa di un'impostazione non valida, nel file di log di traccia verrà registrato un errore.
Eliminazione delle impostazioni di configurazione
Per impostazioni di configurazione cui sono associati valori predefiniti, la rimozione dell'impostazione dal file di configurazione non ha alcun effetto. La maggior parte delle impostazioni di configurazione viene effettivamente definita e configurata internamente. Se si elimina un elemento dal file di configurazione, la copia interna è ancora disponibile e utilizza il valore predefinito specificato.
Per modificare un file di configurazione di Reporting Services
Individuare il file di configurazione da modificare:
RSReportServer.config è contenuto nella cartella \Programmi\Microsoft SQL Server\MSSQL.n\Reporting Services\ReportServer.
RSReportServerServices.exe.config è contenuto nella cartella \Reporting Services\Report Server\Bin.
RSReportDesigner.config è contenuto nella cartella \Programmi\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies.
Salvare una copia del file nel caso in cui sia necessario eseguire il rollback delle modifiche.
Aprire il file originale in Blocco note o un editor del codice. Non utilizzare Textpad poiché imposta la lunghezza del file prima del salvataggio, provocando la registrazione nel file di log di traccia di un errore dovuto a un carattere non valido.
Digitare l'elemento o il valore da aggiungere o utilizzare. Poiché gli elementi rispettano la distinzione tra maiuscole e minuscole, quando si aggiunge un elemento verificare di utilizzare le lettere nella forma corretta. Istruzioni specifiche per la modifica di file di configurazione sono disponibili se si personalizzano l'estensione per il rendering, le estensioni di autenticazione o quelle per l'elaborazione dei dati:
Salvare il file.
Esaminare i file di log di traccia per controllare che non si siano verificati errori. Se sono presenti condizioni di errore, un'impostazione o il relativo valore è stato specificato in modo non corretto. Rivedere il File di configurazione RSReportServer per i valori validi per qualsiasi impostazione che provoca un errore. Per ulteriori informazioni sulla visualizzazione del log di traccia, vedere Log di traccia del servizio del server di report.
Vedere anche