Learn more about SQL Server tools



solving sql server problems for millions of dbas and developers since 2006 join MSSQLTips for free SQL Server tips


























































   Got a SQL tip?
            We want to know!

Using a SharePoint List as a Data Source in SQL Server Reporting Services 2008 R2

MSSQLTips author Ray Barley By:   |   Read Comments (35)   |   Related Tips: > Sharepoint
Problem

We are constantly getting requests to produce reports that include data from SharePoint lists. We have just started using SQL Server Reporting Services (SSRS) 2008 R2 and see that there is a new Microsoft SQL Server Reporting Services SharePoint List Data Extension. Can you provide an example of how this works?

Solution

The Microsoft SQL Server Reporting Services SharePoint List Data Extension that comes with SSRS 2008 R2 allows you to specify a SharePoint site or subsite as a Data Source, then create a Dataset that is based on a SharePoint list in that site or subsite. This new data extension allows you to access list data in SharePoint Foundation 2010, SharePoint Server 2010, Windows SharePoint Services 3.0, and Office SharePoint Server 2007 sites.

In this tip I will review the following steps required to develop a report that retrieves data from a SharePoint list:

  • Create a Data Source
  • Create a Dataset
  • Layout the report

To begin create a new Report Server project using SQL Server Business Intelligence Development Studio (BIDS) that comes with SQL Server 2008 R2. Note that the SharePoint List Data Extension is a new feature with SQL Server 2008 R2; it is not available in prior versions of SQL Server. Add a report to the project. You should see the Report Data tree view with a Data Sources and Datasets node (in addition to the other nodes) as shown below:

The Microsoft SQL Server Reporting Services SharePoint List Data Extension that comes with SSRS 2008 R2

Create a Data Source

When building a report that uses data in a SharePoint list, the Data Source Connection String property must be set to the URL of the SharePoint site or subsite that contains the list you want to use in your report. Right click on the Data Sources node in Report Data and select Add Data Source from the popup menu. Fill in the Data Source Properties General tab as shown below (specify the URL in the Connection string for your SharePoint site or subsite):

the Data Source Connection String property must be set to the URL of the SharePoint site or the subsite

Click on Credentials and fill in the dialog as shown below:

Click on Credentials and fill in the dialog

Create a Dataset

Once you have a Data Source that points to the URL of a SharePoint site or subsite, the next step is to create a Dataset based on the Data Source. Right click on Datasets in Report Data and select Add Dataset from the popup menu. Fill in the dialog as shown below (select the Data Source created above):

create a Dataset based on the Data Source

Click on the Query Designer button to display the SharePoint lists in the SharePoint site specified in the Data Source. Select a list and some fields from the list as shown below (I chose an Announcements list):

Click on the Query Designer button to display the SharePoint lists in the SharePoint site specified in the Data Source

Note that you can only select fields from one list. Click OK and you will be returned to the Dataset Properties dialog which is now complete:

you will be returned to the Dataset Properties dialog

The Query is displayed as XML and it shows the name of the list and the fields selected.

Layout the Report

The last step is to add a Table to the report designer from the Toolbox and drag/drop fields from the dataset to the table. The report layout is shown below with the fields selected from the Announcements list:

add a Table to the report designer from the Toolbox

Click Preview to show the report in the designer:

Click Preview to show the report in the designer
Next Steps
  • You can also use Shared Data Sources and Shared Datasets, which allow multiple reports to use these items.
  • Take a look at the MSDN topic Getting Data from a SharePoint List Data Source Type for additional details; one of the limitations noted is that a dataset can only retrieve data from a single list.


Last Update: 7/22/2010


About the author
MSSQLTips author Ray Barley
Ray Barley is a Principal Architect at RDA Corporation and a MSSQLTips.com BI Expert.

View all my tips
Related Resources


print tip Print  
Become a paid author





join MSSQLTips for free SQL Server tips     



Comments and Feedback:
Friday, September 17, 2010 - 4:54:23 PM - Pobblebonk Read The Tip
Hi,

Is there any way of loading the SharePoint data source into non R2 SQL Server environments?

Txs
Mat


Saturday, September 18, 2010 - 8:35:00 AM - Ray Barley Read The Tip
You can write .NET code and use the SharePoint Lists web service which will allow you to do just about anything with a list.  There is a GetListItems method that returns items from the list based on your query parameters.  You then would implement your own Data Processing Extension in Reporting Services.  I've never done a Data Processing Extension so I don't know what kind of level of effort is involved.

I think this approach is essentially what is provided in Reporting Services 2008 R2.

 


Saturday, September 18, 2010 - 11:19:49 AM - Pobblebonk Read The Tip
Hi,

Appreciate the response I understand there is the ability to write your own DPE however I am not a full on developer and don't have the time to spend developing something which you would think someone would have put into CodePlex by now.

Txs

Mat


Wednesday, March 28, 2012 - 2:41:50 AM - wingsbox Read The Tip

how can i get a carlander data of SharePoint 2010 in reporting service?

The data that I get from a list data of SharePoint 2010 is empty


Wednesday, March 28, 2012 - 9:52:40 AM - Ray Barley Read The Tip

When you create the data source you specify the URL of the web site that has the calendar you want.  When you specify the dataset you will find the calendar in the in the list on the left hand side of the query designer.  Look at the screenshot above and you'll see an entry for BI Team Calendar.


Tuesday, April 17, 2012 - 1:09:42 PM - geeam Read The Tip

Can I SharePoint list combine with a reporting table to combine fields from the two sources?

 


Tuesday, April 17, 2012 - 5:06:03 PM - Raymond Barley Read The Tip

Try the LOOKUP functions that were added in SQL Server Reporting Service 2008 R2.  Take a look at this tip that I did on how to use them: http://www.mssqltips.com/sqlservertip/2141/sql-server-2008-r2-reporting-services-lookup-functions/


Friday, August 03, 2012 - 2:55:11 PM - Franckb Read The Tip

Is it possible to use SharePoint site with SSIS instead ?  I want to use the content as a lookup source in ETL and not sure of how to create the Datasource.

I've tried with a davwwwroot link but I've got trouble with authentification.  Any idea ?

 

 


Friday, August 03, 2012 - 3:37:06 PM - Ray Barley Read The Tip

Take a look at this tip: http://www.mssqltips.com/sqlservertip/1733/accessing-sharepoint-lists-with-sql-server-integration-services-ssis-2005/

It walks through an example of using a SharePoint List Source that Microsoft put out on codeplex. 


Thursday, November 29, 2012 - 2:18:13 AM - Rohit Read The Tip

this is not accessing data inside the folders.


Thursday, November 29, 2012 - 9:27:01 AM - Ray Barley Read The Tip

You can configure some custom properties of the SharePoint List source in the Advanced Editor; try setting IncludeFolders to True and possibly also IsRecursive to True.

Download the documentation here: go to http://msdn.microsoft.com/en-us/library/hh368261.aspx and click the link to download the Word document Extracting and Loading SharePoint Data in SQL Server Integration Services.


Sunday, December 02, 2012 - 5:05:37 PM - Raghu Ariga Read The Tip

I have tried accessing Calendar list from SharePoint as data source into SSRS report. I was unable to get previous years items, like if start date is 2011 i was not getting the item in the datasource on the SSRS report. Is there any way we could include items with start date as previous year. Thanks Ray.


Monday, December 03, 2012 - 6:48:41 AM - Raymond Barley Read The Tip

I can think of two possibilities.  First maybe you can create a view on the SharePoint list; the view would only include the date range that you want.  Second when you set the properties for the SharePoint List Source component you can specify a CAML query.

Here's a decent link on CAML: http://sharepointmagazine.net/articles/writing-caml-queries-for-retrieving-list-items-from-a-sharepoint-list


Wednesday, December 05, 2012 - 12:13:06 PM - AJ Read The Tip

I can view my report just fine in Preview but when I select "Run", I get an error stating: "An error occurred when accessing the specified Sharepoint list.

I'm using Windows Authentication (integrated mode).  I get this error both on my local development machine and on the production server.

Any ideas on how to fix this problem?


Wednesday, December 05, 2012 - 2:00:04 PM - Ray Barley Read The Tip

Check the guidance in the Credentials section of this link: http://msdn.microsoft.com/en-us/library/ee633650.aspx


Thursday, February 28, 2013 - 12:42:46 PM - Matt Smith Read The Tip

Hi Ray,

I'm wondering if you can offer some suggestions on the best (better) tools to use to generate a Calendar View (Weeks and Days) simliar to Outlook from data in SQL Server.  Reporting Services?  SilverLight?  Any other suggestions?

Thanks.

 


Thursday, February 28, 2013 - 5:46:34 PM - Raymond Barley Read The Tip

If you want to render the calendar view in SharePoint then you can create an external content type that points to your SQL Server data then use the external content type in a calendar list.

You can create an external content type by using SharePoint designer as well as by writing .NET code.

I don't think this has been covered on mssqltips so you can search (e.g. google) for sharepoint 2010 external content type calendar view and you will get some places to start.


Wednesday, April 10, 2013 - 3:54:08 PM - george hardy Read The Tip

so what if i wanted the report to his a view other than the default view set for the list?


Wednesday, April 10, 2013 - 4:17:34 PM - Raymond Barley Read The Tip

I don't see any way to do that; I added a view to a calendar list and I don't see the view I added when I setup the dataset query.


Wednesday, April 10, 2013 - 4:48:54 PM - george hardy Read The Tip

thanks for the reply.

well, that may not be it after all.  i build the query, pulling the document name, version, modified date, etc.....in the query editor, it pulls the info from the library fine when i click "run Query", but going info run report, the fields are all blank.   man, i wish MS would have just bought crystal reports :S


Thursday, April 11, 2013 - 5:58:07 AM - Ray Barley Read The Tip

If you're saying you get no data when you run the report after you've deployed it, that may be a security issue; i.e. the deployed report isn't using the credentials of the caller, or you need kerberos, or something else.  A simple way to test is to use stored credentials in the connection and see if that solves the problem.

Take a look here in the credentials section: http://msdn.microsoft.com/en-us/library/ee633650.aspx

 


Friday, June 28, 2013 - 8:22:07 AM - Bob Armstrong Read The Tip

I can access a SharePoint 2010 list in SSRS.  Is there a way to access a view from one of those lists?


Friday, June 28, 2013 - 8:20:01 PM - Ray Barley Read The Tip

I don't see any way to do that; I added a view to a calendar list and I don't see the view I added when I setup the dataset query.


Monday, July 01, 2013 - 6:29:49 AM - Bob Armstrong Read The Tip

Ray, As far as I can see.  We can only access the List and not the view of a List.

Trying to come up with a solution.

I'll let you know if I can figure out a work a round to this madness.


Monday, July 01, 2013 - 8:25:20 AM - Raymond Barley Read The Tip

I did a tip a while back showing how to call a SharePoint web service by using a SQL Server CLR function.  With CLR you can write .NET code then create SQL Server functions, stored proc, triggers, etc. that execute your .NET code.  The example doesn't do what you want, it's based on SharePoint 2007, but the concept will work.  You have to figure out how to get what you want using the SharePoint web service (I think the Lists web service is what you want - see http://msdn.microsoft.com/en-us/library/lists(v=office.12).aspx)

 


Monday, July 01, 2013 - 4:51:11 PM - Rnauman Read The Tip

In your full example above, is there anyway to Filter the Query on Created Date, let say [Today] - 30 (this is the Sharepoint way to do this)


Tuesday, July 02, 2013 - 4:35:57 AM - Nael Read The Tip

Please how to create report from 2 sharepoint 2010 lists


Tuesday, July 02, 2013 - 7:03:43 AM - Bob Armstrong Read The Tip

Nael,

I'm still trying to figure it out using this link:

http://rtmgroupq8.com/en/creating-ssrs-reports-from-two-sharepoint-lists-or-more/

 


Tuesday, July 02, 2013 - 8:24:23 AM - Bob Armstrong Read The Tip

All,

This works.

                         DataSet1                                  DataSet2                          DataSet2            
=Lookup(Fields!Employee_Name.Value, Fields!Employee_Name,Fields!Department_Individual.Value, "DataSet2")

 


Wednesday, November 27, 2013 - 3:03:52 AM - Avahita Read The Tip

How to retrieve all items from all folder  in a list? because my report return all data in root folder only. that is very strange !!! my report in designer in vs2008 retrive all items without folder but when i upload in my report library in sharepoint site retrive items in folders.


Wednesday, November 27, 2013 - 2:36:39 PM - Raymond Barley Read The Tip

You can configure some custom properties of the SharePoint List source in the Advanced Editor; try setting IncludeFolders to True and possibly also IsRecursive to True.

Download the documentation here: go to http://msdn.microsoft.com/en-us/library/hh368261.aspx and click the link to download the Word document Extracting and Loading SharePoint Data in SQL Server Integration Services.


Thursday, November 28, 2013 - 1:43:50 AM - Avahita Read The Tip

I'm confused about difference netween "integration service project" and  "report server project". your comment about "integration service project " (Advanced Editor; try setting IncludeFolders to True and possibly also IsRecursive to True.)

but I follow this steps
1.create "report server project"
2.create rdl report with datasource of sharepoint site
3.create dataset of sharepoint list in that site with this query:

<RSSharePointList xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <ListName>[mylistname]</ListName>
 
  <ViewFields>

    <FieldRef Name="_x0646__x0648__x0639__x0020__x06" />
    <FieldRef Name="Title" />
    <FieldRef Name="_x0627__x0648__x0644__x0648__x060" />
    <FieldRef Name="_x0632__x0645__x0627__x0646__x00" />
    <FieldRef Name="_x0648__x0627__x06af__x0630__x06" />
    <FieldRef Name="_x0644__x064a__x0646__x06a9__x00" />
    <FieldRef Name="_x062a__x0648__x0636__x064a__x06" />
    <FieldRef Name="_x067e__x0627__x0633__x062e__x00" />
    <FieldRef Name="_x0648__x0636__x0639__x064a__x06" />
    <FieldRef Name="_x062a__x0627__x0631__x06cc__x06" />
    <FieldRef Name="_x0645__x062f__x062a__x0020__x06" />
    <FieldRef Name="_x062a__x0648__x0642__x0641__x00" />
    <FieldRef Name="_x0634__x0631__x062d__x0020__x06" />
    <FieldRef Name="LinkTitleNoMenu" />
    <FieldRef Name="Author" />
    <FieldRef Name="Editor" />
    <FieldRef Name="Modified" />
    <FieldRef Name="Created" />
    <FieldRef Name="_x0646__x0648__x0639__x0020__x060" />
    <FieldRef Name="_x062a__x0627__x0631__x06cc__x060" />
    <FieldRef Name="ID" />
    <FieldRef Name="ContentType" />
    <FieldRef Name="Attachments" />
    <FieldRef Name="FolderChildCount" />
    <FieldRef Name="LinkTitle" />

  </ViewFields>

  <Query>
  
  <ViewAttributes Scope='RecursiveAll' />
<View Scope='Recursive'></View>
  </Query>

</RSSharePointList>

◦this query results all items in folders of list in preview tab but when my report upload to sharepoint report library in sharepoint site result only folders and items in root folder of list
4.upload the report to report library in sharepoint site.


Sunday, December 01, 2013 - 9:08:04 AM - Ray Barley Read The Tip

Integration Services project is not a report; it's something you use to retrieve data from various data sources, transform the data, and store the data in a different place.  This is typically called ETL - extract, transform and load.  It is used in data warehousing applications.


Sunday, December 01, 2013 - 11:56:09 PM - Avahita Read The Tip

Thanks for your explanation, but my problem was the type of  report server project.I followed the steps that I described in my previous post  but about the list with folder does not return the correct result!!!!!!


Friday, May 23, 2014 - 3:18:13 PM - Dawn Read The Tip

Thank you SO MUCH for posting this! It's been a great help to me!

 

And I have to say you are awesome for answering everyone's questions in the comments section. As long as I've been searching through technical posts, I've never seen an author do that.



Post a Comment or Question

Keep it clean and stay on the subject or we may delete your comment.
Your email address is not published. Required fields are marked with an asterisk (*)

*Name   *Email Notify for updates



Comments
Get free SQL tips:

*Enter Code refresh code


 
Sponsor Information







Copyright (c) 2006-2014 Edgewood Solutions, LLC All rights reserved
privacy | disclaimer | copyright | advertise | about
authors | contribute | feedback | giveaways | free t-shirt | user groups | community | events | first timer?
Some names and products listed are the registered trademarks of their respective owners.