Exemplos de URL para itens em um servidor de relatório – modo do SharePoint
Para publicar relatórios e itens relacionados em uma biblioteca do SharePoint, você pode publicar o conteúdo usando as ferramentas de criação do Reporting Services, como o Designer de Relatórios. Você também pode carregar o conteúdo usando ações de site do SharePoint.
Os sites do SharePoint usam endereços da Web diferentes do que um servidor de relatório Reporting Services em modo nativo. A hierarquia da Web do site do SharePoint inclui o aplicativo do SharePoint Web, um site de alto nível, subsites opcionais e bibliotecas. Você deve saber criar uma URL que especifique o servidor do SharePoint e o local na hierarquia do site do SharePoint em que você deseja publicar um relatório ou itens relacionados.
Os itens relacionados a um relatório incluem fontes de dados compartilhadas, sub-relatórios, relatórios detalhados e recursos como arquivos de imagem com base na Web. Um relatório publicado em uma biblioteca do SharePoint deve especificar esses itens relacionados por local na biblioteca do SharePoint.
Use os exemplos deste artigo para ajudar a criar URLs para relatórios e itens relacionados em suas soluções de relatórios.
Hierarquia do site
Ao configurar um servidor de relatório para ser executado no modo integrado do SharePoint, a hierarquia da Web do SharePoint é usada para direcionar os itens que serão processados e gerenciados no servidor de relatório.
Podem ser usados os seguintes elementos da hierarquia da Web para acessar e proteger o conteúdo do servidor de relatório. Outros objetos, como listas e páginas, não são usados para acessar o conteúdo do servidor de relatório e; portanto, não são descritos na tabela a seguir.
| Objeto | Descrição |
|---|---|
| Aplicativo Web do SharePoint | Um aplicativo da Web do SharePoint pode ser instalado como um servidor autônomo ou em um farm que tenha uma coleção de servidores virtuais. Um aplicativo Web tem uma URL (por exemplo, http:*//servername*) e pode conter vários sites. |
| Site | Um site é um site pai de um aplicativo da Web ou um subsite. |
| Biblioteca do SharePoint | Uma biblioteca contém documentos ou pastas. Uma biblioteca ou pasta em uma biblioteca é o único objeto do site que pode armazenar relatórios, modelos de relatório, fontes de dados compartilhadas e imagens externas. |
| Item | Os itens do servidor de relatório que podem ser descritos em uma URL incluem uma definição de relatório para um relatório ou sub-relatório, um modelo de relatório, uma fonte de dados compartilhada ou uma imagem externa. |
Sintaxe de URL e regras
Você pode identificar cada item do servidor de relatório em uma biblioteca por sua URL totalmente qualificada. A URL inclui um prefixo de protocolo, nome do servidor, site, biblioteca, nome de arquivo e extensão de nome de arquivo para o tipo de arquivo.
URL para um servidor SharePoint
Você deve usar uma URL para o servidor SharePoint ao implantar um Servidor de Relatório ou um projeto de Modelo de Relatório do SQL Server Data Tools (SSDT) no servidor de relatório.
Para localizar o nome do servidor a ser usado, abra o navegador e localize a biblioteca do SharePoint onde deseja publicar um relatório. O nome do servidor é exibido imediatamente após o prefixo do protocolo, por exemplo, http:*//servername*.
O uso do ponto de extremidade de proxy de URL do Reporting Services não é compatível. Um ponto de extremidade de proxy inclui um número da porta, por exemplo, http:*//servername:8080/reportserver*.
URL para um site ou subsite de servidor do SharePoint
Ao implantar uma fonte de dados de relatório, você deve usar uma URL para um site e subsite do SharePoint, caso haja um. Na URL, o nome do site é exibido imediatamente após o nome do servidor, por exemplo, https://*servername/site* ou https://*servername/site/subsite*.
Em um aplicativo Web do Microsoft Office SharePoint Server 2007 ou do SharePoint Server 2010, o site e o subsite com frequência correspondem às guias no site principal. Para encontrar o nome do site ou do subsite, selecione Página inicial e Todo o conteúdo do site. Role para a parte inferior e procure por Sites e Workspaces. A lista dos sites aparece nesta seção.
URL para uma biblioteca do SharePoint
Ao implantar um relatório ou um item relacionado à biblioteca do SharePoint, você deve usar uma URL para biblioteca do SharePoint. A URL a ser usada para uma biblioteca difere dependendo da versão do SharePoint que você usa.
No Microsoft Windows SharePoint Services 3.0 ou SharePoint Foundation 2010, a biblioteca é exibida após o nome do servidor, por exemplo, https://*servername/*Shared Documents.
No Office SharePoint Server 2007 ou no SharePoint Server 2010, a biblioteca aparece depois do site e do subsite. Por exemplo, https://*servername/site/*Documents.
Para localizar as informações de caminho para uma nova biblioteca do SharePoint ou para um site desconhecido, abra o navegador e localize a biblioteca do SharePoint onde deseja publicar seus relatórios. Se a biblioteca estiver vazia, carregue qualquer arquivo. Clique com o botão direito do mouse no arquivo e selecione Propriedades para abrir a janela Propriedades . O endereço do arquivo contém os valores da URL necessários para a publicação.
URLs completamente qualificados para os itens em um site do SharePoint
Os itens armazenados em uma biblioteca do SharePoint são sempre endereçados por meio de uma URL totalmente qualificada que começa com o aplicativo Web (https://*server*) como o nó raiz e termina com o nome do arquivo que está sendo referenciado.
Os nomes de arquivo na URL devem incluir uma extensão de nome de arquivo.
Você não pode usar URLs relativas para itens dependentes nos relatórios que você publica em um site do SharePoint. Por exemplo, você não pode usar uma URL relativa para mencionar uma fonte de dados compartilhada, modelo de relatório ou sub-relatório. Você sempre tem que especificar a URL totalmente qualificada a uma biblioteca do SharePoint para cada item. Não há como prever onde um arquivo dependente pode estar localizado. Você não pode prever isso porque não há hierarquia predefinida para os sites que você pode usar para analisar um formato de URL.
Ao publicar ou carregar um relatório que tenha itens dependentes, você deve definir as referências aos itens dependentes após o relatório ser publicado. Não há garantia de que as referências que funcionaram corretamente no modo de visualização no Designer de Relatórios funcionem após o relatório ser publicado. Para obter mais informações, consulte Publicação de uma ferramenta de autoria em uma biblioteca do SharePoint neste artigo.
URLs para imagens externas
Uma definição de relatório pode incluir um arquivo de imagem armazenado como um arquivo externo. Você pode mencionar aquele arquivo na definição de relatório, definindo uma URL totalmente qualificada para um arquivo de imagem. Pode ser armazenado em um site do SharePoint ou em um computador remoto.
Importante
Se a URL externa for referente a uma imagem contida em um site do SharePoint, o ícone de imagem quebrada aparecerá quando você visualizar o relatório no Construtor de Relatórios. Quando você carregar o relatório no site do SharePoint e o renderizar no modo conectado, o ícone de imagem quebrada aparecerá se você tiver apenas as permissões View Items .
Independentemente do modo do servidor de relatório, as referências a um arquivo de imagem externa em um relatório devem se uma URL totalmente qualificada. Também, a referência a um arquivo de imagem externa, geralmente, exige que você configure a conta de processamento de relatório autônomo.
Especifique sub-relatórios e relatórios detalhados
Os sub-relatórios devem residir na mesma pasta que o relatório principal. Não é possível especificar uma pasta relativa.
Para especificar relatórios detalhados, inclua a URL em uma expressão. Por exemplo, especifique o relatório chamado SalesDetails como um relatório de detalhamento. Na Ação para a caixa de texto ou texto de espaço reservado, defina ReportName para a seguinte expressão:
="https://site/subsite/documentlibrary/SalesDetails.rdl"
Nomes reservados nos sites do SharePoint
Se você está criando ou construindo uma URL para um item localizado em um site do SharePoint, saiba que ambas as palavras Pessoal e Sites são nomes reservados no site padrão.
Exemplos de URLs
Ao publicar itens a uma biblioteca do SharePoint, você deve especificar as URLs totalmente qualificadas à biblioteca de destino. Uma URL totalmente qualificada do SharePoint inclui o aplicativo da Web do SharePoint, o site, a biblioteca, a pasta (opcional), o arquivo e a extensão de nome de arquivo. Os exemplos seguintes fornecem diversas ilustrações da sintaxe que você deve usar.
| Destino | Exemplo de URL |
|---|---|
| Um servidor do SharePoint. | https://TestServer |
| Um site ou subsite do servidor do SharePoint. | https://TestServer/toplevelsite/subsite |
| O relatório de exemplo de vendas da empresa em Documentos Compartilhados em uma implantação do Windows SharePoint Services ou do SharePoint Foundation 2010 . | https://TestServer/TestSite/Shared%20Documents/Company%20Sales.rdl |
| O relatório de exemplo Company Sales na pasta Documents/Doc em uma instância do Office SharePoint Server ou do SharePoint Server 2010 . | https://TestServer/TestSite/Documents/Doc/Company%20Sales.rdl |
| O relatório de exemplo de vendas da empresa na Central de Relatórios em uma instância do Office SharePoint Server ou do SharePoint Server 2010 . | https://TestServer/TestSite/Reports/Doc/Company%20Sales.rdl |
Publicar de uma ferramenta de autoria em uma biblioteca do SharePoint
Quando você usa a ferramenta de criação de relatório para publicar relatórios e arquivos relacionados em uma biblioteca, os arquivos são validados antes de serem adicionados. Se você carregar os relatórios e os arquivos relacionados, usando a ação Carregar na biblioteca do SharePoint, nenhuma validação ocorrerá. Você não sabe se o arquivo é válido até acessar o relatório gerenciando-o, editando-o ou executando-o.
Observação
Para publicar relatórios em um site do SharePoint pelo SQL Server Data Tools (SSDT), é necessário adicionar esse site do SharePoint à lista de locais confiáveis no navegador Internet Explorer.
Fontes de dados compartilhadas
Ao publicar um fonte de dados compartilhada a partir de uma ferramenta de criação, você define a propriedade do projeto TargetDataSourceFolder. A pasta de destino da fonte de dados deve ser uma URL em uma biblioteca do SharePoint. Diferentemente do modo nativo do Reporting Services, você não pode especificar uma pasta relativa; caminhos relativos não são válidos. Se não existir uma pasta no caminho da Biblioteca de Documentos, uma será criada.
Quando você publica um arquivo de fonte de dados compartilhada (.rds) em um site do SharePoint, essa ação altera o arquivo de fonte de dados compartilhada para uma extensão de nome de arquivo .rsds. O .arquivo rsds não poderá ser salvo no local de um site do SharePoint e importado em um projeto existente Reporting Services . Fontes de dados compartilhadas com extensões de nome de arquivo .rds e .rsds não são intercambiáveis.
Fontes de dados compartilhadas do Designer de Relatórios
Se você estiver publicando fontes de dados compartilhadas de um projeto de Designer de Relatórios, poderá usar uma URL que especifique a biblioteca de destino ou poderá deixar a propriedade em branco. Diferentemente do modo nativo do Reporting Services, você não pode especificar uma pasta relativa; caminhos relativos não são válidos. Se não existir uma pasta no caminho da Biblioteca de Documentos, uma será criada. Se você deixar em branco a pasta de destino da fonte de dados, a fonte de dados será publicada na pasta de relatório de destino.
Nomes de arquivo
Os nomes de arquivos em uma URL para itens de relatório devem incluir uma extensão de nome de arquivo. A extensão do nome do arquivo determina o tipo de arquivo. Ao publicar itens de relatórios de uma ferramenta de criação de relatório, a extensão do nome do arquivo é incluída automaticamente. Se você carregar um item de relatório para uma biblioteca do SharePoint, deverá incluir uma extensão do nome do arquivo.
Se você não especificar uma extensão de nome de arquivo para itens carregados em um site do SharePoint, ocorrerá o erro rsInvalidDataSourceReference. Os nomes de arquivo podem não incluir caracteres que não sejam reconhecidos como caracteres de nome de arquivo válidos pelos aplicativos do SharePoint. Não inclua os seguintes caracteres: # % & * : < > ? / { | }.
Diferenças entre carregamento e publicação
Ao usar o Report Designer ou o Report Builder para publicar relatórios e arquivos relacionados em uma biblioteca, o sistema valida os arquivos antes de adicioná-los. Se você carregar os relatórios e os arquivos relacionados, usando a ação Carregar na biblioteca do SharePoint, nenhuma validação ocorrerá. Você não sabe se o arquivo é válido até acessar o relatório gerenciando-o, editando-o ou executando-o.
Atualizar um item publicado
Após publicar ou carregar um item em uma biblioteca do SharePoint, você deverá fazer check-out do item na biblioteca antes de atualizá-lo. Enquanto o relatório é verificado para você, você é o único usuário que tem permissão para alterar o relatório. Quando terminar, verifique novamente.
Você pode carregar ou publicar um relatório sem fazer check-out do documento primeiro, por exemplo, carregando um item que tenha o mesmo nome de um item existente. Se você fizer isso, o servidor de relatório fará check-out para você, adicionará o relatório atualizado como uma nova versão do item existente e, em seguida, fará o check-in do documento novamente.
Imagens externas como recursos
Um servidor de relatório executado no modo nativo oferece suporte ao conceito de um recurso. O conceito de recurso é definido como qualquer arquivo armazenado e protegido no servidor de relatório, mas o servidor de relatório não o processa. Em modo nativo, pode haver qualquer tipo de arquivo.
Quando um servidor de relatório é executado no modo integrado do SharePoint, o conceito de um recurso tem uma definição mais restrita. O servidor de relatório retém o conceito de um recurso para armazenar relatórios referentes a uma imagem externa. Esse conceito se aplicará se o relatório for um instantâneo ou uma cópia, mantidos para uso interno.