Éditeurs pour les objets personnalisés des services PerformancePoint Services

Dernière modification : mardi 30 août 2011

Dans Services PerformancePoint dans Microsoft SharePoint Server 2010, la fonction principale d’un éditeur personnalisé est de permettre aux utilisateurs de définir des propriétés sur un objet personnalisé. Un objet personnalisé est un objet natif ReportView, un objet Filter ou un objet DataSource ayant des valeurs personnalisées définies pour ses propriétés.

Dans cet article
Fourniture de contrôles d’édition pour des propriétés d’objet
Interaction avec des objets du référentiel
Intégration avec Dashboard Designer

Un éditeur s’exécute dans une instance d’application PerformancePoint Services sur le serveur Web frontal, généralement en tant que page ASPX. Les applications Web qui s’exécutent au sein d’une instance d’application PerformancePoint Services et dans un processus SharePoint se trouvent dans le répertoire virtuel /_layouts et sont installées par défaut dans le dossier LAYOUTS à l’emplacement %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE.

S’applique à : SharePoint Server 2010

Pour permettre aux utilisateurs de définir les propriétés d’objets personnalisés, les éditeurs fournissent des contrôles d’édition et interagissent avec les objets dans le référentiel.

Fourniture de contrôles d’édition pour des propriétés d’objet

Un éditeur définit les propriétés d’un objet personnalisé et expose ces propriétés à l’aide de contrôles d’édition. Votre éditeur doit exposer les propriétés dont vous voulez permettre l’affichage et la modification par les utilisateurs. Pour un exemple de méthode qui rend disponible des contrôles ASP.NET pour un éditeur de rapport, voir la méthode CreateChildControls dans Procédure : Créer des éditeurs pour les rapports des services PerformancePoint Services.

Nous vous recommandons d’utiliser l’exemple d’objets personnalisés comme modèle pour votre éditeur personnalisé. Les exemples d’éditeurs définissent des contrôles ASP.NET dans le balisage HTML d’une page ASPX, en suivant la pratique de développement SharePoint de définition de logique métier dans une classe qui est compilée dans une DLL plutôt que dans la classe code-behind utilisée dans le développement ASP.NET. L’exemple montre également comment appeler des objets dans la DLL Microsoft.PerformancePoint.Scorecards.Client.

Interaction avec des objets du référentiel

Les éditeurs (et d’autres applications Web personnalisées) s’exécutent dans une instance d’application PerformancePoint Services sur le serveur Web frontal et utilisent les objets BIMonitoringServiceApplicationProxy et SPDataStore dans l’API PerformancePoint Services pour effectuer des tâches Créer, Lire, Mettre à jour et Supprimer (CRUD), comme suit :

• Pour les objets de source de données personnalisés, utilisez la classe BIMonitoringServiceApplicationProxy pour effectuer des tâches Créer et Mettre à jour. Ceci permet à ces tâches d’être effectuées dans le contexte de l’application de service PerformancePoint Services. Les tâches Lecture (get) et Supprimer peuvent être effectuées à l’aide de BIMonitoringServiceApplicationProxy ou de SPDataStore. (Les applications personnalisées qui s’exécutent sur le serveur d’applications peuvent appeler SPDataStore directement.)

• Pour les objets de rapport et de filtre personnalisés, utilisez la classe SPDataStore.

Nous vous recommandons d’utiliser les objets d’application d’assistance inclus dans l’exemple d’objets personnalisés pour effectuer des opérations sur le référentiel au lieu d’appeler les objets BIMonitoringServiceApplicationProxy et SPDataStore directement à partir de votre éditeur.

Votre éditeur n’a pas besoin de fournir la logique pour la création d’objets car Dashboard Designer est configuré pour créer des objets personnalisés par défaut. Il est cependant possible de permettre aux utilisateurs de créer des objets sans utiliser Dashboard Designer. Pour plus d’informations, voir Création d’objets en dehors de Dashboard Designer. En outre, les objets personnalisés peuvent être supprimés à partir de Dashboard Designer et du référentiel ; fournir une logique pour supprimer des objets de votre éditeur est donc également facultatif.

Intégration avec Dashboard Designer

Pour s’intégrer dans l’expérience de création de Dashboard Designer, votre éditeur doit pouvoir s’ouvrir à partir d’un URI (Uniform Resource Identifier), et cet URI doit être inscrit pour l’objet personnalisé dans le fichier web.config de PerformancePoint Services.

Pour créer un objet personnalisé, Dashboard Designer récupère les métadonnées de l’objet auprès du fichier web.config de PerformancePoint Services, puis crée l’objet en tant que type de contenu dans le référentiel PerformancePoint Services. Les sources de données sont créées dans une bibliothèque de documents SharePoint et les objets de rapport et de filtre sont créés dans une liste SharePoint. Après avoir créé l’objet personnalisé, Dashboard Designer affiche un lien vers l’éditeur.

PerformancePoint Services utilise le processus suivant pour ouvrir un éditeur personnalisé :

1. Lorsqu’un utilisateur tente de modifier un objet personnalisé à partir de Dashboard Designer (ou un type de contenu dans le référentiel), une chaîne de requête est passée à un contrôle serveur Web. La chaîne de requête fournit l’emplacement de l’objet dans le référentiel.

2. Le contrôle serveur Web interroge l’objet pour identifier son type et son sous-type. Le sous-type de l’objet indique si l’objet est natif ou personnalisé.

3. Si l’objet est personnalisé, le contrôle serveur Web recherche l’URI de l’éditeur de l’objet dans le fichier web.config de PerformancePoint Services.

4. Le contrôle serveur Web ajoute des paramètres de chaîne de requête au chemin d’accès de l’éditeur puis ouvre l’éditeur.

Paramètres de la chaîne de requête

PerformancePoint Services ajoute les paramètres de chaîne de requête à l’URI de l’éditeur lors de l’ouverture d’un éditeur personnalisé. Le tableau suivant décrit les paramètres.

Tableau 1. Paramètres de la chaîne de requête

Vous pouvez spécifier des paramètres statiques personnalisés pour votre éditeur dans le fichier web.config de PerformancePoint Services. Des paramètres statiques passent une valeur prédéfinie à l’éditeur chaque fois qu’il est ouvert. Pour plus d’informations sur l’inscription d’un éditeur, voir Procédure : enregistrer manuellement des extensions PerformancePoint Services.

Vous pouvez également faire référence à ces paramètres par leurs constantes correspondantes dans le modèle objet PerformancePoint Services au lieu d’utiliser la chaîne de requête. Ces constantes sont représentées par les champs LaunchOperation, SiteCollectionUrl et ItemLocation de la classe ClickOnceLaunchKeys (dans l’espace de noms Microsoft.PerformancePoint.Scorecards de la DLL Microsoft.PerformancePoint.Scorecards.Client).

Création d’objets en dehors de Dashboard Designer

Par défaut, les utilisateurs peuvent créer des objets personnalisés à partir de Dashboard Designer. Étant donné que Dashboard Designer crée des objets personnalisés sans utiliser les éditeurs personnalisés, il envoie uniquement des demandes OpenItem aux éditeurs personnalisés.

Pour permettre aux utilisateurs de créer des objets en dehors de Dashboard Designer, vous devez fournir les fonctionnalités suivantes :

• une logique dans votre éditeur de code pour créer des objets ;

• une action qui envoie une demande CreateItem à votre éditeur.

Par exemple, pour envoyer une demande Créer à partir d’un élément dans le référentiel, vous pouvez ajouter un élément de menu et une action qui envoie une demande CreateItem à partir de l’élément à votre éditeur. PerformancePoint Services stocke ses actions personnalisées dans le chemin d’accès suivant : %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\Template\Features\PPSWorkspaceCtype. Pour plus d’informations sur l’ajout d’éléments de menu personnalisés, voir Procédure : modifier l’interface utilisateur à l’aide d’actions personnalisées.

Voir aussi

Autres ressources

Créer des objets personnalisés pour les services PerformancePoint Services

Notions de base relatives à PerformancePoint Services

Exemples de code pour les pour les services PerformancePoint Services dans SharePoint Server 2010