URLs em arquivos de configuração (Gerenciador de Configurações do Servidor de Relatório)

  • Artigo

O Reporting Services armazena configurações de aplicativos em um arquivo RSReportServer.config. Nesse arquivo, há parâmetros de configuração para URLs e reservas de URL. Esses parâmetros de configuração têm propósitos muito diferentes e regras para modificação. Se estiver acostumado a modificar arquivos de configuração para ajustar uma implantação, este tópico pode ajudá-lo a entender como cada configuração de URL é usada.

Configurações de URL no arquivo RSReportServer.config

O Reporting Services armazena URLs para acesso a aplicativos e relatórios, bem como para conectar componentes front-end da Web a um servidor de relatório back-end.

URLs para acesso a aplicativos

As URLs são usadas para acessar o serviço Web Servidor de Relatórios e o portal da Web. Para configurar as URLs, você deve usar a ferramenta Configuração do Reporting Services. A ferramenta cria as reservas de URL para cada aplicativo em HTTP.SYS e adiciona entradas para as URLs na seção URLReservations de RSReportServer.config.

URLs para acesso a relatórios

O Reporting Services inclui uma extensão de entrega de email do servidor de relatório que você pode usar para enviar links de relatórios ou anexos. Um link de relatório é construído quando o relatório é entregue. A extensão de entrega de email do servidor de relatório usa a configuração UrlRoot no arquivo de configuração para criar o link. UrlRoot também é usada para resolver links em um relatório renderizado que é gerado por processamento de relatório autônomo.

UrlRoot será especificada automaticamente no arquivo RSReportServer.config quando você configurar as URLs para acesso a aplicativos. Se você modificar esse valor no arquivo de configuração, deverá especificar um endereço de URL válido para um serviço Web Servidor de Relatórios que esteja conectado a um banco de dados do servidor de relatório que contém os relatórios que você deseja entregar. Você pode especificar apenas uma UrlRoot para uma única instância do servidor de relatório; apenas uma entrada UrlRoot pode existir no arquivo RSReportServer.config para qualquer instância específica do servidor de relatório. Se você tiver várias URLs reservadas para o serviço Web Servidor de Relatórios, deverá escolher um dos valores disponíveis para UrlRoot.

Na maioria dos casos, não é necessário modificar UrlRoot. Entretanto, se o servidor de relatório for ser acessado por uma URL totalmente qualificada e você não tiver configurado uma URL que usa um cabeçalho de host para o nome do site totalmente qualificado, você deverá editar manualmente RSReportServer.config para definir a UrlRoot como a URL totalmente qualificada do servidor de relatório que será usada para renderizar o relatório (por exemplo, https://www.adventure-works.com/mywebapp/reportserver).

URLs conectando o portal da Web e Web Parts ao serviço Web Servidor de Relatórios

O portal da Web e o SharePoint 2.0 Web Parts para Reporting Services são componentes front-end da Web que se conectam a um servidor de relatório. As URLs usadas para conexão a um servidor de relatório back-end incluem o seguinte:

  • ReportServerUrl (usada pelo portal da Web)

  • ReportServerExternalUrl (usado pelo Web Parts)

Observação

As versões anteriores do Reporting Services incluíam o elemento ReportServerVirtualDirectory . Esse valor está obsoleto no SQL Server 2008 (10.0.x) e versões posteriores. Se você atualizou uma instalação existente e estiver usando um arquivo de configuração que contenha essa configuração, o servidor de relatório não lerá mais esse valor.

A tabela a seguir fornece um resumo de todas as URLs que podem ser especificadas em um arquivo de configuração do Reporting Services.

Configuração Uso Descrição
ReportServerUrl Opcional. Este elemento não será incluído no arquivo RSReportServer.config a menos que você mesmo o adicione.

Só defina este elemento se você estiver configurando um dos seguintes cenários:

O portal da Web fornece acesso front-end da Web a um serviço Web Servidor de Relatórios que é executado em um computador diferente ou em uma instância diferente no mesmo computador.

Quando existem várias URLs para um servidor de relatório e você deseja que o portal da Web use uma URL específica.

Você tem uma URL específica do servidor de relatório pela qual deseja que todas as conexões do portal da Web use.

Por exemplo, você poderia habilitar o acesso do portal da Web a todos os computadores na rede e ainda requerer que o portal da Web se conecte ao servidor de relatório por meio de uma conexão local. Nesse caso, você pode configurar ReportServerUrl como “https://localhost/reportserver”.		 Esse valor especifica uma URL para o serviço Web Servidor de Relatórios. Esse valor é lido pelo aplicativo do portal da Web durante a inicialização. Se esse valor for definido, o portal da Web será conectado ao servidor de relatório que está especificado na URL.

Por padrão, o portal da Web fornece acesso front-end da Web ao serviço Web Servidor de Relatórios que é executado na mesma instância do servidor de relatório que o portal da Web. Entretanto, para usar o portal da Web com um serviço Web Servidor de Relatórios que faz parte de outra instância ou é executado em uma instância em um computador diferente, é possível configurar essa URL de maneira a instruir o portal da Web a conectar-se ao serviço Web Servidor de Relatórios externo.

Se um certificado do protocolo TSL, anteriormente conhecido como protocolo SSL, estiver instalado no servidor de relatório ao qual você está se conectando, o valor de ReportServerUrl deverá ser o nome do servidor que está registrado para esse certificado. Caso receba a mensagem de erro "A conexão subjacente foi fechada: não foi possível estabelecer uma relação de confiança com o canal de segurança SSL/TLS", defina ReportServerUrl como o nome de domínio totalmente qualificado do servidor para o qual o certificado TLS/SSL foi emitido. Por exemplo, se o certificado estivesse registrado para https://adventure-works.com.onlinesales, a URL do servidor de relatório seria https://adventure-works.com.onlinesales/reportserver.
ReportServerExternalUrl Opcional. Este elemento não será incluído no arquivo RSReportServer.config a menos que você mesmo o adicione.

Defina este elemento apenas se você estiver usando o SharePoint 2.0 Web Parts e deseja que os usuários possam recuperar um relatório e abri-lo em uma nova janela do navegador.

Adicione <ReportServerExternalUrl> abaixo do elemento <ReportServerUrl> e configure-o com o nome do servidor de relatório totalmente qualificado que é resolvido para uma instância do servidor de relatório quando acessado em uma janela separada do navegador. Não exclua <ReportServerUrl>.

O exemplo a seguir ilustra a sintaxe:

<ReportServerExternalUrl>https://myserver/reportserver</ReportServerExternalUrl>		 Este valor é usado pelo SharePoint 2.0 Web Parts.

Em versões anteriores, era recomendado configurar esse valor para implantar o Construtor de Relatórios em um servidor de relatório na Internet. Esse é um cenário de implantação não testado. Se você usava essa configuração para oferecer suporte de acesso à Internet ao Construtor de Relatórios, deverá considerar uma estratégia alternativa.

Conteúdo relacionado