Publicando fontes de dados e relatórios em um site do SharePoint
Para publicar relatórios e fontes de dados compartilhadas 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 ou pode carregar o conteúdo usando as ações do 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, bem como 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 de detalhamento e recursos como arquivos de imagem com base na Web. Um relatório que tenha sido publicado em uma biblioteca do SharePoint deve especificar esses itens relacionados por local na biblioteca do SharePoint.
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 estão descritos na tabela seguinte.
Objeto |
Descrição |
|---|---|
Aplicativo da 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 da Web tem uma URL (por exemplo, http://nome_do_servidor) e pode ter diversos 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
Cada item do servidor de relatório em uma biblioteca é identificado por uma URL totalmente qualificada que inclui um prefixo de protocolo, nome do servidor, biblioteca, nome do arquivo e extensão do nome do 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 Business Intelligence Development Studio 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 aparece imediatamente depois do prefixo de protocolo, por exemplo, http://nome_do_servidor.
Usando o Reporting Services, o ponto de extremidade do proxy de URL não tem suporte. Um ponto de extremidade de proxy inclui um número de porta, por exemplo, http://nome_do_servidor: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 aparece imediatamente depois do nome de servidor, por exemplo, http://nome_do_servidor/site ou http://nome_do_servidor/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 localizar o nome do site ou do subsite, clique em Página Inicial e, em seguida, Todo Conteúdo do Site. Role para a parte inferior e procure por Sites e Espaços de trabalho. 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 usada para uma biblioteca difere dependendo da versão do SharePoint que você está usando.
No Microsoft Windows SharePoint Services 3.0 ou no SharePoint Foundation 2010, a biblioteca aparece depois do nome do servidor, por exemplo, http://nome_do_servidor/Documentos Compartilhados.
No Office SharePoint Server 2007 ou no SharePoint Server 2010, a biblioteca aparece depois do site e do subsite. Por exemplo, http://nome_do_servidor/site/Documentos.
Para localizar as informações de caminho para uma nova biblioteca ou 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 na biblioteca do SharePoint são sempre direcionados através de uma URL totalmente qualificada que se inicia com o aplicativo da Web (http://servidor) como o nó raiz e encerra com o nome do arquivo que você está mencionando.
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á com prever onde um arquivo dependente pode estar localizado, pois não há uma 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 neste tópico Publicando de uma ferramenta de criação para uma biblioteca do SharePoint.
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.
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.
Especificando sub-relatórios e relatórios de detalhamento
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 de detalhamento, inclua a URL em uma expressão. Por exemplo, para especificar o relatório denominado SalesDetails como um relatório de detalhamento, na caixa de texto ou no texto do espaço reservado Ação para, defina ReportName para a seguinte expressão:
="http://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. |
http://TestServer |
Um site ou subsite do servidor do SharePoint. |
http://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. |
http://TestServer/TestSite/Shared%20Documents/Company%20Sales.rdl |
O relatório de exemplo de vendas da empresa em Documentos em uma instância do Office SharePoint Server ou do SharePoint Server 2010. |
http://TestServer/TestSite/Documents/Doc/CompanySales.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. |
http://TestServer/TestSite/Reports/Doc/CompanySales.rdl |
Publicando de uma ferramenta de criação 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 saberá se o arquivo é válido até acessar o relatório, gerenciando, editando ou executando-o.
.gif "Observação") Observação |
|---|
Para publicar relatórios em um site do SharePoint pelo Business Intelligence Development Studio, é 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. Ao contrário do modo nativo Reporting Services, você não pode especificar uma pasta relativa e caminhos relativos não são válidos. Se não existir uma pasta no caminho da Biblioteca de Documentos, será criada uma.
Ao publicar um arquivo de fonte de dados compartilhada (.rds) em um site do SharePoint, um arquivo de fonte de dados compartilhada é alterada 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. As fontes de dados compartilhadas com as 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. Ao contrário do modo nativo no Reporting Services, não é possível especificar uma pasta relativa e caminhos relativos não são válidos. Se não existir uma pasta no caminho da Biblioteca de Documentos, será criada uma. 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 arquivos
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 do nome do arquivo para os itens que carregou para um site do SharePoint, o erro rsInvalidDataSourceReference irá ocorrer. Os nomes dos arquivos não devem incluir caracteres não 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
Quando você usa o Designer de Relatórios ou o Construtor de Relatórios 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 saberá se o arquivo é válido até acessar o relatório, gerenciando, editando ou executando-o.
Atualizando um item publicado
Após ter publicado ou carregado um item para uma biblioteca, você deve verificar o item da biblioteca antes de atualizá-lo. Enquanto o relatório é verificado, você será o único usuário a ter permissão para alterar o relatório. Quando tiver acabado, faça o check-in do arquivo.
Se você carregar ou publicar um relatório sem verificar o documento primeiro (por exemplo, carregando um item que tenha o mesmo nome que um item existente), o servidor de relatório irá verificar para você, adicionará o relatório atualizado como uma nova versão do item existente e, em seguida, fará o check-in do documento.
Imagens externas como recursos
Um servidor de relatório que está sendo executado no modo nativo oferece suporte ao conceito de um recurso, o qual é definido como qualquer arquivo armazenado e protegido no servidor de relatório, mas não é processado pelo servidor de relatório. 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. Isso se aplicará se o relatório for um instantâneo ou uma cópia, mantidos para uso interno.