Procédure : enregistrer manuellement des extensions PerformancePoint Services

Article
09/18/2014

Dernière modification : mardi 30 août 2011

La procédure de déploiement d’une extension pour les Services PerformancePoint dans Microsoft SharePoint Server 2010 consiste entre autres à enregistrer votre extension et vos DLL personnalisées sur le serveur d’applications, c’est-à-dire l’ordinateur qui exécute PerformancePoint Services, puis à copier les fichiers de prise en charge vers leur emplacement cible.

S’applique à : SharePoint Server 2010

Vous devez enregistrer votre extension dans le fichier web.config de PerformancePoint Services (manuellement ou à l’aide d’un script ou d’un travail de minuteur personnalisé) pour chaque instance de PerformancePoint Services de la batterie. Toutefois, vous pouvez empaqueter et déployer les composants d’une extension PerformancePoint Services comme solution dans toute la batterie. Pour plus d’informations sur la façon de déployer des solutions SharePoint, voir Utilisation de solutions.

Notes

La modification du fichier web.config nécessite de disposer d’autorisations administratives suffisantes sur le serveur d’applications.

Cette rubrique décrit comment enregistrer manuellement votre extension dans le fichier web.config PerformancePoint Services après avoir ajouté vos fichiers DLL personnalisés au Global Assembly Cache. Les modifications que vous apportez varient en fonction du type de votre extension, comme indiqué dans le Tableau 1.

Tableau 1. Modifications qui peuvent être apportées par type d’extension

Type d’extension	Modification dans le fichier web.config
Rapport	Ajout de métadonnées pour un objet personnalisé
Filtre	Ajout de métadonnées pour un objet personnalisé Ajout d’une clé pour un fournisseur ou une transformation
Source de données	Ajout de métadonnées pour un objet personnalisé Ajout d’une clé pour un fournisseur ou une transformation
Transformation de carte de performance	Ajout d’une clé pour un fournisseur ou une transformation

Ajout de métadonnées pour un objet personnalisé

Vous devez ajouter des métadonnées pour votre objet de source de données, rapport ou filtre personnalisé au fichier web.config. PerformancePoint Services utilise ces métadonnées pour créer et afficher des objets personnalisés et pour ouvrir des éditeurs personnalisés. Les attributs de métadonnées sont mappés à des propriétés dans la classe CustomFCODefinition.

Pour ajouter des métadonnées pour un objet de source de données, filtre ou rapport personnalisé

Naviguez jusqu’au fichier web.config de PerformancePoint Services au 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.
Si votre extension est la première extension personnalisée pour PerformancePoint Services à être enregistrée sur le serveur, vous devez enregistrer les gestionnaires de section de configuration, puis ajouter l’élément CustomFCOGroup, comme suit :
1. Collez le code suivant dans l’élément sectionGroup.
```
<section name="CustomFCOGroup" type="Microsoft.PerformancePoint.Scorecards.Common.Extensions.CustomFCOSection,

    Microsoft.PerformancePoint.Scorecards.Common, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c"
    allowLocation="true" allowDefinition="Everywhere" />
```
2. Si le jeton de clé publique pour votre version de Microsoft.PerformancePoint.Scorecards.Common.dll diffère de celui de la version dans l’exemple, remplacez la valeur de l’attribut PublicKeyToken par le jeton de clé publique réel. Cette propriété se trouve dans le cache d’assembly.
3. Collez le code suivant dans l’élément Bpm au même niveau que les éléments CustomDataSourceProviders, FCODaoProviders, CustomParameterDataProviders et CustomViewTransforms.
```
<CustomFCOGroup></CustomFCOGroup>
```

Collez le code suivant dans l’élément CustomFCOGroup.

<CustomFCO type="[The object type: ReportView, Filter, or DataSource.]"
    subType="[The unique identifier for your custom ReportView, Filter, or DataSource object.]" >
    <Resources assemblyName="[The fully qualified name of the resources assembly.]"
        resourcesName="[The fully qualified name of the resources file.]"
        FCOName="[The display name for the custom object.]"
        FCODescription="[The description for the custom object.]"
        FCOTemplateIcon="[The image resource to use as the icon for the custom object.]"/>
    <RendererClass name="[The fully qualified name of the renderer class in the format: 
        Namespace.Class name, DLL name, DLL version number, DLL culture, DLL public key token. 
        Applies to ReportView and Filter objects only.]"/>
    <EditorURI uri="[The URI of the custom editor.]"/>
</CustomFCO>

Aux étapes 5 à 13, vous remplacez les valeurs d’espace réservé par des valeurs réelles pour votre objet. Veillez à supprimer les crochets, mais ne supprimez pas les guillemets.

Notes

Pour obtenir des instructions sur la façon d’installer l’exemple PerformancePoint Services, voir Exemple de code : objets personnalisés de rapport, de filtre et de source de données tabulaires et Exemple de code : transformations de tableau de bord personnalisées.

Pour l’attribut type, entrez le type de votre objet personnalisé. Les valeurs valides sont ReportView, Filter ou DataSource. PerformancePoint Services utilise cette valeur pour classer l’objet dans PerformancePoint Dashboard Designer, SharePoint Server 2010 et dans le référentiel PerformancePoint Services.
Pour l’attribut subType, entrez l’identificateur unique pour votre objet sous forme de chaîne. Par exemple, l’exemple de source de données utilise l’entrée suivante : subType="WSTabularDataSource".

Lorsqu’un utilisateur crée un objet personnalisé à partir de Dashboard Designer, la valeur subType dans le fichier web.config est utilisée comme propriété SubTypeId de l’objet. PerformancePoint Services utilise cette valeur pour déterminer si un objet est personnalisé.

Notes

Si votre éditeur personnalisé spécifie également la propriété SubTypeId de l’objet, cette dernière doit correspondre à l’attribut subType dans le fichier web.config. En guise de méthode conseillée, les éditeurs doivent spécifier la propriété SubTypeId uniquement lors de la création d’un objet personnalisé en dehors de Dashboard Designer. Pour plus d’informations, voir Éditeurs pour les objets personnalisés des services PerformancePoint Services.
Pour l’attribut assemblyName, entrez le nom qualifié complet de l’assembly qui contient le fichier de ressources en utilisant le format suivant.

assemblyName="[DLL name], Version=[version number], Culture=[culture type], PublicKeyToken=[public key token]"

Si vous ne fournissez pas de ressources de projet dans votre extension, supprimez les attributs assemblyName et resourcesName. (L’attribut resourcesName est décrit à l’étape suivante.)

Notes

Pour obtenir des instructions sur la façon d’ajouter des ressources à votre extension, voir Procédure : ajouter des ressources à une extension des services PerformancePoint Services.
Pour l’attribut resourcesName, entrez le nom qualifié complet du fichier de ressources. Vous devez fournir une valeur si vous spécifiez une valeur pour l’attribut assemblyName. Si vous ne fournissez pas de ressources de projet dans votre extension, supprimez les attributs assemblyName et resourcesName.
Pour l’attribut FCOName, entrez le nom de l’objet personnalisé. Si vous avez spécifié un assembly de ressources, entrez la clé de ressource pour le nom ; sinon, entrez le nom sous forme de chaîne. Ce nom est affiché dans Dashboard Designer, SharePoint Server 2010 et dans le référentiel PerformancePoint Services.
Pour l’attribut FCODescription, entrez la description de l’objet personnalisé. Si vous avez spécifié un assembly de ressources, entrez la clé de ressource pour la description ; dans le cas contraire, entrez la description sous forme de chaîne. Cette description s’affiche dans la boîte de dialogue de sélection de modèle dans Dashboard Designer.
Pour l’attribut FCOTemplateIcon, entrez la clé de ressource pour l’icône. Si votre extension ne fournit pas d’icône personnalisée, supprimez l’attribut FCOTemplateIcon. L’icône est affichée dans la boîte de dialogue de sélection de modèle dans Dashboard Designer.

Notes

Pour utiliser une icône personnalisée, votre extension doit inclure une ressource d’image bitmap 32 x 32 pixels pour l’icône. Pour plus d’informations, voir Procédure : ajouter des ressources à une extension des services PerformancePoint Services.
Pour l’attribut name de l’élément RendererClass, entrez le nom complet de la classe de convertisseur. Il s’agit du contrôle serveur Web par défaut qui restitue le contrôle de sélection de filtre ou de rapport personnalisé. Utilisez le format Namespace.Class name, DLL name, DLL version number, DLL culture, DLL public key token. Par exemple, la classe de convertisseur pour l’exemple de rapport est enregistrée comme suit.
```
<RendererClass name="Microsoft.PerformancePoint.SDK.Samples.SampleReport.SampleReportRenderer,
    Microsoft.PerformancePoint.SDK.Samples, Version=14.0.0.0, Culture=neutral,
    PublicKeyToken=fa525c8383a44a52" />
```
Cette valeur est requise pour les types ReportView et Filter. Si vous enregistrez un objet de source de données personnalisé, supprimez l’élément RendererClass et l’attribut name.

Notes

Vous pouvez permettre aux utilisateurs de remplacer cette valeur en exposant la propriété RendererClassName dans l’interface utilisateur de l’éditeur personnalisé.
Pour l’attribut EditorURI, entrez l’URI de l’éditeur personnalisé. PerformancePoint Services ajoute le type et le subType de l’objet à ce chemin d’accès, puis l’utilise pour ouvrir l’éditeur à partir de Dashboard Designer ou SharePoint Server 2010.

Vous pouvez éventuellement ajouter un paramètre à l’URI d’éditeur. Le paramètre est passé à l’éditeur chaque fois qu’il est ouvert. La valeur est statique ; elle ne peut pas être générée de manière dynamique. L’un des scénarios d’ajout d’un paramètre concerne un éditeur qui prend en charge les rapports et les filtres. Pour indiquer à votre éditeur sur quel type d’objet il opère, vous pouvez passer le type dans l’URI d’éditeur. Pour ce scénario, vous ajouteriez ?type=ReportView au chemin d’accès de l’éditeur pour votre extension de rapport et ?type=Filter pour votre extension de filtre. Ces paramètres n’affectent pas les paramètres ajoutés par PerformancePoint Services. Pour plus d’informations sur les paramètres ajoutés par PerformancePoint Services, voir Éditeurs pour les objets personnalisés des services PerformancePoint Services.
Selon votre type d’objet, fermez le fichier ou enregistrez un fournisseur.
- Si vous enregistrez un type ReportView, enregistrez puis fermez le fichier web.config.
- Si vous enregistrez un type Filter ou DataSource, vous devez également enregistrer votre fournisseur. Passez à l’étape 2 de la procédure suivante.

Ajout d’une clé pour un fournisseur ou une transformation

Vous devez enregistrer un fournisseur ou une transformation de carte de performance si votre extension définit un fournisseur de source de données, un fournisseur de données pour un filtre ou une transformation de carte de performance.

Pour ajouter une clé pour un fournisseur ou une transformation

Effectuez une copie du fichier web.config de PerformancePoint Services. Le chemin d’accès par défaut au fichier web.config sur le serveur d’applications est C:\Program Files\Microsoft Office Servers\14.0\WebServices\PpsMonitoringServer.
Ouvrez le fichier web.config de PerformancePoint Services dans un éditeur de texte, tel que le Bloc-notes.
Ajoutez une clé pour la DLL de fournisseur ou de transformation, comme suit :

Notes

Afin d’améliorer la lisibilité, des sauts de ligne sont ajoutés aux exemples suivants. Vous pouvez supprimer ces sauts de ligne après avoir collé l’entrée dans le fichier web.config.
- Pour enregistrer un fournisseur de source de données, ajoutez une clé dans l’élément CustomDataSourceProviders en utilisant le format suivant :
  
  <add key="[data source provider ID]" value="[namespace name.class name], [DLL name], Version=[version number], Culture=[culture type], PublicKeyToken=[public key token]" />
  
  Par exemple, pour enregistrer le fournisseur de source de données à partir de l’extension de source de données dans l’exemple PerformancePoint Services, ajoutez la clé suivante.
```
<add key="WSTabularDataSource"
    value="Microsoft.PerformancePoint.SDK.Samples.SampleDataSource.WSTabularDataSourceProvider,
    Microsoft.PerformancePoint.SDK.Samples, Version=14.0.0.0, Culture=neutral,
    PublicKeyToken=fa525c8383a44a52" />
```
  L’ID de fournisseur de source de données (WSTabularDataSource) doit correspondre à l’attribut subType que vous avez spécifié pour l’objet source de données personnalisé dans l’élément CustomFCOGroup , et il doit correspondre à la valeur renvoyée par la méthode GetId() , qui est implémentée par la classe TabularDataSourceProvider. En outre, il doit correspondre à la propriété SubTypeId si votre éditeur la définit.
- Pour enregistrer un fournisseur de source de données pour un filtre, ajoutez une clé dans l’élément CustomParameterDataProviders en utilisant le format suivant : <add key="[data provider ID]" value="[namespace name.class name], [DLL name], Version=[version number], Culture=[culture type], PublicKeyToken=[public key token]" />
  
  Notes
  
  La valeur de l’attribut key doit être renvoyée par la méthode GetId() dans le fournisseur de données du filtre et par la propriété ParameterProviderId , qui est retournée par la propriété BeginPoints du filtre.
  
  Par exemple, pour enregistrer le fournisseur de données à partir de l’extension de filtre dans l’exemple PerformancePoint Services, ajoutez la clé suivante.
```
<add key="SampleFilterDataProvider"
    value="Microsoft.PerformancePoint.SDK.Samples.SampleFilter.SampleFilterDataProvider,
    Microsoft.PerformancePoint.SDK.Samples, Version=14.0.0.0, Culture=neutral,
    PublicKeyToken=fa525c8383a44a52" />
```
- Pour enregistrer une transformation de carte de performance, ajoutez une clé dans l’élément CustomViewTransforms en utilisant le format suivant :
  
  <add key="[unique transform ID]" value="[namespace name.class name], [DLL name], Version=[version number], Culture=[culture type], PublicKeyToken=[public key token]" />
  
  Par exemple, pour enregistrer toutes les transformations de l’exemple PerformancePoint Services, ajoutez les clés suivantes.
```
<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.