How to: Create and Manage Shared Data Sources (SharePoint Integrated Mode)
New: 12 December 2006
When you run a report from a SharePoint library, connection information can be defined within the report or in an external file that is linked to the report. If the connection information is embedded within the report, it is called a custom data source. If the connection information is defined in an external file, it is called a shared data source. The external file can be a report server data source (.rsds) file or an Office Data Connection (.odc) file.
An .rsds file is similar to an .rds file, but it has a different schema. To create an .rsds file, you can publish an .rds from Report Designer or Model Designer to a SharePoint library (a new .rsds file is created from the original .rds file). Alternatively, you can create a new file in library on a SharePoint Site.
If you create or publish a shared data source, you can later edit connection properties or delete the file if it is no longer used. Before you delete a shared data source, you should determine whether it is used by reports and report models. You can do this by viewing dependent items that reference the shared data source.
Although the list of dependent items tells you whether the shared data source is referenced, it does not tell you whether the item is actively used. To determine whether the shared data source or model is actively used, you can review the log files on the report server computer. If you do not have access to the log files or if the files do not contain the information you want, consider moving the report to an inaccessible folder while you determine its actual status.
To create a shared data source (.rsds) file
If the library is not already open, click its name on the Quick Launch. If the name of your library does not appear, click View All Site Content, and then click the name of your library.
On the New menu, click Report Data Source. If you do not see that item on the menu, the report data source content type has not been registered. For instructions about how to add it, see How to: Add Report Server Content Types to a Library (SharePoint Integrated Mode).
In Name, enter a descriptive name for the .rsds file.
In Data Source Type, choose the type of data source from the list. For more information, see Data Sources Supported by Reporting Services.
In Connection String, specify a pointer to the data source and any other settings that are necessary for establishing a connection to the external data source. The type of data source you are using determines the syntax of the connection string. For more information and examples, see Connecting to a Data Source.
In Credentials, specify how the report server obtains credentials to access the external data source. Credentials can be stored, prompted, integrated, or configured for unattended report processing.
- Choose Windows authentication (integrated) if you want to access the data using the credentials of the user who opened the report. Do not choose this option if the SharePoint site or farm uses Forms authentication or connects to the report server through a trusted account. Do not choose this option if you want to schedule subscription or data processing for this report. This option works best when Kerberos authentication is enabled for your domain, or when the data source is on the same computer as the report server. If Kerberos authentication is not enabled, Windows credentials can only be passed to one other computer. This means that if the external data source is on another computer, requiring an additional connection, you will get an error instead of the data you expect.
- Choose Prompt for credentials if you want the user to enter his or her credentials each time he or she runs the report. Do not choose this option if you want to schedule subscription or data processing for this report.
- Choose Stored credentials if you want to access the data using a predefined set of credentials. The credentials are encrypted before they are stored. You can select options that determine how the stored credentials are authenticated. Select Use as Windows credentials if the stored credentials belong to a Windows user account. Select Set execution context to this account if you want to set the execution context on the database server. For SQL Server databases, this option sets the SETUSER function. For more information, see Understanding Execution Context.
- Choose Unattended report processing account if you want to specify credentials in the connection string, or if you want to run the report using a least-privilege account that is configured on the report server. If this account is not configured on the report server, users will be prompted for credentials and any scheduled operations that you define for the report will not run.
Save the page to create the shared data source.
To view dependent items
Open the library that contains the .rsds file.
Point to the shared data source.
Click to display a down arrow, and select View Dependent Items.
For report models, the list of dependent items shows the reports that were created in Report Builder. For shared data sources, the dependent items list can include both reports and report models.
To delete a shared data source (.rsds) file
Open the library that contains the .rsds file.
Point to the shared data source.
Click to display a down arrow, and click Delete.
If you mistakenly delete a shared data source that you meant to keep, you can create a new one that contains the same connection information. After you re-create the shared data source, you must open each report and model that used that data source and select the shared data source. The new shared data source item can have a different name, credentials, or connection string syntax from the one you delete. As long as the connection resolves to the same data source, data source properties can vary from the original values.
Use caution when deleting a report model. If you delete a model, you can no longer open and modify any reports that are based on that model in Report Builder. If you inadvertently delete a model that is used by existing reports, you must regenerate the model, re-create and save any reports that use the model, and re-specify any model item security that you want to use. You cannot simply regenerate the model and then attach it to an existing report.
See Also
Concepts
Report Server How-to Topics (SharePoint Integrated Mode)
Viewing and Managing Report Server Items from a SharePoint Site
Specifying Credential and Connection Information