Como modificar um arquivo de configuração do Reporting Services

O 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.

Observação importanteImportante

Tenha cuidado ao modificar arquivos de configuração. Se você modificar uma configuração que é reservada para uso interno, poderá desabilitar sua instalação. Geralmente, a modificação de configurações 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 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.

Lendo e usando 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 será inicializado. 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. Quando o erro for detectado, o servidor de relatório não será mais inicializado.

  • 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. 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.

Excluindo configurações

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 configurações é definida e configurada de fato 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.

Para editar um arquivo de configuração do Reporting Services

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

    • O RSReportServer.config está localizado na pasta \Arquivos de Programas\Microsoft SQL Server\MSSQL.n\Reporting Services\ReportServer.

    • O RSReportServerServices.exe.config está localizado na pasta \Reporting Services\Report Server\Bin.

    • O RSReportDesigner.config está localizado na pasta \Arquivos de Programas\Microsoft Visual Studio 8\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 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.

  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 observar se ocorreu algum erro. Se houver condições de erro, uma configuração ou seu valor foi especificado incorretamente. Revise o Arquivo de configuração RSReportServer para obter valores válidos para qualquer configuração que está causando um erro. Para obter mais informações sobre como exibir o log de rastreamento, consulte Log de rastreamento do serviço do servidor de relatório.