Partilhar via

Conexões de conexão de lista do SharePoint (SSRS)

  • Artigo

Aplica-se a: SQL Server 2016 (13.x) Servidor de Relatórios do Power BI SharePoint

Para incluir dados de uma lista do Microsoft SharePoint no relatório, você deve adicionar ou criar um conjunto de dados baseado em uma fonte de dados de relatório do tipo Lista do Microsoft SharePoint. Esse é um tipo de fonte de dados interna baseado na extensão de dados Lista do SharePoint do Microsoft SQL Server Reporting Services. Use esse tipo de fonte de dados para se conectar e recuperar dados da lista do SharePoint 2013 e posterior.

Use as informações deste tópico para criar uma fonte de dados. Para ver instruções passo a passo, confira Adicionar e verificar uma conexão de dados (Construtor de Relatórios e SSRS).

Cadeia de conexão

A cadeia de conexão de uma lista do SharePoint é a URL para o site do SharePoint ou subsite, por exemplo, https://MySharePointWeb/MySharePointSite ou https://MySharePointWeb/MySharePointSite/Subsite.

O designer de consulta exibe automaticamente as listas do SharePoint às quais você tem permissões suficientes para acessar.

Para ver mais exemplos de cadeias de conexão, confira Criar cadeias de conexão de dados – Construtor de Relatórios e SSRS.

Credenciais

As credenciais são necessárias para executar consultas, visualizar o relatório localmente e visualizá-lo no servidor de relatório. Após a publicação do relatório, talvez seja necessário alterar as credenciais da fonte de dados para que, quando o relatório for executado no servidor de relatório, as permissões recuperadas sejam válidas. Os tipos de credenciais que podem ser usados com essa extensão de dados dependem da configuração da tecnologia do SharePoint para a lista do SharePoint que você está usando como uma fonte de dados.

As tabelas a seguir esboçam o comportamento da recuperação de credenciais para a extensão de lista do SharePoint, ao conectar-se a uma lista de farm local do SharePoint e a uma lista remota do SharePoint.

ATabela 1 se destina a relatórios implantados para um site herdado do Windows SharePoint. Um site herdado do Windows dá suporte apenas ao Kerberos, ao NTLM e à FBA (Autenticação Baseada em Formulários). ATabela 2 se destina a relatórios implantados para um site do SharePoint baseado em declarações.

Tabela 1

Tipo de recuperação Credenciais com suporte Modo clássico de Autenticação do Windows \* Autenticação de declarações
Lista de farm local do SharePoint Autenticação do Windows (integrada) ou token de usuário do SharePoint Sim Sim
Armazenado, Prompt, Nenhum (com credenciais do Windows)

Não há suporte para credenciais armazenadas e de prompt com credenciais que não sejam do Windows.		 Sim Não
Lista remota do SharePoint Autenticação do Windows (integrada) ou token de usuário do SharePoint Sim Não

A autenticação baseada em formulários e a autenticação baseada em declarações não têm suporte para listas remotas do SharePoint.
Armazenado, Prompt, Nenhum (com credenciais do Windows)

Não há suporte para credenciais armazenadas e de prompt com credenciais que não sejam do Windows.		 Sim Não

A autenticação baseada em formulários e a autenticação baseada em declarações não têm suporte para listas remotas do SharePoint.

*A autenticação do Windows, a FBA (autenticação baseada em formulários), os tokens SAML (linguagem de marcação de aplicativos seguros), outros provedores de identidade ou uma combinação de mais de um dos provedores de autenticação citados anteriormente.

Tabela 2

Tipo de recuperação Credenciais com suporte Modo clássico de Autenticação do Windows \* Autenticação de declarações
Lista de farm local do SharePoint Autenticação do Windows (integrada) ou token de usuário do SharePoint Sim Sim
Armazenado, Prompt, Nenhum (com credenciais do Windows)

Não há suporte para credenciais armazenadas e de prompt com credenciais que não sejam do Windows.		 Não Não
Lista remota do SharePoint Autenticação do Windows (integrada) ou token de usuário do SharePoint Sim Não

A autenticação baseada em formulários e a autenticação baseada em declarações não têm suporte para listas remotas do SharePoint.
Armazenado, Prompt, Nenhum (com credenciais do Windows)

Não há suporte para credenciais armazenadas e de prompt com credenciais que não sejam do Windows.		 Não Não

A autenticação baseada em formulários e a autenticação baseada em declarações não têm suporte para listas remotas do SharePoint.

*A autenticação do Windows, a FBA (autenticação baseada em formulários), os tokens SAML (linguagem de marcação de aplicativos seguros), outros provedores de identidade ou uma combinação de mais de um dos provedores de autenticação citados anteriormente.

Autenticação do Windows
Para uma tecnologia do SharePoint configurada para funcionar com um servidor de relatório no modo Conta Confiável, não há suporte a essa opção. Isso aplica-se apenas às versões anteriores do SQL Server 2012 Reporting Services.

Para uma tecnologia do SharePoint configurada para funcionar com um servidor de relatório no modo Windows Integrado, essa opção se aplica tanto ao usuário do Windows atual quanto ao usuário do SharePoint atual.

Para uma tecnologia do SharePoint configurada para funcionar sem um servidor de relatório (modo local), não há suporte a essa opção. Para obter mais informações sobre o modo local, confira Modo Local versus Modo Conectado no Visualizador de Relatórios (Reporting Services no modo do SharePoint).

Não são necessárias credenciais (Não use credenciais):
Para usar essa opção, a conta de execução autônoma deve ser configurada no servidor de relatório. Para obter mais informações, confira Configurar a Conta de Execução Autônoma (Configuration Manager do Servidor de Relatório).

Para saber mais, confira Criar sequências de conexão de dados – Construtor de Relatórios e SSRS, Especificar as credenciais e as informações de conexão para fontes de dados de relatórios e Fontes de dados compatíveis com o Reporting Services (SSRS).

Consultas

Para criar uma consulta, crie um novo conjunto de dados com base na fonte de dados e, em seguida, abra o designer de consulta associado. Para obter mais informações, confira Criar um conjunto de dados compartilhado ou um conjunto de dados inserido (Construtor de Relatórios e SSRS).

O designer de consulta gráfica de Lista do SharePoint exibe quatro painéis:

Listas do SharePoint Exibe uma lista de todas as listas do SharePoint no site para esta fonte de dados. Selecione uma lista e os campos que você deseja na consulta. Os nomes de campos nesse painel são nomes amigáveis com o SharePoint, também conhecidos como nomes para exibição. Focalize um item para exibir as seguintes propriedades na dica de ferramenta:

  • Nome O nome exclusivo do campo.

  • Identificador O identificador exclusivo do campo.

  • Tipo de Campo O tipo de dados do campo.

  • Oculto Se o campo é mostrado na exibição de lista do SharePoint.

Não há suporte para a seleção de campos de várias listas. Você pode criar um conjunto de dados para cada lista e selecionar os campos de cada conjunto de dados. Se as listas tiverem um campo comum, você poderá usar a função Lookup em uma região de dados tablix que está vinculada a um conjunto de dados para recuperar um valor do outro conjunto de dados que não está vinculado à região de dados. Para obter mais informações, confira Função de pesquisa (Construtor de Relatórios e SSRS).

  • Campos Selecionados Exibe os campos selecionados por você. Os nomes de campos nesse painel são nomes amigáveis especificados por um usuário do SharePoint. Quando fecha o designer de consulta, você visualiza esses nomes na coleção de campos do conjunto de dados no painel de dados do relatório. A relação entre nomes exclusivos e nomes amigáveis está disponível na página Caixa de diálogo Propriedades do conjunto de dados, Campos (Construtor de Relatórios).

  • Filtros Aplicados Limita os dados retornados da lista do SharePoint, antes que esses dados sejam retornados ao relatório. Selecione o nome do campo, o operador e o valor a ser usado para limitar os dados recuperados na lista. Os operadores variam de acordo com o tipo de dados do valor selecionado.

    Não é possível alterar a ordem de classificação, nem especificar grupos no designer de consulta gráfica. Para fazer isso, defina expressões de classificação no conjunto de dados do relatório e expressões de grupo nas regiões de dados no relatório. Não há suporte para os parâmetros de consulta. Para filtrar dados no relatório, use filtros de relatório ou parâmetros de relatório criados por você. Para obter mais informações, confira Filtrar, agrupar e classificar dados (Construtor de Relatórios e SSRS) e Parâmetros de relatório (Construtor de Relatórios e Designer de Relatórios).

  • Resultados da Consulta Exibe linhas de exemplo que são retornadas quando a consulta é executada. Se os valores da lista do SharePoint forem alterados com frequência no site do SharePoint, os valores que você visualiza no painel de resultados da consulta poderão ser diferentes dos valores exibidos no relatório.

  • Campos Selecionados Exibe os campos selecionados por você. Os nomes de campos nesse painel são nomes amigáveis especificados por um usuário do SharePoint. Quando fecha o designer de consulta, você visualiza esses nomes na coleção de campos do conjunto de dados no painel de dados do relatório. A relação entre nomes exclusivos e nomes amigáveis está disponível na página Caixa de diálogo Propriedades do conjunto de dados, Campos (Construtor de Relatórios).

  • Filtros Aplicados Limita os dados retornados da lista do SharePoint, antes que esses dados sejam retornados ao relatório. Selecione o nome do campo, o operador e o valor a ser usado para limitar os dados recuperados na lista. Os operadores variam de acordo com o tipo de dados do valor selecionado.

    Não é possível alterar a ordem de classificação, nem especificar grupos no designer de consulta gráfica. Para fazer isso, defina expressões de classificação no conjunto de dados do relatório e expressões de grupo nas regiões de dados no relatório. Não há suporte para os parâmetros de consulta. Para filtrar dados no relatório, use filtros de relatório ou parâmetros de relatório criados por você. Para obter mais informações, confira Filtrar, agrupar e classificar dados (Construtor de Relatórios e SSRS) e Parâmetros de relatório (Construtor de Relatórios e Designer de Relatórios).

  • Resultados da Consulta Exibe linhas de exemplo que são retornadas quando a consulta é executada. Se os valores da lista do SharePoint forem alterados com frequência no site do SharePoint, os valores que você visualiza no painel de resultados da consulta poderão ser diferentes dos valores exibidos no relatório.

Para obter mais informações, confira Designer de consultas da lista do SharePoint (Construtor de Relatórios).

Texto da consulta

Para exibir a consulta gerada pelo designer de consulta gráfica, alterne para o designer de consulta baseado em texto. Nessa exibição, você pode visualizar o XML criado pelo designer de consulta gráfica. O XML inclui elementos para o nome da lista, a coleção de campos e o filtro.

Exemplo 1. Campos especificados para uma lista

O seguinte exemplo mostra uma consulta do SharePoint bem formada:

<RSSharePointList>  
<listName>MyList</listName>  
<viewFields>  
  <FieldRef Name="Field1"/>  
  <FieldRef Name="Field4"/>  
</viewFields>  
<Query>  
  <Where>  
    <And>  
      <Gt>  
        <FieldRef Name="Field1"/>  
        <Value Type="Integer">1</Value>  
      </Gt>  
      <IsNotNull>  
        <FieldRef Name="Field2"/>  
        <Value Type="string"/>  
      </IsNotNull>   
    </And>  
  </Where>  
</Query>  
</RSSharePointList>

Você pode editar essa exibição da consulta, desde que ela permaneça como texto XML bem formado.

Exemplo 2. Todos os campos de uma lista

Também é possível especificar somente o nome de uma lista, e todos os campos, inclusive campos ocultos, são retornados. O seguinte exemplo recupera todos os campos de uma lista denominada Tarefas:

<RSSharePointList>  
<listName>Tasks</listName>  
</RSSharePointList>

Todos os campos da lista Tarefas são retornados nos resultados da consulta.

Parâmetros

Essa extensão de dados não dá suporte a parâmetros.

Tópicos de instruções

Esta seção contém instruções passo a passo para trabalhar com conexões de dados, fontes de dados e conjuntos de dados.

Adicionar e verificar uma conexão de dados (Construtor de Relatórios e SSRS)

Criar um conjunto de dados compartilhado ou um conjunto de dados inserido (Construtor de Relatórios e SSRS)

Adicionar um filtro a um conjunto de dados (Construtor de Relatórios e SSRS)

Estas seções da documentação fornecem informações conceituais detalhadas sobre dados de relatório, bem como informações de procedimentos sobre como definir, personalizar e usar partes de um relatório relacionadas aos dados.

Conjuntos de dados de relatório (SSRS)
Fornece uma visão geral de como acessar dados de seu relatório.

Criar cadeias de conexão de dados – Construtor de Relatórios e SSRS
Fornece informações sobre conexões de dados e fontes de dados.

Conjuntos de dados inseridos e compartilhados de relatório (Construtor de Relatórios e SSRS)
Fornece informações sobre conjuntos de dados inseridos e compartilhados.

Coleção de campos de conjuntos de dados (Construtor de Relatórios e SSRS)
Fornece informações sobre a coleção de campos de conjuntos de dados gerada pela consulta.

Fontes de Dados com suporte no Reporting Services (SSRS).
Fornece informações detalhadas sobre suporte à plataforma e à versão para cada extensão de dados.

Consulte Também

Parâmetros de relatório
Filtrar, agrupar e classificar dados
Expressões (Construtor de Relatórios e SSRS)

Mais perguntas? Experimente perguntar no fórum do Reporting Services