Implantando modelos e fontes de dados compartilhadas em um site do SharePoint

Para implantar relatórios, modelos de relatório, fontes de dados compartilhadas e recursos a uma biblioteca do SharePoint, você pode publicar o conteúdo, usando as ferramentas de criação (Designer de Relatórios, Construtor de Relatórios e Designer de Modelo) Reporting Services ou você 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. É necessário saber como criar um endereço de URL que especifique o servidor do SharePoint, bem como o local na hierarquia do site do SharePoint onde você deseja publicar um relatório ou itens relacionados. Ao usar o Designer de Relatórios, Construtor de Relatórios ou Designer de Modelo para publicar relatórios e arquivos relacionados para 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.

Além disso, referências em uma definição de relatório para fontes de dados compartilhadas, sub-relatórios e recursos, como as imagens com base na Web, devem ser todas URLs totalmente qualificadas com uma 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, https://servername) e pode ter diversos sites.

Site

Um site é um site pai para 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, https://servername.

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, https://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 de 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://nomedoservidor/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 (https://server) 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.

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 Documents/CompanySales.rdl

O relatório de exemplo de vendas da empresa em Documentos em uma instância do Office SharePoint Server  SharePoint Server 2010.

http://TestServer/TestSite/Documents/Doc/CompanySales.rdl

O relatório de exemplo de vendas da empresa em Central de Relatórios em uma instância do Office SharePoint Server  SharePoint Server 2010.

http://TestServer/TestSite/Reports/Doc/CompanySales.rdl

Publicando de uma ferramenta de criação para uma biblioteca do SharePoint

Ao usar o Designer de Relatórios, Construtor de Relatórios ou Designer de Modelo para publicar relatórios e arquivos relacionados para 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.

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 a pasta de destino da fonte de dados em branco, a fonte de dados será publicada na pasta de relatório de destino.

Fontes de dados compartilhadas do Modelo de Relatórios

Se você estiver publicando fontes de dados compartilhadas (arquivos .rds ou arquivos .smdl) de um projeto de Modelo de Relatório, deverá usar uma URL que especifique a biblioteca de destino. 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, será criada uma. O seu modelo (.smdl) e sua fonte de dados compartilhada (.rsds) são publicadas nesta pasta, por exemplo, http://nome_do_servidor/site/Documents/Data Sources.

Nomes dos arquivos

Os nomes dos arquivos em uma URL para itens de relatório devem incluir uma extensão do nome do 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: # % & * : < > ? / { | }.

Se sua definição de relatório incluir referências a sub-relatórios, a URL totalmente qualificada para o sub-relatório deverá ser especificada. Você não pode especificar uma pasta relativa; caminhos relativos não são válidos.

Definindo referências para itens dependentes

Para relatórios que tenham sido criados, usando o Construtor de Relatórios, a definição de relatório inclui referências ao modelo de relatório e à fonte de dados do modelo usada para construir o relatório. Esses estão especificados no arquivo de definição de relatório. Se você adicionar esse relatório a um projeto de Servidor de Relatório no Designer de Relatórios para fazer alterações e, em seguida, publicá-lo em uma biblioteca do SharePoint, deverá abrir o relatório da biblioteca do SharePoint e associar novamente a referência da fonte de dados. Você deve associar novamente a fonte de dados somente quando publicar o relatório pela primeira vez. O servidor de relatório não pode determinar a partir de definições de relatório se a fonte de dados está em um arquivo .rsds ou em um arquivo .smdl. Para obter mais informações, consulte Como associar um relatório ou modelo a uma fonte de dados compartilhada.

Publicando itens anteriores ao SP2 em um site do SharePoint

Para publicar definições de relatório, modelos de relatório e fontes de dados compartilhadas criadas em versões de ferramenta de criação anteriores ao SP2, você deve abrir ou criar um projeto na versão SP2 da ferramenta e, em seguida, publicar os arquivos.

Uma alternativa é carregar os arquivos diretamente do sistema de arquivos para uma biblioteca do SharePoint e, em seguida, executar o relatório para verificar se está funcionado. Você deve definir as referências para qualquer item dependente antes de executar o relatório.

Diferenças entre carregamento e publicação

Ao usar o Designer de Relatórios, Construtor de Relatórios ou Designer de Modelo para publicar relatórios e arquivos relacionados para 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.