Partilhar via

  • Artigo

URLs em arquivos de configuração (Reporting Services)

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, e 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 Gerenciador de Relatórios. 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 do arquivo de configuração para criar o link. UrlRoot também é usada para resolver links em um relatório renderizado que é gerado por meio do processamento autônomo de relatórios.

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 será acessado por uma URL totalmente qualificada e você não configurou uma URL que use um cabeçalho de host para o nome de site totalmente qualificado, você deverá editar manualmente o arquivo 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 Gerenciador de Relatórios e Web Parts ao serviço Web Servidor de Relatórios

O Gerenciador de Relatórios e o SharePoint 2.0 Web Parts for 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 Gerenciador de Relatórios)

  • ReportServerExternalUrl (usada pelo Web Parts)

ObservaçãoObservação

As versões anteriores do Reporting Services incluíam o elemento ReportServerVirtualDirectory. Esse valor é obsoleto no SQL Server 2008. 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 mais lerá 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 Gerenciador de Relatórios 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 Gerenciador de Relatórios use uma URL específica.

  • Você tem uma URL específica do servidor de relatório pela qual você deseja que todas as conexões do Gerenciador de Relatórios use.

    Por exemplo, você poderia habilitar o acesso do Gerenciador de Relatórios a todos os computadores na rede e ainda requerer que o Gerenciador de Relatórios conecte-se ao servidor de relatório por meio de uma conexão local. Nesse caso, você poderia configurar ReportServerUrl como "https://localhost/reportserver".

Para obter instruções sobre como implementar esses cenários, consulte Como configurar o Gerenciador de Relatórios nos Manuais Online do SQL Server.

Esse valor especifica uma URL para o serviço Web Servidor de Relatórios. Esse valor é lido pelo aplicativo Gerenciador de Relatórios durante a inicialização. Se esse valor for definido, o Gerenciador de Relatórios será conectado ao servidor de relatório que está especificado na URL.

Por padrão, o Gerenciador de Relatórios 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 Gerenciador de Relatórios. Entretanto, para usar o Gerenciador de Relatórios 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 Gerenciador de Relatórios a conectar-se ao serviço Web Servidor de Relatórios externo.

Se um certificado SSL (Secure Sockets Layer) 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. Se você obtiver o erro "A conexão subjacente foi fechada: Não foi possível estabelecer uma relação de confiança para o canal de segurança SSL/TLS", defina ReportServerUrl como o nome de domínio totalmente qualificado do servidor para o qual o certificado SSL foi emitido. Por exemplo, se o certificado estiver 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 como o nome de um servidor de relatório totalmente qualificado que seja resolvido para uma instância do servidor de relatório quando for acessado em uma janela separada do navegador. Não exclua <ReportServerUrl>.

O exemplo a seguir ilustra a sintaxe:

<ReportServerExternalUrl>http://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.