Modificare un file di configurazione di Reporting Services (RSreportserver.config)Modify a Reporting Services Configuration File (RSreportserver.config)

In Reporting ServicesReporting Services le impostazioni dell'applicazione vengono archiviate in un set di file di configurazione. Reporting ServicesReporting Services stores application settings in a set of configuration files. Durante l'installazione vengono creati i file di configurazione per ogni istanza del server di report installata.Setup creates the configuration files for each report server instance you install. 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.Within each file, values are either set during installation or when you use tools and applications to configure a server for operation. In alcuni casi, è necessario modificare direttamente un file per aggiungere o configurare impostazioni avanzate.In some cases, you must modify a file directly to add or configure advanced settings. Le impostazioni di configurazione sono specificate come elementi o attributi XML.Configuration settings are specified as either XML elements or attributes. 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.If you understand XML and configuration files, you can use a text or code editor to modify user-definable settings.

Alcune impostazioni di configurazione possono essere impostate solo tramite uno strumento specifico.Some configuration settings can be set only through a tool. 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 .Settings that contain encrypted values must be modified through the Reporting Services Configuration tool, the Setup program, or the rsconfig command line utility. Per eseguire questi strumenti, è necessario essere membro del gruppo Administrators locale.You must be a member of the local Administrators group to run these tools.'

Importante

Prestare attenzione in caso di modifiche al file di configurazione.Use caution when modifying configuration files. Se si modifica un'impostazione riservata per l'uso interno, l'installazione potrebbe essere disabilitata.If you modify a setting that is reserved for internal use, you may disable your installation. Non è in genere consigliabile modificare le impostazioni di configurazione, a meno che non sia necessario risolvere un problema specifico.Generally, modifying configuration settings is not recommended unless you are trying to solve a specific problem. Per altre informazioni sulle impostazioni sicure da modificare, vedere File di configurazione RsReportServer.config o File di configurazione RSReportDesigner.For more information about which settings are safe to change, see RsReportServer.config Configuration File or RSReportDesigner Configuration File. Per altre informazioni sui file di configurazione, vedere la documentazione del prodotto MicrosoftMicrosoft .NET Framework.NET Framework .For more information about configuration files, see the MicrosoftMicrosoft .NET Framework.NET Framework product documentation.

Contenuto dell'argomento:In this topic:

Lettura e utilizzo di valori di configurazione Reading and Using Configuration Values

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.A report server reads the configuration files when the service starts and whenever the configuration file is saved. I valori nuovi e quelli modificati diventano effettivi in un nuovo dominio applicazione dopo che quello precedente è scaduto.New and revised values take effect in a new application domain after the current application domain expires. Tutte le volte in cui è possibile, le richieste attualmente in corso nel dominio applicazione corrente vengono completate.Whenever possible, requests that are still processing in the current application domain are allowed to complete. Per alcune impostazioni è necessario tuttavia che venga eseguita immediatamente un'operazione di riciclo del dominio applicazione.However, a few settings require an immediate application domain recycle operation. In questo caso tutte le richieste attualmente in corso vengono riavviate in un nuovo dominio applicazione.In this case, all requests that are in process are restarted in a new application domain.

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:If the report server detects an invalid value, the report server logs an error to the Windows application log and either fails to start or uses a default value, depending on the error:

  • Se l'errore è causato da XML con formato non valido, il server di report non verrà avviato.If the error is malformed XML, the report server will not start. 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.If the report server is running when you introduce the error, the report server ignores the invalid configuration file until the report server restarts or the application domain is recycled. Dopo aver rilevato l'errore, il server di report non verrà avviato.Once the error is detected, the report server will no longer start.

  • 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.If the error is an invalid configuration value, the server will use internal default values and log an error to the trace log files. 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.In the few cases where internal default values are not available, the server will return the rsServerConfigurationError error if the invalid configuration setting is critical to server operations. 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.Errors about missing or invalid critical settings are returned to the client application in an HTML error page and logged to the event log.

    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.All configuration file changes, including successful changes, are recorded in the report server trace log file. Nel registro eventi applicazioni vengono inseriti solo gli errori.Only errors are logged to the application event log.

Informazioni sui valori predefiniti About Default Values

La maggior parte delle impostazioni di configurazione dispone di valori predefiniti specificati internamente nel server di reportMost configuration settings have default values that are specified internally in the report server. che li utilizzerà se un valore definito dall'utente non è valido o non è stato specificato.The report server will use these values if a user-defined value is invalid or not specified. Se è necessario utilizzare un valore predefinito a causa di un'impostazione non valida, nel file di log di traccia verrà registrato un errore.If a default value must be used due to an invalid configuration setting, an error is written to the trace log file.

Eliminazione delle impostazioni di configurazione Deleting Configuration Settings

Per impostazioni di configurazione cui sono associati valori predefiniti, la rimozione dell'impostazione dal file di configurazione non ha alcun effetto.For configuration settings that have default values, removing the setting from the configuration file has no effect. La maggior parte delle impostazioni di configurazione viene effettivamente definita e configurata internamente.Most configuration settings are actually defined and configured internally. Se si elimina un elemento dal file di configurazione, la copia interna è ancora disponibile e utilizza il valore predefinito specificato.If you delete an item from the configuration file, the internal copy is still available and uses the default value that is defined for it.

Per modificare un file di configurazione di Reporting Services To Edit a Reporting Services Configuration File

  1. Individuare il file di configurazione da modificare:Find the configuration file you want to edit:

    • RSReportServer.config si trova nella cartella seguente:RSReportServer.config is located in the following folder:

      C:\Program Files\Microsoft SQL Server\MSRS13.MSSQLSERVER\Reporting Services\ReportServer  
      

      ||
      |-|
      | Si applica a:Applies to: Technical Preview di gennaio 2017 dei report di Power BI in SQL Server Reporting Services Si applica a:Applies to: January 2017 Technical Preview of Power BI reports in SQL Server Reporting Services|

      C:\Program Files\Microsoft SQL Server Reporting Services\RSServer\ReportServer
      
    • RSReportServerServices.exe.config si trova nella cartella seguente:RSReportServerServices.exe.config is located in the following folder:

      Nota

      Non è disponibile con gennaio January 2017 anteprima tecnica di Power BI i report in SQL Server Reporting Services.This is not available with the January 2017 Technical Preview of Power BI reports in SQL Server Reporting Services.

      C:\Program Files\Microsoft SQL Server\MSRS13.MSSQLSERVER\Reporting Services\ReportServer\bin  
      
    • RSReportDesigner.config si trova nella cartella seguente:RSReportDesigner.config is located in the following folder:

      C:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE\PrivateAssemblies  
      
  2. Salvare una copia del file nel caso in cui sia necessario eseguire il rollback delle modifiche.Save a copy of the file in case you need to roll back your changes.

  3. Aprire il file originale in Blocco note o un editor del codice.Open the original file in Notepad or a code editor. 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.Do not use Textpad; it sets the file length before the file is saved, causing an invalid character error to be written to the trace log file.

  4. Digitare l'elemento o il valore da aggiungere o utilizzare.Type the element or value that you want to add or use. Poiché gli elementi rispettano la distinzione tra maiuscole e minuscole,Elements are case-sensitive. quando si aggiunge un elemento verificare di utilizzare le lettere nella forma corretta.If you are adding an element, be sure to use the correct upper and lower case letters. 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:Specific instructions for editing configuration files are available if you are customizing rendering extension, authentication extensions, or data processing extensions:

  5. Salvare il file.Save the file.

  6. Esaminare i file di log di traccia per controllare che non si siano verificati errori.Check the trace log files to verify that errors did not occur. Se sono presenti condizioni di errore, un'impostazione o il relativo valore è stato specificato in modo non corretto.If you see error conditions, a setting or its value is specified incorrectly. Rivedere il File di configurazione RsReportServer.config per i valori validi per qualsiasi impostazione che provoca un errore.Review the RsReportServer.config Configuration File for valid values for any setting that is causing an error. Per altre informazioni su come visualizzare i log di traccia, vedere Log di traccia del servizio del server di report.For more information about how to view the trace log, see Report Server Service Trace Log.

Vedere ancheSee Also

File di configurazione RsReportServer.config RsReportServer.config Configuration File
File di configurazione ReportingServicesService ReportingServicesService Configuration File
File di configurazione RSReportDesigner RSReportDesigner Configuration File
Distribuzione di un'estensione di elaborazione dei dati Deploying a Data Processing Extension
Distribuzione di un'estensione di recapito Deploying a Delivery Extension
Distribuzione di un'estensione per il Rendering Deploying a Rendering Extension
File di configurazione di Reporting ServicesReporting Services Configuration Files