Partilhar via

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

  • Artigo

O Reporting Services armazena as configurações do aplicativo em um conjunto de arquivos de configuração. A configuração cria os ficheiros de configuração para cada instância do servidor de relatórios instalada. Dentro de 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, você deve modificar um arquivo diretamente para adicionar ou definir configurações avançadas. As definições de configuração são especificadas como elementos XML ou atributos. Se você entender XML e arquivos de configuração, poderá usar um editor de texto ou código para modificar as configurações definidas pelo usuário.

Algumas definições de configuração só podem ser definidas através de uma ferramenta. As configurações que contêm valores criptografados devem ser modificadas por meio da ferramenta Configuração do Reporting Services, do programa de Instalação ou do utilitário de linha de comando rsconfig. Você deve ser membro do grupo Administradores local para executar essas ferramentas.'

Importante

Tenha cuidado ao modificar arquivos de configuração. Se você modificar uma configuração reservada para uso interno, poderá desabilitar a instalação. Geralmente, modificar definições de configuração não é recomendado, a menos que você esteja tentando resolver um problema específico. Para obter mais informações sobre quais configurações são seguras para serem alteradas, consulte RsReportServer.config arquivo de configuração ou arquivo de configuração RSReportDesigner. Para obter mais informações sobre arquivos de configuração, consulte 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. 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 do aplicativo atual podem ser concluídas. No entanto, algumas configurações exigem uma operação imediata de reciclagem do domínio do aplicativo. Nesse caso, todas as solicitações que estão em processo são reiniciadas em um novo domínio de aplicativo.

Se o servidor de relatório detetar um valor inválido, ele registrará um erro no log de aplicativos do Windows e falhará ao iniciar ou usará um valor padrão, dependendo do erro:

  • Se o erro for XML malformado, o servidor de relatório não será iniciado. Se o servidor de relatório estiver em execução quando você introduzir o erro, o servidor de relatório 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. Depois que o erro for detetado, o servidor de relatório não será mais iniciado.

  • Se o erro for um valor de configuração inválido, o servidor usará valores padrão internos e registrará um erro nos arquivos de log de rastreamento. Nos poucos casos em que os valores padrão internos não estão disponíveis, o servidor retorna o erro rsServerConfigurationError se a definição de configuração inválida for crítica para as operações do servidor. Erros sobre configurações críticas ausentes ou inválidas são retornados ao aplicativo cliente em uma página de erro HTML e registrados no log de eventos.

Todas as alterações no arquivo de configuração, incluindo as alterações bem-sucedidas, são registradas no arquivo de log de rastreamento do servidor de relatório. Somente os erros são registrados no log de eventos do aplicativo.

Sobre os valores padrão

A maioria das definições de configuração tem valores padrã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 especificado. Se um valor padrão precisar ser usado devido a uma definição de configuração inválida, um erro será gravado no arquivo de log de rastreamento.

Excluir definições de configuração

Para definições de configuração que têm valores padrão, remover a configuração do arquivo de configuração não tem efeito. A maioria das definições de configuração são definidas e configuradas 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 ele.

Editar um arquivo de configuração do Reporting Services

  1. Encontre 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: Pré-visualização Técnica de janeiro de 2017 de 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 com o Technical Preview 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 que o arquivo seja salvo, fazendo com que um erro de caractere inválido seja gravado no arquivo de log de rastreamento.

  4. Digite o elemento ou valor que você deseja adicionar ou usar. Os elementos são sensíveis a maiúsculas e minúsculas. Se você estiver adicionando um elemento, certifique-se de usar as letras maiú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, extensões de autenticação ou extensões de processamento de dados:

  5. Salve o arquivo.

  6. Verifique os arquivos de log de rastreamento para verificar se os erros não ocorreram. Se vir condições de erro, uma configuração ou o seu valor está especificado incorretamente. Revise o arquivo de configuração RsReportServer.config para obter valores válidos para qualquer definição que esteja a causar um erro. Para obter mais informações sobre como exibir o log de rastreamento, consulte log de rastreamentodo serviço do servidor de relatórios.

Conteúdo relacionado