SPDataStore.GetDataSource method

Retrieves a data source from a SharePoint document library.

Namespace:  Microsoft.PerformancePoint.Scorecards.Store
Assembly:  Microsoft.PerformancePoint.Scorecards.Store (in Microsoft.PerformancePoint.Scorecards.Store.dll)

public DataSource GetDataSource(
	RepositoryLocation location
)

Parameters

location
Type: Microsoft.PerformancePoint.Scorecards.RepositoryLocation

The location of the data source in the SharePoint document library. Only the ItemUrl property must be defined.

Return value

Type: Microsoft.PerformancePoint.Scorecards.DataSource
The requested data source, or a null reference (Nothing in Visual Basic) if it does not exist.

Implements

IBIMonitoringStore.GetDataSource(RepositoryLocation)

Security noteSecurity Note

To apply appropriate user permissions before returning a retrieved data source or exposing its results to an external caller, call the ApplyUserPermissionsToDatasource(DataSource) method.

The following code example shows how to retrieve a data source from the repository.

Before you can compile this code example, you must do the following:

  • Configure your development environment and create a C# class library project in Visual Studio. For information about configuring a development environment, see Set up a general development environment for SharePoint 2013.

  • Add the Microsoft.PerformancePoint.Scorecards.Client and Microsoft.PerformancePoint.Scorecards.ServerCommon DLLs as references to your project. For more information about PerformancePoint Services DLLs, see PerformancePoint Services DLLs Used in Development Scenarios.

  • Add the following using directive to your class: using Microsoft.PerformancePoint.Scorecards;.

  • Create a method that defines a string variable named "relativePath" to store the server-relative path to the object. The following example path sets the object identifier to "5": /BI Center/Data Connections for PerformancePoint/5_.000.

  • Paste the following code example into the new method.

// Create a RepositoryLocation object to represent the location of the data source. 
// The constructor takes the server-relative path to the data source.
RepositoryLocation dataSourceLocation = new RepositoryLocation(relativePath);

// This example assumes the code is running in a Web Part on a front-end Web server.
// If this code is running within a service application, then you can call the
// SPDataStore.GlobalStore.GetDataSource method directly.
DataSource requestedDataSource = 
    BIMonitoringServiceApplicationProxy.Default.GetDataSource(dataSourceLocation);
Show: