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

Para incluir dados de uma lista do Microsoft SharePoint no relatório, você deve adicionar ou criar um conjunto de dados que se baseia 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 dos sites do SharePoint 2013, SharePoint Foundation 2010, SharePoint Server 2010, Windows SharePoint Services 3.0 e Office SharePoint Server 2007.

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

Neste artigo

Cadeia de Conexão

Consultas

Parâmetros

Tópicos de instruções

Seções relacionadas

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, http://MySharePointWeb/MySharePointSite ou http://MySharePointWeb/MySharePointSite/Subsite.

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

Para obter mais exemplos de cadeias de conexão, consulte Conexões de dados, fontes de dados e cadeias de conexão no Construtor de Relatórios.

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, convém alterar as credenciais da fonte de dados para que, quando o relatório for executado no servidor de relatórios, 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.

A Tabela 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). A Tabela 2 se destina a relatórios implantados para um site do SharePoint baseado em declarações.

Tabela 1

Tabela 2

1 Sem suporte para credenciais armazenadas e de prompt com credenciais que não sejam do Windows.

2 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.

3 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 só se aplica a versões anteriores do 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, consulte [Relatórios em modo Local x Conectado no Visualizador de Relatórios (Reporting Services no modo do SharePoint)](ff487969\(v=sql.110\).md).

• 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, consulte Configure a conta de execução autônoma.

Para obter informações sobre o suporte à autenticação de declarações na pilha Microsoft BI, consulte Usando a autenticação de declarações na pilha Microsoft BI.

Para obter mais informações, consulte Conexões de dados, fontes de dados e cadeias de conexão (SSRS), Especificar as credenciais no Construtor de Relatórios e Fontes de dados com suporte no 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, consulte 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 escolher os campos de cada conjunto de dados. Se as listas tiverem um campo comum, você pode usar a função de pesquisa 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, consulte Função Lookup (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, consulte Filtrar, agrupar e classificar dados (Construtor de Relatórios e SSRS) e Parâmetros de relatório (Construtor de Relatórios e SSRS).

• **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, consulte Filtrar, agrupar e classificar dados (Construtor de Relatórios e SSRS) e Parâmetros de relatório (Construtor de Relatórios e SSRS).

• **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, consulte Designer de Consulta de 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.

Voltar ao início

Solucionar problemas

Dados diferentes são retornados quando você usa a extensão de dados da Lista do SharePoint para um relatório no SSRS 2008 R2 ou SSRS 2012(https://support.microsoft.com/kb/2826162)

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 ou uma fonte 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)

Voltar ao início

Conteúdo relacionado

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.

• Adicionar dados a um relatório (Construtor de Relatórios e SSRS)
  Fornece uma visão geral de como acessar dados de seu relatório.

• Conexões de dados, fontes de dados e cadeias de conexão no Construtor de Relatórios
  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) na documentação do Reporting Services nos do SQL ServerManuais Online.
  Fornece informações detalhadas sobre suporte à plataforma e à versão para cada extensão de dados.

Voltar ao início

Consulte também

Conceitos

Parâmetros de relatório (Construtor de Relatórios e SSRS)

Filtrar, agrupar e classificar dados (Construtor de Relatórios e SSRS)

Expressões (Construtor de Relatórios e SSRS)