Freigeben über

Gewusst wie: Manuelles Registrieren von PerformancePoint-Dienste-Erweiterungen

  • Artikel

Letzte Änderung: Dienstag, 30. August 2011

Zum Bereitstellen einer Erweiterung für PerformancePoint Services in Microsoft SharePoint Server 2010 gehört das Registrieren der Erweiterung und der benutzerdefinierten DLLs auf dem Anwendungsserver (der Computer mit PerformancePoint Services) und das anschließende Kopieren aller Hilfsdateien an die entsprechenden Zielspeicherorte.

Gilt für: SharePoint Server 2010

Sie müssen die Erweiterung in der Datei web.config von PerformancePoint Services (entweder manuell oder mithilfe eines Skripts oder eines benutzerdefinierten Zeitgeberauftrags) für jede PerformancePoint Services-Instanz in der Farm registrieren. Sie können die Komponenten einer PerformancePoint Services-Erweiterung jedoch in einer Lösung bündeln und für die gesamte Farm bereitstellen. Informationen zum Bereitstellen von SharePoint-Lösungen finden Sie unter Verwenden von Lösungen.

HinweisHinweis

Für die Bearbeitung der Datei web.config sind ausreichende administrative Berechtigungen auf dem Anwendungsserver erforderlich.

In diesem Thema wird beschrieben, wie Sie eine Erweiterung in der Datei web.config von PerformancePoint Services manuell registrieren, nachdem Sie Ihre benutzerdefinierten DLLs dem globalen Assemblycache hinzugefügt haben. Die Änderungen, die Sie vornehmen, hängen vom Erweiterungstyp ab (siehe Tabelle 1).

Tabelle 1. Mögliche Änderungen in Abhängigkeit vom Erweiterungstyp

Erweiterungstyp

Änderung in der Datei web.config

Bericht

Hinzufügen von Metadaten für ein benutzerdefiniertes Objekt

Filter

Hinzufügen von Metadaten für ein benutzerdefiniertes Objekt

Hinzufügen eines Schlüssels für einen Anbieter oder eine Transformation

Datenquelle

Hinzufügen von Metadaten für ein benutzerdefiniertes Objekt

Hinzufügen eines Schlüssels für einen Anbieter oder eine Transformation

Scorecardtransformation

Hinzufügen eines Schlüssels für einen Anbieter oder eine Transformation

Hinzufügen von Metadaten für ein benutzerdefiniertes Objekt

Sie müssen Metadaten für das benutzerdefinierte Berichts-, Filter- oder Datenquellenobjekt zur Datei web.config hinzufügen. PerformancePoint Services verwendet diese Metadaten zum Erstellen und Anzeigen von benutzerdefinierten Objekten und zum Öffnen benutzerdefinierter Editoren. Metadatenattribute sind Eigenschaften in der CustomFCODefinition-Klasse zugeordnet.

So fügen Sie Metadaten für ein benutzerdefiniertes Berichts-, Filter- oder Datenquellenobjekt hinzu

  1. Navigieren Sie zur Datei web.config von PerformancePoint Services, die standardmäßig unter C:\Program Files\Microsoft Office Servers\14.0\WebServices\PpsMonitoringServer auf dem Anwendungsserver gespeichert ist.

    Wichtiger HinweisWichtig

    Es wird empfohlen, vor dem Bearbeiten der Datei web.config eine Kopie zu erstellen.

  2. Öffnen Sie die Datei web.config von PerformancePoint Services in einem Texteditor, z. B. in Windows-Editor.

  3. Wenn die Erweiterung die erste benutzerdefinierte Erweiterung für PerformancePoint Services ist, die auf dem Server registriert werden soll, müssen Sie die Konfigurationsabschnittshandler registrieren und dann das CustomFCOGroup-Element wie folgt hinzufügen:

    1. Fügen Sie den folgenden Code in das sectionGroup-Element ein.

      <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. Wenn das öffentliche Schlüsseltoken für Ihre Version von Microsoft.PerformancePoint.Scorecards.Common.dll von der Version im Beispiel abweicht, ersetzen Sie den Wert für das PublicKeyToken-Attribut durch das tatsächliche öffentliche Schlüsseltoken. Sie finden diese Eigenschaft im Assemblycache.

    3. Fügen Sie folgenden Code in das Bpm-Element auf der gleichen Ebene wie die Elemente CustomDataSourceProviders, FCODaoProviders, CustomParameterDataProviders und CustomViewTransforms ein.

      <CustomFCOGroup></CustomFCOGroup>

  4. Fügen Sie den folgenden Code in das CustomFCOGroup-Element ein.

    <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>

    In den Schritten 5 bis 13 ersetzen Sie die Platzhalterwerte durch die tatsächlichen Werte für das Objekt. Stellen Sie sicher, dass Sie die eckigen Klammern entfernen. Die Anführungszeichen dürfen jedoch nicht entfernt werden.

    HinweisHinweis

    Anweisungen zum Installieren des PerformancePoint Services-Beispiels finden Sie unter Codebeispiel: Benutzerdefinierte Objekte für Berichte, Filter und tabulierte Datenquellen und Codebeispiel: Benutzerdefinierte Scorecardtransformationen.

  5. Geben Sie für das type-Attribut den Typ des benutzerdefinierten Objekts ein. Gültige Werte sind ReportView, Filter oder DataSource. PerformancePoint Services verwendet diesen Wert, um das Objekt im PerformancePoint Dashboard-Designer, in SharePoint Server 2010 und im PerformancePoint Services-Repository zu kategorisieren.

  6. Geben Sie für das subType-Attribut den eindeutigen Bezeichner für das Objekt als Zeichenfolge ein. Die Beispieldatenquelle verwendet beispielsweise den folgenden Eintrag: subType="WSTabularDataSource".

    Wenn ein Benutzer in Dashboard-Designer ein benutzerdefiniertes Objekt erstellt, wird der subType-Wert in der Datei web.config als SubTypeId-Eigenschaft des Objekts verwendet. PerformancePoint Services bestimmt anhand dieses Werts, ob ein Objekt benutzerdefiniert ist.

    HinweisHinweis

    Wenn der benutzerdefinierte Editor auch die SubTypeId-Eigenschaft des Objekts angibt, muss sie mit dem subType-Attribut in der Datei web.config übereinstimmen. Es empfiehlt sich, dass Editoren die SubTypeId-Eigenschaft nur angeben, wenn ein benutzerdefiniertes Objekt außerhalb des Dashboard-Designers erstellt wird. Weitere Informationen finden Sie unter Editoren für benutzerdefinierte PerformancePoint Services-Objekte.

  7. Geben Sie für das assemblyName-Attribut den vollqualifizierten Namen der Assembly ein, die die Ressourcendatei enthält. Verwenden Sie hierfür folgende Syntax.

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

    Wenn Sie keine Projektressourcen in der Erweiterung bereitstellen, entfernen Sie die Attribute assemblyName und resourcesName. (Das resourcesName-Attribut wird im nächsten Schritt beschrieben.)

    HinweisHinweis

    Anweisungen zum Hinzufügen von Ressourcen zur Erweiterung finden Sie unter Gewusst wie: Hinzufügen von Ressourcen zu einer PerformancePoint Services-Erweiterung.

  8. Geben Sie für das resourcesName-Attribut den vollqualifizierten Namen der Ressourcendatei ein. Sie müssen einen Wert angeben, wenn Sie einen Wert für das assemblyName-Attribut angeben. Entfernen Sie die Attribute assemblyName und resourcesName, wenn Sie keine Projektressourcen in der Erweiterung bereitstellen.

  9. Geben Sie für das FCOName-Attribut den Namen des benutzerdefinierten Objekts ein. Wenn Sie eine Ressourcenassembly angegeben haben, geben Sie nun den Ressourcenschlüssel für den Namen ein; geben Sie andernfalls den Namen als Zeichenfolge ein. Dieser Name wird im Dashboard-Designer, in SharePoint Server 2010 und im PerformancePoint Services-Repository angezeigt.

  10. Geben Sie für das FCODescription-Attribut die Beschreibung des benutzerdefinierten Objekts ein. Wenn Sie eine Ressourcenassembly angegeben haben, geben Sie nun den Ressourcenschlüssel für die Beschreibung ein; geben Sie andernfalls die Beschreibung als Zeichenfolge ein. Diese Beschreibung wird im Dashboard-Designer im Dialogfeld für die Vorlagenauswahl angezeigt.

  11. Geben Sie für das FCOTemplateIcon-Attribut den Ressourcenschlüssel für das Symbol ein. Wenn die Erweiterung kein benutzerdefiniertes Symbol bereitstellt, müssen Sie das FCOTemplateIcon-Attribut entfernen. Das Symbol wird im Dashboard-Designer im Dialogfeld für die Vorlagenauswahl angezeigt.

    HinweisHinweis

    Damit ein benutzerdefiniertes Symbol verwendet werden kann, muss die Erweiterung eine 32 x 32 Pixel umfassende Bitmapbildressource für das Symbol einschließen. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen von Ressourcen zu einer PerformancePoint Services-Erweiterung.

  12. Geben Sie für das name-Attribut des RendererClass-Elements den vollqualifizierten Namen der Rendererklasse ein. Es handelt sich hierbei um die Klasse, die das standardmäßige Webserversteuerelement definiert, das das benutzerdefinierte Berichts- oder Filterauswahlsteuerelement rendert. Wählen Sie das Format Namespace.Class name, DLL name, DLL version number, DLL culture, DLL public key token. Die Rendererklasse des Beispielberichts wird wie folgt registriert.

    <RendererClass name="Microsoft.PerformancePoint.SDK.Samples.SampleReport.SampleReportRenderer,
    Microsoft.PerformancePoint.SDK.Samples, Version=14.0.0.0, Culture=neutral,
    PublicKeyToken=fa525c8383a44a52" />

    Dieser Wert ist für die Typen ReportView und Filter erforderlich. Wenn Sie ein benutzerdefiniertes Datenquellenobjekt registrieren, müssen Sie das RendererClass-Element und name-Attribut entfernen.

    HinweisHinweis

    Sie können es den Benutzern ermöglichen, diesen Wert außer Kraft zu setzen, indem Sie die RendererClassName-Eigenschaft über die Benutzeroberfläche des benutzerdefinierten Editors verfügbar machen.

  13. Geben Sie für das EditorURI-Attribut die URI des benutzerdefinierten Editors ein. PerformancePoint Services fügt den type- und den subType-Wert des Objekts an diesen Pfad an und verwendet diesen Pfad dann, um den Editor über den Dashboard-Designer oder SharePoint Server 2010 zu öffnen.

    Sie können optional einen Parameter an die Editor-URI anfügen. Der Parameter wird jedes Mal an den Editor übergeben, wenn dieser geöffnet wird. Der Wert ist statisch und kann deshalb nicht dynamisch generiert werden. Das Anfügen eines Parameters bietet sich beispielsweise bei einem Editor an, der sowohl Berichte als auch Filter unterstützt. Um den Editor über den Typ des Objekts zu informieren, mit dem er arbeitet, können Sie den type-Wert im Editor-URI übergeben. Bei diesem Szenario würden Sie ?type=ReportView zum Editorpfad für die Berichtserweiterung und ?type=Filter für die Filtererweiterung anfügen. Diese Parameter wirken sich nicht auf die Parameter aus, die von PerformancePoint Services angefügt werden. Weitere Informationen zu den von PerformancePoint Services angefügten Parametern finden Sie unter Editoren für benutzerdefinierte PerformancePoint Services-Objekte.

  14. Je nach Objekttyp schließen Sie die Datei nun, oder registrieren Sie einen Anbieter.

    • Wenn Sie einen ReportView-Typ registrieren, speichern Sie die Datei web.config, und schließen Sie sie dann.

    • Wenn Sie einen Filter- oder einen DataSource-Typ registrieren, müssen Sie außerdem den Anbieter registrieren. Fahren Sie mit Schritt 2 im folgenden Verfahren fort.

Hinzufügen eines Schlüssels für einen Anbieter oder eine Transformation

Sie müssen einen Anbieter oder eine Scorecardtransformation registrieren, wenn die Erweiterung einen Datenquellenanbieter, einen Datenanbieter für einen Filter oder eine Scorecardtransformation definiert.

So fügen Sie einen Schlüssel für einen Anbieter oder eine Transformation hinzu

  1. Erstellen Sie eine Kopie der Datei web.config von PerformancePoint Services. Der Standardpfad der Datei web.config auf dem Anwendungsserver lautet C:\Program Files\Microsoft Office Servers\14.0\WebServices\PpsMonitoringServer.

  2. Öffnen Sie die Datei web.config von PerformancePoint Services in einem Texteditor, z. B. Windows-Editor.

  3. Gehen Sie folgendermaßen vor, um einen Schlüssel für den Anbieter oder die Transformations-DLL hinzuzufügen:

    HinweisHinweis

    Um die Lesbarkeit zu verbessern, wurden in den folgenden Beispielen Zeilenumbrüche eingefügt. Sie können die Zeilenumbrüche entfernen, nachdem Sie den Eintrag in die Datei web.config eingefügt haben.

    • Zum Registrieren eines Datenquellenanbieters fügen Sie einen Schlüssel zum CustomDataSourceProviders-Element hinzu, und verwenden Sie hierbei folgende Syntax:

      <add key="[data source provider ID]" value="[namespace name.class name], [DLL name], Version=[version number], Culture=[culture type], PublicKeyToken=[public key token]" />

      Um beispielsweise den Datenquellenanbieter aus der Datenquellenerweiterung im PerformancePoint Services-Beispiel zu registrieren, fügen Sie den folgenden Schlüssel hinzu.

      <add key="WSTabularDataSource"
    value="Microsoft.PerformancePoint.SDK.Samples.SampleDataSource.WSTabularDataSourceProvider,
    Microsoft.PerformancePoint.SDK.Samples, Version=14.0.0.0, Culture=neutral,
    PublicKeyToken=fa525c8383a44a52" />

      Die Datenquellenanbieter-ID (WSTabularDataSource) muss dem subType-Attribut entsprechen, das Sie für das benutzerdefinierte Datenquellenobjekt im CustomFCOGroup-Element angegeben haben, und sie muss außerdem dem Wert entsprechen, der von der GetId()-Methode zurückgegeben wird, die von der TabularDataSourceProvider-Klasse implementiert wird. Sie muss außerdem der SubTypeId-Eigenschaft entsprechen, wenn sie vom Editor definiert wird.

    • Zum Registrieren eines Datenanbieters für einen Filter fügen Sie einen Schlüssel zum CustomParameterDataProviders-Element hinzu. Verwenden Sie hierfür die folgende Syntax: <add key="[data provider ID]" value="[namespace name.class name], [DLL name], Version=[version number], Culture=[culture type], PublicKeyToken=[public key token]" />

      HinweisHinweis

      Der Wert des key-Attributs muss von der GetId()-Methode im Datenanbieter des Filters und von der ParameterProviderId-Eigenschaft zurückgegeben werden, die wiederum von der BeginPoints-Eigenschaft des Filters zurückgegeben wird..

      Um beispielsweise den Datenanbieter aus der Filtererweiterung im PerformancePoint Services-Beispiel zu registrieren, fügen Sie den folgenden Schlüssel hinzu.

      <add key="SampleFilterDataProvider"
    value="Microsoft.PerformancePoint.SDK.Samples.SampleFilter.SampleFilterDataProvider,
    Microsoft.PerformancePoint.SDK.Samples, Version=14.0.0.0, Culture=neutral,
    PublicKeyToken=fa525c8383a44a52" />

    • Zum Registrieren einer Scorecardtransformation fügen Sie einen Schlüssel zum CustomViewTransforms-Element hinzu; verwenden Sie hierbei die folgende Syntax:

      <add key="[unique transform ID]" value="[namespace name.class name], [DLL name], Version=[version number], Culture=[culture type], PublicKeyToken=[public key token]" />

      Um beispielsweise alle Transformationen aus dem PerformancePoint Services-Beispiel zu registrieren, fügen Sie die folgenden Schlüssel hinzu.

      <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"/>

  4. Speichern Sie die Datei web.config, und schließen Sie sie.

Siehe auch

Konzepte

Entwicklungsszenarien für PerformancePoint-Dienste

Weitere Ressourcen

Gewusst wie... in PerformancePoint Services

Erstellen von benutzerdefinierten Objekten für PerformancePoint Services

Verwenden von Lösungen

How to: Install an Assembly into the Global Assembly Cache