Benutzerdefinierte Metriken erstellen

Artikel
12/19/2024

Wichtig

Einige oder alle dieser Funktionen sind als Teil einer Vorschauversion verfügbar. Inhalt und Funktionalität können sich ändern.

Sie können die Möglichkeit zum Definieren und Berechnen benutzerdefinierter Metriken erweitern, indem Sie demselben Muster folgen, das für vordefinierte Metriken verwendet wird.

Aggregierte Tabellen generieren

Abhängig von der Metrik, die Sie berechnen möchten, ist eines der folgenden Szenarios anwendbar. Folgen die Schritte für das Szenario, das auf Sie zutrifft.

Szenario 1

Die vorgefertigte Aggregattabelle unterstützt die erforderlichen Messdaten mit dem erforderlichen Dimensionssatz, sodass Sie keine Änderungen an der Aggregattabelle vornehmen müssen.

Generieren Sie die vorgefertigte Aggregattabelle, wie unter Aggregattabellen generieren erläutert.
Aktualisieren Sie das semantische Modell DatasetForMetricsMeasures_DTST .

Szenario 2

Die vorgefertigten aggregierten Tabellen unterstützen die erforderlichen Messdaten, aber die erforderliche Dimension fehlt.

Fügen Sie der vorgefertigten Aggregattabelle die erforderliche Dimension hinzu, indem Sie die Berechnungslogik im Notebook aktualisieren, das die Berechnungslogik der Aggregattabelle enthält. Wenn beispielsweise die Berechnungslogik der EmissionsAggregate-Tabelle aktualisiert werden muss, aktualisieren Sie die Logik in CreateAggregateForEmissionsMetrics_INTB.
Führen Sie das Notebook mit aktualisierter Berechnungslogik aus, um die aggregierte Tabelle zu generieren.

Anmerkung

Löschen Sie keine vorhandenen Dimensionen aus dem vorgefertigten Aggregat, da dies Auswirkungen auf die Berechnung der vorgefertigten Metrik haben kann.
Aktualisieren Sie die aggregierte Tabelle im semantischen Modell DatasetForMetricsMeasures_DTST :
1. Laden Sie das semantische Modell DatasetForMetricsMeasures_DTST von der Arbeitsbereichsseite herunter und öffnen Sie das Modell in Power BI Desktop.
2. Klicken Sie in Power BI Desktop mit der rechten Maustaste auf die aktualisierte Aggregattabelle und Auswählen Abfrage bearbeiten , um den Power Query Editor zu öffnen.
3. Öffnen Sie im Power Query Editor den Erweiterten Editor, indem Sie in der Multifunktionsleiste Erweiterter Editor auswählen.
4. Aktualisieren Sie den Abfragecode, um die neue Spalte in alle Schritte einzuschließen, in denen auf Spalten verwiesen wird, und passen Sie die Fehlerbehandlung nach Bedarf für die neue Spalte an. Wählen Sie Fertig aus.
5. Auswählen Refresh Vorschauversion , um die aktualisierten Daten anzuzeigen. Nach der Bestätigung Auswählen Schließen und Übernehmen , um die Änderungen auf das Datenmodell anzuwenden.
6. Speichern Sie die aktualisierte Power BI Datei mit den hinzugefügten Maßnahmen und Schemaänderungen. Veröffentlichen Sie das aktualisierte semantische Modell im Zielarbeitsbereich im Power BI Dienst und überschreiben Sie dabei die vorherige Version im Arbeitsbereich.

Szenario 3

Vorgefertigte Aggregattabellen unterstützen die erforderlichen Messdaten nicht:

Erstellen Sie eine benutzerdefinierte Aggregattabelle, indem Sie die Berechnungslogik (mithilfe ähnlicher Muster wie für vorgefertigte Aggregattabellen) in einem Notebook definieren.
Führen Sie das Notebook aus, um die aggregierte Tabelle im computedESGMetrics_LH Lakehouse zu generieren.
Fügen Sie die benutzerdefinierte Aggregattabelle zu DatasetForMetricsMeasures_DTST hinzu:
1. Laden Sie das semantische Modell von der Arbeitsbereichsseite herunter und öffnen Sie das Modell in Power BI Desktop.
2. In Power BI Desktop, Auswählen OneLake-Daten-Hub, Auswählen Lakehouses, und dann im Popup Auswählen die ComputedESGMetrics Lakehouse. Auswählen den Dropdown-Pfeil auf der Schaltfläche Verbinden und dann Auswählen Verbinden zu SQL Endpunkt.
3. Auswählen die benutzerdefinierten Aggregattabellen, die in das semantische Modell importiert werden sollen. Auswählen Laden , um die Tabellen einzufügen Power BI Desktop.
4. Stellen Sie in der Eingabeaufforderung die Verbindungseinstellung auf Importmodus ein, um die Daten in das Modell zu bringen und Auswählen OK.
5. Wenn die Tabellen im Bereich Daten geladen sind, klicken Sie mit der rechten Maustaste auf die neu hinzugefügten Tabellen und Auswählen Abfrage bearbeiten , um den Power Query Editor zu öffnen.
6. Öffnen Sie den Erweiterten Editor im Bereich „Abfrage-Editor“, um den Abfragecode zu überprüfen. Fügen Sie den erforderlichen Fehlerbehandlungscode hinzu, um unerwartete Datenprobleme zu bewältigen.
  
  Standardmäßig wird dieser Code im Abfrage-Editorbereich angezeigt:
```
let
   Source = Sql.Database("x6eps4xrq2xudenlfv6naeo3i4-lzqqwvhquhb2e7afwzp3ge4.msit-datawarehouse.fabric.microsoft.com", "SDS_ESGDE_ems_ComputedESGMetrics_LH"),
   <Table Name>= Source{[Schema="dbo",Item="<Table Name from the Lakehouse>"]}[Data]
in
<Table Name>
```
  Ersetzen Sie diese Abfrage durch den folgenden Code und nehmen Sie die erforderlichen Änderungen basierend auf der Tabelle und den Spalten in Ihrer benutzerdefinierten Aggregattabelle vor:
```
let
   Source = Sql.Database("x6eps4xrq2xudenlfv6naeo3i4-lzqqwvhquhb2e7afwzp3ge4.msit-datawarehouse.fabric.microsoft.com", "SDS_ESGDE_ems_ComputedESGMetrics_LH"),
   dbo_EmissionsAggregate = try Source{[Schema="dbo",Item="EmissionsAggregate"]}[Data] otherwise #table(
       type table
       [
           #"ReportingPeriod"=number,
           #"PartyId"=number,
           #"PartyTypeName"=text,
           #"PartyName"=text,
           #"SecondaryPartyId"=number,
           #"SecondaryPartyTypeName"=text,	
           #"SecondaryPartyName"=text,
           #"EmissionSource"=text,	
#"isRolledUp"=logical,	
           #"CO2eEmissionUnits"=number,	
           #"UnitOfMeasureName"=text
       ],
       {})
in
   dbo_EmissionsAggregate
```
7. Um die Änderungen zu speichern, Auswählen Fertig.
8. Um die Änderungen anzuwenden, Auswählen Schließen und Übernehmen im Power Query Editor.
9. Fügen Sie in der Modellansicht bei Bedarf Beziehungen zwischen den neu hinzugefügten Tabellen hinzu.
10. Speichern Sie die aktualisierte Power BI Desktop Datei. Veröffentlichen Sie das Modell im Arbeitsbereich des Power BI Dienstes, indem Sie Datei > Veröffentlichen > Veröffentlichen in Power BI auswählen und den Zielarbeitsbereich auswählen. Diese Aktion überschreibt das vorhandene semantische Modell im Arbeitsbereich, ohne die ID des Modells zu ändern.

Erstellen Sie eine weitere Power BI Kennzahl zur Berechnung der benutzerdefinierten Metrik

Wie unter Metrikdaten berechnen und speichern erwähnt, wird die Berechnung von ESG-Metriken in Bezug auf Power BI Kennzahlen, Filter und Dimensionen angegeben.

Sie können die Liste der vorgefertigten Maßnahmen durchgehen und prüfen, ob Sie eine der vorhandenen Maßnahmen zum Berechnen der benutzerdefinierten Metrik wiederverwenden können. Wenn Sie eine vorhandene Maßnahme wiederverwenden können, können Sie dies überspringen Schritt.

Wenn Sie eine vorhandene Maßnahme nicht verwenden können, erstellen Sie eine andere Power BI Maßnahme im DatasetForMetricsMeasures_DTST.

Auswählen das DatasetForMetricsMeasures_DTST semantische Modellelement aus der Listenansicht des Arbeitsbereichs.
Auswählen Öffnen Sie das Datenmodell von der Seite zum semantischen Modell.

Anmerkung

Wenn „ Datenmodell öffnen “ ausgegraut ist, navigieren Sie zu den Arbeitsbereichseinstellungen. Öffnen Sie Power BI/Allgemein und aktivieren Sie die Einstellung Benutzer können Datenmodelle bearbeiten in der Power BI Diensteinstellung (Vorschauversion) .
Auswählen ESG_Measures aus der Seitenleiste Daten und dann Auswählen Neue Maßnahme , um eine Maßnahme zu erstellen.
Aktualisieren Sie den Maßnamen und fügen Sie dann die Rechenlogik in Form von DAX-Abfragen (Data Analysis Expressions) hinzu. Weitere Informationen zu Power BI Maßnahmen Erstellen von Maßnahmen zur Datenanalyse Power BI Desktop in der Power BI Dokumentation.

Erstellen einer Metrikdefinition

Sie können die Metrikdefinition mithilfe der vorgefertigten Hilfsfunktion create_metric_definition() erstellen. Weitere Informationen zu dieser Funktion finden Sie unter create_metric_definition.

Geben Sie im Funktionsparameter die Metrikeigenschaften als JSON-Datei an. Beispielsweise möchten Sie möglicherweise den Wasserverbrauch pro Anlage für Anlagen in Gebieten mit hohem oder extrem hohem Wasserrisiko berechnen. Die vordefinierte Metrik gibt nur den Gesamtwasserverbrauch für Wasserrisikobereiche an, bietet jedoch keine Aufschlüsselung nach Anlagen. Mit dem folgenden Code Ausschnitt können Sie eine Gesamtwasserverbrauch in Gebieten mit Wasserrisiko nach Einrichtungen benutzerdefinierte Metrikdefinition erstellen.

%run SDS_ESGM_SDS_UtilitiesForMetrics_INTB
metrics_manager = MetricsManager()
metrics_manager.create_metric_definition(
    {
            "metric_name": "Total water consumption in areas at water risk facility wise",
            "measure_name": "WaterConsumption",
            "dimensions": [
                "WaterUtilizationAggregate[ReportingPeriod]",
                "WaterUtilizationAggregate[UnitOfMeasureName]",
                "WaterUtilizationAggregate[PartyName]",
                "WaterUtilizationAggregate[PartyTypeName]"
            ],
            "filters": {
                "WaterUtilizationAggregate[isRolledUp]": [
                    "False"
                ],
                "WaterUtilizationAggregate[WaterRiskIndexName]": [
                    "Extremely High",
                    "High"
                ],
                "WaterUtilizationAggregate[UnitOfMeasureName]": [
                    "Cubic metres"
                ]
            },
            "sustainability_area": "Water and marine resources",
            "labels": {
                "Reporting standard": [
                    "CSRD"
                ],
                "Disclosure datapoint": [
                    "E3-4_02"
                ]
            }
        })

Wenn die Funktion erfolgreich ausgeführt wird, wird die Metrikdefinition als Zeile in der Tabelle MetricsDefinitions im ComputedESGMetrics_LH Lakehouse hinzugefügt.

Anmerkung

Der Metrikname muss für jede Metrik eindeutig sein. Wenn Sie eine benutzerdefinierte Metrik mit einem Namen erstellen, der mit dem Namen einer vorhandenen Metrik in der Tabelle MetricsDefinitions übereinstimmt, tritt bei der Funktion ein Fehler auf.
In der JSON-Datei mit der Metrikdefinition können Sie die Angabe der Filter- und Bezeichnungseigenschaften überspringen, wenn Sie sie für Ihre benutzerdefinierte Metrik nicht benötigen.

Metrikdaten generieren und speichern

Verwenden Sie zum Generieren und Speichern von Metrikdaten dieselben Schritte wie für vorgefertigte Metriken angegeben. Geben Sie im Parameter metric_names den benutzerdefinierten Metriknamen an, den Sie im vorherigen Schritt erstellt haben.

Metrikdaten verwenden

Wenn die benutzerdefinierten Metrikdaten in der Tabelle ComputedESGMetrics verfügbar sind, können Sie die Daten für diese Szenarien nutzen:

Visualisieren und analysieren Sie benutzerdefinierte Metrikdaten

Sie können benutzerdefinierte Messdaten im vorgefertigten Power BI Dashboard visualisieren und analysieren, indem Sie die Schritte unter Messdaten visualisieren und analysieren ausführen.

Wenn die benutzerdefinierte Metrik neben dem Berichtszeitraum und dem Maßeinheitsnamen zusätzliche Dimensionen aufweist, kann das vorgefertigte Dashboard die Visualisierung für eine weitere Dimension als Slicer und zwei weitere Dimensionen als mehrzeiliger Filter verarbeiten.

Sie können die Dimensionen der Metriktabelle, die für Slicer und Mehrzeilenfilter berücksichtigt werden sollen, in der Datei translate_metrics_output_for_Report_config.json angeben.

Sie erstellen beispielsweise eine Aufschlüsselung der Treibhausgasemissionen nach Ländern als benutzerdefinierte Metrik mit diesen Spalten:

Wert
Land / Region
Geltungsbereich
Buchhaltungsmethode
Berichtszeitraum
Maßeinheitenname

Um diese Metrik auf dem vorgefertigten Dashboard zu visualisieren, können Sie die Daten in der Konfiguration wie folgt angeben:
```
{
         "metric_name": "Disaggregation of GHG emissions - by country",
         "dimensions_for_multiple_lines": [
             "Scope",
             "AccountingMethod"
         ],
         "dimension_for_slicer": "CountryOrRegion"
}
```
Dieses Ausschnitt fügt die Dimension LandOderRegion als Slicer zum Dashboard hinzu. Die Dimensionen Scope und AccountingMethod werden mit einem Unterstrich (_) verknüpft und dann als Basisfilter (oder Mehrzeilenfilter) zum Dashboard hinzugefügt.
Nach der Aktualisierung der Konfiguration können Sie dieselben Schritte wie hier angegeben ausführen, um Daten vorgefertigter Metriken zu visualisieren. TranslateOutputOfMetricsForReport_INTB Notebook.
Aktualisieren Sie das semantische Modell DatasetForMetricsDashboard_DTST .
Öffnen Sie das Element DashboardForMetrics_RPT . Sie sollten die benutzerdefinierte Metrik in einer der vier Registerkarten finden, basierend auf dem der Metrik zugeordneten Nachhaltigkeitsbereich.

Anmerkung

Wenn der Nachhaltigkeitsbereich als ein anderer Wert als Klimawandel, Soziales, Governance, Wasser- und Meeresressourcen oder Ressourcennutzung und Kreislaufwirtschaft angegeben ist, müssen Sie den vorgefertigten Power BI Bericht anpassen.

Veröffentlichen von Metrikdaten zur Überwachung von Metrikdaten im Compliance-Manager

Aktualisieren Sie für die benutzerdefinierte Metrik die translate_metrics_output_for_CM_config.json , indem Sie ein Objekt für die benutzerdefinierte Metrik mit diesen Details hinzufügen:
- metricName: Name der Metrik.
- metricExtractDataPath: Name des zu erstellenden Metrikordners im Ordner ReportingData/year im Ordner ComputedESGMetrics_LH Lakehouse, der die übersetzte JSON-Datei für die Metrik enthält.
  
  Anmerkung
  
  Sonderzeichen oder Leerzeichen werden in metricExtractDataPath nicht unterstützt.
- DisclosureRequirements: Bezeichnung der Offenlegungspflicht (Verbesserungsmaßnahme) in der CSRD-Vorlage Compliance Manager. Der Compliance Manager kann diesen Wert lesen und die Messdaten der richtigen Verbesserungsmaßnahme in der CSRD-Bewertung des Compliance Managers zuordnen.
- Spalten: Spalte Anzeigename für jede der Metrikspalten, die benutzerfreundliche Spaltennamen für Metrikdaten in nachgelagerten Anwendungen anzeigt.
Wenn die Konfiguration aktualisiert wird, führen Sie das Notebook TranslateOutputOfMetricsForCM_INTB mit diesen Parametern aus:
- metric_names: Name der generierten benutzerdefinierten Metrik.
- Reporting_period: Berichtsjahr für die Messdaten.
- num_previous_years: Anzahl der Daten der Vergleichsjahre, die zusammen mit den Daten zum Reporting_period gesendet werden müssen.

Nachdem das Notebook ausgeführt wurde, sind die Messdaten als JSON-Dateien im Ordner ReportingData des Dateiabschnitts in ComputedESGMetrics.json verfügbar. Sie können jetzt die veröffentlichten Messdaten im Compliance Manager mithilfe des Sustainability-Datenconnectors aufnehmen.