BIMonitoringServiceApplicationProxy.GetDataSource Method

Article
07/24/2014

Retrieves a data source from a SharePoint document library.

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

Syntax

'Declaration
Public Function GetDataSource ( _
    location As RepositoryLocation _
) As DataSource
'Usage
Dim instance As BIMonitoringServiceApplicationProxy
Dim location As RepositoryLocation
Dim returnValue As DataSource

returnValue = instance.GetDataSource(location)

public DataSource GetDataSource(
    RepositoryLocation location
)

Parameters

location
Type: Microsoft.PerformancePoint.Scorecards.RepositoryLocation

The location of the data source in the repository.

Return Value

Type: Microsoft.PerformancePoint.Scorecards.DataSource
The data source at the specified location.

Implements

IBIMonitoringServiceApplicationProxy.GetDataSource(RepositoryLocation)

Remarks

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

Examples

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 Setting Up the Development Environment for SharePoint 2010 on Windows Vista, Windows 7, and Windows Server 2008.
Add the Microsoft.PerformancePoint.Scorecards.Client and Microsoft.PerformancePoint.Scorecards.ServerCommon DLLs as references to your project. For more information about PerformancePoint Services in Microsoft SharePoint Server 2010 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);