• Artigo

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 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 a e recuperar dados de lista dos sites do 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 Como adicionar e verificar uma conexão de dados ou uma fonte de dados (Construtor de Relatórios 3.0 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 3.0.

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.

Os tipos de credenciais incluem o seguinte:

  • Usuário atual do Windows (também conhecido como segurança integrada).

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

    • 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, não há suporte a essa opção.

  • Usar um nome de usuário e senha armazenados. Esta opção somente dá suporte à segurança integrada do Windows.

  • Solicitar credenciais ao usuário. Esta opção somente dá suporte à segurança integrada do Windows.

  • Nenhuma credencial é necessária. 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 Configurando a conta de execução autônoma na documentação do Reporting Services no msdn.microsoft.com.

Para obter mais informações, consulte Conexões de dados, fontes de dados e cadeias de conexão (SSRS), Especificando credenciais no Construtor de Relatórios 3.0 e Fontes de dados com suporte no Reporting Services (SSRS).

Consultas

Para criar uma consulta, crie um novo conjunto de dados baseado na fonte de dados e, em seguida, abra o designer de consulta associado. Para obter mais informações, consulte Como criar um conjunto de dados compartilhado ou um conjunto de dados inserido (Report Builder 3.0 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 à seleção de campos de várias listas.

  • **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 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 3.0).

  • **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 Filtrando, agrupando e classificando dados (Construtor de Relatórios 3.0 e SSRS) e Parâmetros (Report Builder 3.0 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 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 3.0).

  • **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 Filtrando, agrupando e classificando dados (Construtor de Relatórios 3.0 e SSRS) e Parâmetros (Report Builder 3.0 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 Criador de consultas de lista do SharePoint (Construtor de Relatórios 3.0).

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.

Ícone de seta usado com o link Voltar ao InícioVoltar ao Início

Seções relacionadas

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.

Ícone de seta usado com o link Voltar ao InícioVoltar ao Início