Exemple de code : transformations de tableau de bord personnalisées
Dernière modification : mardi 31 mai 2011
S’applique à : SharePoint Server 2010
Il est recommandé d’utiliser l’exemple en tant que modèle pour vos extensions personnalisées, car il illustre les meilleures pratiques en matière de programmation avec PerformancePoint Services. Pour plus d’informations sur les types d’extensions pris en charge, voir Scénarios de développement avec PerformancePoint Services.
Exemple des transformations de tableau de bord
L’exemple contient les transformations de tableau de bord suivantes :
AddColumnTransform.cs Définit une transformation de tableau de bord PreQuery qui ajoute dynamiquement une colonne à un tableau de bord contenant des indicateurs de performance clés au niveau feuille de la colonne.
FormattingTransform.cs Définit une transformation de tableau de bord PreRender qui modifie le jeu de polices et de couleurs par défaut d’un tableau de bord.
NumberScalingTransform.cs Définit une transformation de tableau de bord PostQuery qui applique une mise à l’échelle B, M et K à de grands nombres.
ShowAnnotationDate.cs Définit une transformation de tableau de bord PreRender qui affiche la durée écoulée en jours depuis la dernière modification d’une annotation.
Installation de l’exemple des transformations de tableau de bord
Pour installer l’exemple des transformations de tableau de bord, vous devez générer l’assembly exemple, inscrire l’assembly auprès du Global Assembly Cache, et inscrire les extensions dans le fichier web.config PerformancePoint Services. Ces tâches nécessitent des autorisations d’administration suffisantes sur le serveur d’applications, qui correspond à l’ordinateur exécutant PerformancePoint Services.
Notes
Les instructions relatives à l’installation de l’exemple entier sont incluses dans les fichiers exemples.
Pour installer l’exemple des transformations de tableau de bord
Téléchargez le fichier compressé (.zip) de l’exemple de référence du Kit de développement logiciel (SDK) de PerformancePoint Services (éventuellement en anglais), qui comprend les composants des transformations de tableau de bord.
Effectuez l’extraction du contenu dans un dossier sur votre ordinateur.
Ouvrez l’exemple dans Visual Studio.
Dans l’Explorateur de solutions, développez le dossier Références et restaurez les références de projet manquantes. Les assemblys PerformancePoint Services sont installés dans le Global Assembly Cache uniquement. En fonction de votre environnement de développement, vous devrez peut-être les copier dans un autre répertoire. Pour obtenir des instructions sur la copie des assemblys PerformancePoint Services à partir du Global Assembly Cache, voir DLL PerformancePoint Services utilisées dans les scénarios de développement.
L’exemple inclut des références aux assemblys PerformancePoint Services et SharePoint Server 2010 suivants :
Microsoft.PerformancePoint.Scorecards.Client
Microsoft.PerformancePoint.Scorecards.DataSourceProviders.Standard
Microsoft.PerformancePoint.Scorecards.Server
Microsoft.PerformancePoint.Scorecards.ServerCommon
Microsoft.PerformancePoint.Scorecards.ServerRendering
Microsoft.PerformancePoint.Scorecards.Store
Microsoft.SharePoint
Générez l’assembly exemple.
Notes
Ces instructions partent du principe que vous signez l’assembly avec le fichier SDKSamples.snk inclus dans l’exemple. Si vous utilisez un autre fichier de clé de nom fort pour générer un jeton de clé publique pour l’assembly, remplacez le jeton de clé publique de l’exemple dans ces instructions (fa525c8383a44a52) par la clé réelle.
Sur le serveur d’applications, ajoutez l’assembly exemple (Microsoft.PerformancePoint.SDK.Samples.dll) au Global Assembly Cache. Pour obtenir des instructions, voir How to: Install an Assembly into the Global Assembly Cache.
Accédez au fichier web.config de PerformancePoint Services dans le chemin d’accès par défaut C:\Program Files\Microsoft Office Servers\14.0\WebServices\PpsMonitoringServer sur le serveur d’applications.
Important
Il est recommandé de copier le fichier web.config avant de le modifier.
Ouvrez le fichier web.config de PerformancePoint Services dans un éditeur de texte, tel que le Bloc-notes.
Pour inscrire l’exemple des transformations de tableau de bord, collez le code suivant dans l’élément CustomViewTransforms.
<add key="AddColumn" value="Microsoft.PerformancePoint.SDK.Samples.ScorecardTransforms.PreQuery.AddColumnTransform, Microsoft.PerformancePoint.SDK.Samples, Version=14.0.0.0, Culture=neutral, PublicKeyToken=fa525c8383a44a52"/> <add key="NumberScaling" value="Microsoft.PerformancePoint.SDK.Samples.ScorecardTransforms.PostQuery.NumberScalingTransform, Microsoft.PerformancePoint.SDK.Samples, Version=14.0.0.0, Culture=neutral, PublicKeyToken=fa525c8383a44a52"/> <add key="ShowAnnotationDate" value="Microsoft.PerformancePoint.SDK.Samples.ScorecardTransforms.PreRender.ShowAnnotationDate, Microsoft.PerformancePoint.SDK.Samples, Version=14.0.0.0, Culture=neutral, PublicKeyToken=fa525c8383a44a52"/> <add key="FormattingTransform" value="Microsoft.PerformancePoint.SDK.Samples.ScorecardTransforms.PreRender.FormattingTransform, Microsoft.PerformancePoint.SDK.Samples, Version=14.0.0.0, Culture=neutral, PublicKeyToken=fa525c8383a44a52"/>Enregistrez, puis fermez le fichier web.config.
En fonction de votre environnement, vous devrez peut-être redémarrer les services Internet (IIS).
Une fois l’exemple des transformations de tableau de bord installé, ces dernières sont appliquées aux affichages Tableau de bord et aux rapports de carte de stratégie dans les tableaux de bord créés et déployés à partir de PerformancePoint Dashboard Designer. Pour plus d’informations sur l’utilisation de Dashboard Designer, voir le site Web Office.
Voir aussi
Concepts
Exemple de code : objets personnalisés de rapport, de filtre et de source de données tabulaires