Modify a Reporting Services Configuration File (RSreportserver.config)Modify a Reporting Services Configuration File (RSreportserver.config)

Reporting ServicesReporting Services armazena configurações de aplicativo em um conjunto de arquivos de configuração.stores application settings in a set of configuration files. A instalação cria os arquivos de configuração para cada instância instalada do servidor de relatório.Setup creates the configuration files for each report server instance you install. Em cada arquivo, os valores são definidos durante a instalação ou quando você usa ferramentas e aplicativos para configurar um servidor para operação.Within each file, values are either set during installation or when you use tools and applications to configure a server for operation. Em alguns casos, é necessário modificar um arquivo diretamente para adicionar ou definir configurações avançadas.In some cases, you must modify a file directly to add or configure advanced settings. As configurações são especificadas como elementos ou atributos XML.Configuration settings are specified as either XML elements or attributes. Se você entender de XML e arquivos de configuração, use um editor de texto ou de código para modificar configurações definidas pelo usuário.If you understand XML and configuration files, you can use a text or code editor to modify user-definable settings.

Algumas configurações podem ser definidas somente com uma ferramenta.Some configuration settings can be set only through a tool. As configurações que contêm valores criptografados devem ser modificadas com a ferramenta Configuração do Reporting Services, o programa de Instalação ou o utilitário de linha de 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. Você deve ser um membro do grupo Administradores local para executar estas ferramentas.You must be a member of the local Administrators group to run these tools.'

重要

Tenha cuidado ao modificar arquivos de configuração.Use caution when modifying configuration files. Se você modificar uma configuração que é reservada para uso interno, poderá desabilitar sua instalação.If you modify a setting that is reserved for internal use, you may disable your installation. Geralmente, a modificação de configurações não é recomendada, a menos que você esteja tentando resolver um problema específico.Generally, modifying configuration settings is not recommended unless you are trying to solve a specific problem. Para obter mais informações sobre quais configurações podem ser alteradas com segurança, consulte Arquivo de configuração RsReportServer.config ou Arquivo de configuração RSReportDesigner.For more information about which settings are safe to change, see RsReportServer.config Configuration File or RSReportDesigner Configuration File. Para obter mais informações sobre arquivos de configuração, confira a documentação do produto MicrosoftMicrosoft.NET Framework.NET Framework .For more information about configuration files, see the MicrosoftMicrosoft.NET Framework.NET Framework product documentation.

Neste tópico:In this topic:

Lendo e usando valores de configuraçãoReading and Using Configuration Values

Um servidor de relatório lê os arquivos de configuração quando o serviço é iniciado e sempre que o arquivo de configuração é salvo.A report server reads the configuration files when the service starts and whenever the configuration file is saved. Os valores novos e revisados entram em vigor em um novo domínio de aplicativo depois que o domínio de aplicativo atual expira.New and revised values take effect in a new application domain after the current application domain expires. Sempre que possível, as solicitações que ainda estão sendo processadas no domínio de aplicativo atual podem ser concluídas.Whenever possible, requests that are still processing in the current application domain are allowed to complete. No entanto, algumas configurações requerem uma operação de reciclagem imediata do domínio de aplicativo.However, a few settings require an immediate application domain recycle operation. Neste caso, todas as solicitações em andamento são reinicializadas em um novo domínio de aplicativo.In this case, all requests that are in process are restarted in a new application domain.

Se o servidor de relatório detectar um valor inválido, registrará um erro no log de aplicativo do Windows e não será inicializado ou usará um valor padrão, dependendo do erro: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 o erro for XML danificado, o servidor de relatório não será inicializado.If the error is malformed XML, the report server will not start. Se o servidor de relatório estiver em execução quando o erro for introduzido, ele ignorará o arquivo de configuração inválido até ser reinicializado ou até o domínio de aplicativo ser reciclado.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. Quando o erro for detectado, o servidor de relatório não será mais inicializado.Once the error is detected, the report server will no longer start.

  • Se o erro for um valor de configuração inválido, o servidor utilizará os valores padrão internos e registrará um erro nos arquivos de log de rastreamento.If the error is an invalid configuration value, the server will use internal default values and log an error to the trace log files. Em alguns casos, quando nenhum valor padrão interno está disponível, o servidor retorna o erro rsServerConfigurationError se a configuração inválida for crítica para as operações de servidor.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. Os erros sobre configurações críticas ausentes ou inválidas são retornadas ao aplicativo cliente em uma página de erro HTML e registrados no log de eventos.Errors about missing or invalid critical settings are returned to the client application in an HTML error page and logged to the event log.

Todas as alterações do arquivo de configuração, inclusive alterações bem-sucedidas, são registradas no arquivo de log de rastreamento do servidor de relatório.All configuration file changes, including successful changes, are recorded in the report server trace log file. Somente erros são registrados no log de eventos de aplicativo.Only errors are logged to the application event log.

Sobre valores padrãoAbout Default Values

A maioria das configurações tem valores padrão que são especificados internamente no servidor de relatório.Most configuration settings have default values that are specified internally in the report server. O servidor de relatório usa esses valores se um valor definido pelo usuário for inválido ou não for especificado.The report server will use these values if a user-defined value is invalid or not specified. Se for necessário usar um valor padrão devido a uma configuração inválida, um erro será gravado no arquivo de log de rastreamento.If a default value must be used due to an invalid configuration setting, an error is written to the trace log file.

Excluindo configuraçõesDeleting Configuration Settings

Para configurações que têm valores padrão, a remoção da configuração do arquivo de configuração não tem nenhum efeito.For configuration settings that have default values, removing the setting from the configuration file has no effect. A maioria das configurações é definida e configurada de fato internamente.Most configuration settings are actually defined and configured internally. Se você excluir um item do arquivo de configuração, a cópia interna ainda estará disponível e usará o valor padrão definido para ela.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.

Para editar um arquivo de configuração do Reporting ServicesTo Edit a Reporting Services Configuration File

  1. Localize o arquivo de configuração que deseja editar:Find the configuration file you want to edit:

    • ORSReportServer.config está localizado na seguinte pasta:RSReportServer.config is located in the following folder:

      C:\Program Files\Microsoft SQL Server\MSRS13.MSSQLSERVER\Reporting Services\ReportServer  
      
      Aplica-se a:Applies to: Visualização Técnica de janeiro de 2017 dos relatórios do Power BI no SQL Server Reporting ServicesAplica-se 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
      
    • ORSReportServerServices.exe.config está localizado na seguinte pasta:RSReportServerServices.exe.config is located in the following folder:

      注意

      Isso não está disponível no Technical Preview de janeiro de 2017 dos relatórios do Power BI no 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  
      
    • ORSReportDesigner.config está localizado na seguinte pasta:RSReportDesigner.config is located in the following folder:

      C:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE\PrivateAssemblies  
      
  2. Salve uma cópia do arquivo caso precise reverter as alterações.Save a copy of the file in case you need to roll back your changes.

  3. Abra o arquivo original no Bloco de Notas ou em um editor de código.Open the original file in Notepad or a code editor. Não use o editor de texto, pois ele define o comprimento do arquivo antes de salvá-lo, provocando a gravação de um erro de caractere inválido no arquivo de log de rastreamento.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. Digite o elemento ou valor que deseja adicionar ou usar.Type the element or value that you want to add or use. Os elementos fazem distinção entre maiúsculas e minúsculas.Elements are case-sensitive. Se você estiver adicionando um elemento, use as letras minúsculas e minúsculas corretas.If you are adding an element, be sure to use the correct upper and lower case letters. Instruções específicas para editar arquivos de configuração estarão disponíveis se você estiver personalizando extensões de renderização, de autenticação ou de processamento de dados:Specific instructions for editing configuration files are available if you are customizing rendering extension, authentication extensions, or data processing extensions:

  5. Salve o arquivo.Save the file.

  6. Verifique os arquivos de log de rastreamento para observar se ocorreu algum erro.Check the trace log files to verify that errors did not occur. Se houver condições de erro, uma configuração ou seu valor foi especificado incorretamente.If you see error conditions, a setting or its value is specified incorrectly. Examine o Arquivo de configuração RsReportServer.config para obter valores válidos para qualquer configuração que esteja causando um erro.Review the RsReportServer.config Configuration File for valid values for any setting that is causing an error. Para obter mais informações sobre como exibir o log de rastreamento, consulte Log de rastreamento de serviço de servidor de relatório.For more information about how to view the trace log, see Report Server Service Trace Log.

Consulte TambémSee Also

Arquivo de Configuração RsReportServer.config RsReportServer.config Configuration File
Arquivo de configuração ReportingServicesService ReportingServicesService Configuration File
Arquivo de configuração RSReportDesigner RSReportDesigner Configuration File
Implantando uma extensão de processamento de dados Deploying a Data Processing Extension
Implantando uma extensão de entrega Deploying a Delivery Extension
Implantando uma extensão de renderização Deploying a Rendering Extension
Arquivos de configuração do Reporting ServicesReporting Services Configuration Files