SPDataStore.UpdateKpi-Methode

Artikel
05/06/2015

Einen Key Performance Indicator (KPI) in einer SharePoint-Liste aktualisiert.

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

Syntax

'Declaration
Public Function UpdateKpi ( _
    kpi As Kpi _
) As Kpi
'Usage
Dim instance As SPDataStore
Dim kpi As Kpi
Dim returnValue As Kpi

returnValue = instance.UpdateKpi(kpi)

public Kpi UpdateKpi(
    Kpi kpi
)

Parameter

kpi
Typ: Microsoft.PerformancePoint.Scorecards.Kpi

Das KPI-Objekt, das die aktualisierte Informationen enthält. Die Location -Eigenschaft muss die URL des Objekts aktualisieren angegeben.

Rückgabewert

Typ: Microsoft.PerformancePoint.Scorecards.Kpi
Das aktualisierte Objekt, das aktualisierte Informationen wie z. B. die neue Versionsnummer enthält.

Implementiert

IBIMonitoringStore.UpdateKpi(Kpi)

Hinweise

Für kpiempfehlen wir, dass Sie ein KPI-Objekt verwenden, die zuvor mithilfe der GetKpi(RepositoryLocation) -Methode abgerufen wurde.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie einen KPI abrufen, abgerufenen KPI aktualisieren und speichern dann das aktualisierte Objekt im Repository.

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.PerformancePoint.Scorecards.Store 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 folgenden using Direktiven zu Ihrer Klasse.

using Microsoft.PerformancePoint.Scorecards;
using Microsoft.PerformancePoint.Scorecards.Store;
using System.Globalization;

Erstellen Sie eine Methode, die die folgenden:
- Definiert eine String-Variable mit dem Namen "RelativePath" in der Server-relativer Pfad für das Objekt zu speichern. In diesem Beispielpfad wird auf "5" die Objekt-ID: /BI Center/Lists/PerformancePoint Content/5_.000.
- Erstellt eine Instanz eines Kpi -Objekts mit dem Namen "UpdatedKpi". Ein Beispiel zum Erstellen des Objekts finden Sie in der CreateKpi -Methode.
Fügen Sie das folgende Codebeispiel in der neuen Methode.

// As a best practice, retrieve the object and then update it.
// The RepositoryLocation constructor takes the server-relative path to the object.
Kpi requestedKpi = SPDataStore.GlobalDataStore.GetKpi(new RepositoryLocation(relativePath));

if (requestedKpi != null)
{
    // Update the description to show the time of the last update operation.
    requestedKpi.Description.Text = String.Format(
        CultureInfo.CurrentCulture,
        "Last updated at {0}",
        DateTime.Now.ToLocalTime());

    // Update the KPI in the repository.
    updatedKpi = SPDataStore.GlobalDataStore.UpdateKpi(requestedKpi);
}

Siehe auch

Referenz

SPDataStore Klasse

SPDataStore-Member

Microsoft.PerformancePoint.Scorecards.Store-Namespace

Freigeben über