SPDataStore.CreateDataSource-Methode

Artikel
05/06/2015

Speichert ein Objekt als Inhaltstyp in einer SharePoint-Dokumentbibliothek.

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

Syntax

'Declaration
Public Function CreateDataSource ( _
    listUrl As String, _
    dataSource As DataSource _
) As DataSource
'Usage
Dim instance As SPDataStore
Dim listUrl As String
Dim dataSource As DataSource
Dim returnValue As DataSource

returnValue = instance.CreateDataSource(listUrl, _
    dataSource)

public DataSource CreateDataSource(
    string listUrl,
    DataSource dataSource
)

Parameter

listUrl
Typ: System.String

Die serverrelative URL der SharePoint-Dokumentbibliothek, die Datenquelle zu speichern. Beispiel: /BI Center/Data Connections for PerformancePoint.

dataSource
Typ: Microsoft.PerformancePoint.Scorecards.DataSource

Das Datenquellenobjekt zu speichern, das Werte für die erforderlichen Name Eigenschaft angibt. Für Datenquellen dataSource müssen auch die SubTypeId -Eigenschaft angeben, und der Wert muss das subType -Attribut für die benutzerdefinierte Datenquelle in der web.file für die PerformancePoint-Dienste in SharePoint Server 2013angegebenen übereinstimmen.

Rückgabewert

Typ: Microsoft.PerformancePoint.Scorecards.DataSource
Das neue Objekt, das enthält aktualisierte Informationen so ihre Nummer und Version.

Implementiert

IBIMonitoringStore.CreateDataSource(String, DataSource)

Hinweise

Verwenden Sie für die Entwicklung von PerformancePoint-Dienste die BIMonitoringServiceApplicationProxy.CreateDataSource(String, DataSource) -Methode anstelle dieser Implementierung. Weitere Informationen finden Sie im Abschnitt "Interaktion mit Repository-Objekte" in Editors for Custom Objects.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie eine private Methode zum Erstellen einer Datenquelle aus, und rufen Sie BIMonitoringServiceApplicationProxy.CreateDataSource(String, DataSource) , um sie im Repository zu speichern.

Bevor Sie dieses Codebeispiel kompilieren können, müssen Sie Folgendes tun:

Konfigurieren Sie die Entwicklungsumgebung, und erstellen Sie ein C#-Klassenbibliotheksprojekt in Visual Studio. Informationen zum Konfigurieren einer Entwicklungsumgebung finden Sie unter Einrichten einer allgemeinen Entwicklungsumgebung für SharePoint 2013.
Die Microsoft.PerformancePoint.Scorecards.Client, Microsoft.PerformancePoint.Scorecards.ServerCommon und Microsoft.SharePoint-DLLs als Verweise auf Ihr Projekt hinzufügen. Weitere Informationen zu PerformancePoint-Dienste DLLs finden Sie unter PerformancePoint Services DLLs Used in Development Scenarios.
Fügen Sie die folgende Direktive using Klasse hinzu: using Microsoft.PerformancePoint.Scorecards;.

// Create a data source that uses the Adventure Works sample cube, based on the following parameters:
//   - dataSourceName is the name for the data source.
//   - docLibUrl is the server-relative URL of the document library to save the data  
//         source to. Example: "/BI Center/Data Connections for PerformancePoint"
// This method returns the new data source. 
private DataSource CreateDataSource(string dataSourceName, string docLibUrl)
{
    if (String.IsNullOrEmpty(dataSourceName))
        throw new ArgumentException("The name must not be null or empty.");
    if (String.IsNullOrEmpty(docLibUrl))
        throw new ArgumentException("The document library URL must not be null or empty.");

    // Create an ADOMD.NET data source that represents the Adventure Works sample cube.
    DataSource ds = DataSource.CreateNew();
    ds.Name.Text = dataSourceName;
    ds.Description.Text = "Created with the SDK.";
    ds.ServerName = "MyServer";
    ds.DatabaseName = "Adventure Works DW";
    ds.CubeName = "Direct Sales";

    // The SourceName property must match the name of a data source provider registered in
    // the CustomDataSourceProviders section of the PerformancePoint Services web.config file.
    // The default path to the web.config file is 
    // %ProgramFiles%\Microsoft Office Servers\14.0\WebServices\PpsMonitoringServer.

    ds.SourceName = "ADOMD.NET";

    // Call the CreateDataSource method to save the new data source to the specified document library.
    // TODO: Handle exceptions from this call.
    // All interaction with the data source should go through the application server.
    // If this code is running within the application server, call the data store directly, as follows.
    // return SPDataStore.GlobalDataStore.CreateDataSource(docLibUrl, ds);

    // If this code is running on a front-end Web server, call the service application proxy, as follows.
    return BIMonitoringServiceApplicationProxy.Default.CreateDataSource(docLibUrl, ds);
}