Modificar um arquivo de configuração do Reporting Services (RSreportserver.config)

  • Artigo

Reporting Services armazena configurações de aplicativo em um conjunto de arquivos de configuração. A instalação cria os arquivos de configuração para cada instância instalada do servidor de relatório. 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. Em alguns casos, é necessário modificar um arquivo diretamente para adicionar ou definir configurações avançadas. As configurações são especificadas como elementos ou atributos XML. 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.

Algumas configurações podem ser definidas somente com uma ferramenta. 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. Você deve ser um membro do grupo Administradores local para executar estas ferramentas.

Importante

Tenha cuidado ao modificar arquivos de configuração. Se você modificar uma configuração que é reservada para uso interno, poderá desabilitar sua instalação. Normalmente, a modificação de definições de configuração não é recomendada, a menos que você esteja tentando resolver um problema específico. 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. Para obter mais informações sobre arquivos de configuração, confira a documentação do produto Microsoft .NET Framework.

Neste artigo:

Ler e usar valores de configuração

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. Os valores novos e revisados entram em vigor em um novo domínio de aplicativo depois que o domínio de aplicativo atual expira. Sempre que possível, as solicitações que ainda estão sendo processadas no domínio de aplicativo atual podem ser concluídas. No entanto, algumas configurações requerem uma operação de reciclagem imediata do domínio de aplicativo. Neste caso, todas as solicitações em andamento são reinicializadas em um novo domínio de aplicativo.

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:

  • Se o erro for XML danificado, o servidor de relatório não inicia. Se o servidor de relatório estiver em execução quando o erro for introduzido, ele ignorará o arquivo de configuração inválido. Ele ignora o arquivo até que o servidor de relatório seja reiniciado ou o domínio do aplicativo seja reciclado. Quando o erro for detectado, o servidor de relatório não irá mais iniciar.

  • Se o erro é um valor de configuração inválido, o servidor utiliza os valores padrão internos e registra um erro nos arquivos de log de rastreamento. 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. 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.

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. Somente erros são registrados no log de eventos de aplicativo.

Sobre valores padrão

A maioria das configurações tem valores padrão que são especificados internamente no servidor de relatório. O servidor de relatório usa esses valores se um valor definido pelo usuário for inválido ou não for especificado. 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.

Excluir definições de configuração

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. A maioria das definições de configuração é definida e configurada internamente. 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.

Editar um arquivo de configuração do Reporting Services

  1. Localize o arquivo de configuração que deseja editar:

    • RSReportServer.config está localizado na seguinte pasta:

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

      Aplica-se a: Visualização Técnica de janeiro de 2017 dos relatórios do Power BI no SQL Server Reporting Services

      C:\Program Files\Microsoft SQL Server Reporting Services\RSServer\ReportServer

    • RSReportServerServices.exe.config está localizado na seguinte pasta:

      Observação

      Isso não está disponível na Visualização Técnica de janeiro de 2017 dos relatórios do Power BI no SQL Server Reporting Services.

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

    • RSReportDesigner.config está localizado na seguinte pasta:

      C:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE\PrivateAssemblies

  2. Salve uma cópia do arquivo caso precise reverter as alterações.

  3. Abra o arquivo original no Bloco de Notas ou em um editor de código. Não use o Textpad. 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.

  4. Digite o elemento ou valor que deseja adicionar ou usar. Os elementos fazem distinção entre maiúsculas e minúsculas. Se você estiver adicionando um elemento, use as letras minúsculas e minúsculas corretas. 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:

  5. Salve o arquivo.

  6. Verifique os arquivos de log de rastreamento para checar se ocorreu algum erro. Se houver condições de erro, uma configuração ou seu valor foi especificado incorretamente. Examine o Arquivo de configuração RsReportServer.config para obter valores válidos para qualquer configuração que esteja causando um erro. Para obter mais informações sobre como exibir o log de rastreamento, consulte Log de rastreamento de serviço de servidor de relatório.

Conteúdo relacionado