SPDataStore.UpdateKpi - Méthode
Met à jour un indicateur de performance clé (KPI) dans une liste SharePoint.
Espace de noms : Microsoft.PerformancePoint.Scorecards.Store
Assembly : Microsoft.PerformancePoint.Scorecards.Store (dans Microsoft.PerformancePoint.Scorecards.Store.dll)
Syntaxe
'Déclaration
Public Function UpdateKpi ( _
kpi As Kpi _
) As Kpi
'Utilisation
Dim instance As SPDataStore
Dim kpi As Kpi
Dim returnValue As Kpi
returnValue = instance.UpdateKpi(kpi)
public Kpi UpdateKpi(
Kpi kpi
)
Paramètres
kpi
Type : Microsoft.PerformancePoint.Scorecards.KpiL'objet de l'indicateur de performance clé qui contient les informations de mise à jour. La propriété Location doit spécifier l'URL de l'objet à mettre à jour.
Valeur renvoyée
Type : Microsoft.PerformancePoint.Scorecards.Kpi
L'objet mis à jour, qui contient des informations mises à jour, telles que le nouveau numéro de version.
Implémentations
IBIMonitoringStore.UpdateKpi(Kpi)
Remarques
Pour kpi, nous vous recommandons d'utiliser un objet de l'indicateur de performance clé qui a été précédemment extraite à l'aide de la méthode GetKpi(RepositoryLocation) .
Exemples
L'exemple de code suivant montre comment récupérer un indicateur de performance clé, mettre à jour de l'indicateur de performance clé récupérée et puis enregistrez l'objet mis à jour dans le référentiel.
Pour pouvoir compiler cet exemple de code, vous procédez comme suit :
Configurer votre environnement de développement et créer un projet de bibliothèque de classes c# dans Visual Studio. Pour plus d'informations sur la configuration d'un environnement de développement, voir Configurer un environnement de développement général pour SharePoint 2013.
Ajoutez les DLL de Microsoft.PerformancePoint.Scorecards.Store, Microsoft.PerformancePoint.Scorecards.ServerCommon et Microsoft.PerformancePoint.Scorecards.Client en tant que références à votre projet. Pour plus d'informations sur PerformancePoint Services DLL, voir PerformancePoint Services DLLs Used in Development Scenarios.
Ajoutez les directives using suivantes à votre classe.
using Microsoft.PerformancePoint.Scorecards; using Microsoft.PerformancePoint.Scorecards.Store; using System.Globalization;
Créez une méthode qui effectue les opérations suivantes :
Définit une variable chaîne nommée « relativePath » pour stocker le chemin d'accès relatif de serveur à l'objet. Le chemin d'accès exemple suivant définit l'identificateur d'objet à « 5 »: /BI Center/Lists/PerformancePoint Content/5_.000.
Crée une instance d'un objet Kpi nommé « updatedKpi ». Pour obtenir un exemple illustrant comment créer l'objet, voir la méthode CreateKpi .
Collez le code suivant dans la nouvelle méthode.
// 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);
}
Voir aussi
Référence
Microsoft.PerformancePoint.Scorecards.Store - Espace de noms