Metrische gegevens maken

Artikel
12/19/2024

Belangrijk

Een gedeelte van of alle functionaliteit is beschikbaar als onderdeel van een preview-release. De inhoud en functionaliteit zijn aan verandering onderhevig.

U kunt de mogelijkheden voor het definiëren en berekenen van aangepaste statistieken uitbreiden door hetzelfde patroon te volgen als voor vooraf gedefinieerde statistieken.

Geaggregeerde tabellen genereren

Afhankelijk van de metriek die u wilt berekenen, zijn beide van de volgende scenario's van toepassing. Volgen de stappen voor het scenario dat op u van toepassing is.

Scenario 1

De vooraf samengestelde totaaltabel ondersteunt de vereiste meetgegevens in de vereiste set dimensies. U hoeft dus geen wijzigingen aan te brengen in de totaaltabel.

Genereer de vooraf gebouwde aggregatietabel zoals uitgelegd in Aggregatietabellen genereren.
Vernieuw het semantische model DatasetForMetricsMeasures_DTST .

Scenario 2

De vooraf gebouwde geaggregeerde tabellen ondersteunen de vereiste meetgegevens, maar de vereiste dimensie ontbreekt.

Voeg de vereiste dimensie toe aan de vooraf samengestelde geaggregeerde tabel door de rekenlogica in het notitieboek met de rekenlogica van de geaggregeerde tabel bij te werken. Als de berekeningslogica van de tabel EmissionsAggregate bijvoorbeeld moet worden bijgewerkt, werkt u de logica bij in CreateAggregateForEmissionsMetrics_INTB.
Voer het notebook uit met bijgewerkte rekenlogica om de geaggregeerde tabel te genereren.

Notitie

Verwijder geen bestaande dimensies uit het vooraf samengestelde aggregaat om te voorkomen dat de vooraf samengestelde metrische berekening wordt beïnvloed.
Werk de geaggregeerde tabel bij in het semantische model DatasetForMetricsMeasures_DTST :
1. Download het DatasetForMetricsMeasures_DTST semantische model van de werkruimtepagina en open het model in Power BI Desktop.
2. Klik met de rechtermuisknop op de bijgewerkte geaggregeerde tabel en selecteer Power BI DesktopQuery bewerken om de editor te openen. Power Query
3. Open in de Power Query Editor de Geavanceerde editor door Geavanceerde editor op het lint te selecteren.
4. Werk de querycode bij om de nieuwe kolom op te nemen in alle stappen waarin naar kolommen wordt verwezen. Pas indien nodig de foutverwerking voor de nieuwe kolom aan. Selecteer Gereed.
5. Selecteer Vernieuwen preview om de bijgewerkte gegevens te bekijken. Nadat u dit hebt bevestigd, selecteert u Sluiten & Apply om de wijzigingen toe te passen op het gegevensmodel.
6. Sla het bijgewerkte Power BI bestand op met de toegevoegde maatregelen en schemawijzigingen. Publiceer het bijgewerkte semantische model naar de doelwerkruimte in de Power BI service en overschrijf hiermee de vorige versie in de werkruimte.

Scenario 3

Vooraf samengestelde geaggregeerde tabellen ondersteunen de vereiste meetgegevens niet:

Maak een aangepaste geaggregeerde tabel door de berekeningslogica te definiëren (met behulp van vergelijkbare patronen als die voor vooraf gebouwde geaggregeerde tabellen) in een notebook.
Voer het notebook uit om de geaggregeerde tabel in de computedESGMetrics_LH lakehouse te genereren.
Voeg de aangepaste geaggregeerde tabel toe aan DatasetForMetricsMeasures_DTST:
1. Download het semantische model van de werkruimtepagina en open het model in Power BI Desktop.
2. Selecteer in Power BI Desktop OneLake data hub, selecteer Lakehouses en selecteer vervolgens in de pop-up de ComputedESGMetrics lakehouse. Selecteer de vervolgkeuzepijl op de knop Verbinden en selecteer vervolgens Verbinden tot SQL eindpunt.
3. Selecteer de aangepaste geaggregeerde tabellen die u in het semantische model wilt importeren. Selecteer Laden om de tabellen naar Power BI Desktop te brengen.
4. Stel in het venster de Verbindingsinstelling in op Importmodus om de gegevens in het model te halen en selecteer OK.
5. Wanneer de tabellen in het Gegevensvenster zijn geladen, klikt u met de rechtermuisknop op de nieuw toegevoegde tabellen en selecteert u Query bewerken om de Power Query Editor te openen.
6. Open de Geavanceerde editor in het deelvenster Query-editor om de querycode te bekijken. Voeg de benodigde code voor foutverwerking toe om onverwachte gegevensproblemen op te lossen.
  
  Standaard wordt deze code weergegeven in het query-editorvenster:
```
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>
```
  Vervang deze query door de volgende code en breng de nodige wijzigingen aan op basis van de tabel en kolommen in uw aangepaste geaggregeerde tabel:
```
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. Om de wijzigingen op te slaan, selecteert u Gereed.
8. Om de wijzigingen toe te passen, selecteert u Sluiten & Toepassen in Power Query Editor.
9. Voeg in de Model weergave indien nodig Relaties toe tussen de nieuw toegevoegde tabellen.
10. Sla het bijgewerkte Power BI Desktop bestand op. Publiceer het model naar de werkruimte in de Power BI service door Bestand > Publiceren > Publiceren naar Power BI te selecteren en de doelwerkruimte te kiezen. Met deze actie wordt het bestaande semantische model in de werkruimte overschreven zonder de ID van het model te wijzigen.

Maak een andere Power BI maatstaf voor het berekenen van de aangepaste metriek

Zoals vermeld in Metrische gegevens berekenen en opslaan, wordt de berekening van ESG-metrieken gespecificeerd in termen van Power BI meting, filters en dimensies.

U kunt de lijst met vooraf gemaakte metingen doornemen en controleren of u bestaande metingen opnieuw kunt gebruiken voor het berekenen van de aangepaste metriek. Als u een bestaande maatregel kunt hergebruiken, kunt u deze stap overslaan.

Als u een bestaande meting niet kunt gebruiken, maakt u een andere Power BI meting in de DatasetForMetricsMeasures_DTST.

Selecteer het semantische modelitem DatasetForMetricsMeasures_DTST in de lijstweergave van de werkruimte.
Selecteer Open data model op de pagina met semantische modellen.

Notitie

Als Open data model grijs is, navigeert u naar de instelling Werkruimte. Open Power BI/Algemeen en schakel de instelling gebruikers kunnen gegevensmodellen bewerken in de Power BI service (preview) in.
Selecteer ESG_Measures in het Data zijpaneel en selecteer vervolgens Nieuwe meting om een meting te maken.
Werk de naam van de maatregel bij en voeg vervolgens de rekenlogica toe in de vorm van DAX-query's (Data Analysis Expressions). Voor meer informatie over Power BI maatregelen, maakt u maatregelen voor gegevensanalyse in Power BI Desktop de Power BI documentatie.

Een metrische definitie maken

U kunt de metrische definitie maken met behulp van de vooraf gebouwde hulpprogrammafunctie create_metric_definition() . Ga naar create_metric_definition voor meer informatie over deze functie.

Geef in de functieparameter de metrische eigenschappen op als een JSON-bestand. U wilt bijvoorbeeld het waterverbruik per locatie berekenen voor locaties in gebieden met een hoog en extreem hoog waterrisico. De vooraf ingestelde metriek geeft alleen het totale waterverbruik weer voor gebieden met een waterrisico, maar biedt geen uitsplitsing per faciliteit. U kunt een aangepaste metrische definitie voor het totale waterverbruik in gebieden met een waterrisico per faciliteit maken met de volgende code: fragment.

%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"
                ]
            }
        })

Wanneer de functie succesvol wordt uitgevoerd, wordt de metrische definitie toegevoegd als een rij in de tabel MetricsDefinitions in de ComputedESGMetrics_LH lakehouse.

Notitie

De metrische naam voor elke metrische waarde moet uniek zijn. Als u een aangepaste metriek maakt met een naam die overeenkomt met de naam van een bestaande metriek in de tabel MetricsDefinitions , treedt er een fout op in de functie.
In het JSON-bestand met de metriekdefinitie kunt u het opgeven van de filter- en labeleigenschappen overslaan als u deze niet nodig hebt voor uw aangepaste metriek.

Metrische gegevens genereren en opslaan

Gebruik dezelfde stappen als die voor vooraf gebouwde statistieken voor het genereren en opslaan van metrische gegevens. Geef de aangepaste metrische naam die u in de vorige stap hebt gemaakt, op in de parameter metric_names .

Metrische gegevens gebruiken

Wanneer de aangepaste metrische gegevens beschikbaar zijn in de tabel ComputedESGMetrics , kunt u de gegevens voor deze scenario's gebruiken:

Visualiseer en analyseer aangepaste metrische gegevens

U kunt aangepaste metrische gegevens visualiseren en analyseren in het vooraf gebouwde Power BI dashboard met behulp van de stappen in Metrische gegevens visualiseren en analyseren.

Als de aangepaste metriek naast de rapportageperiode en de naam van de meeteenheid nog meer dimensies heeft, kan het vooraf gebouwde dashboard de visualisatie voor één andere dimensie als slicer en twee andere dimensies als meerregelig filter verwerken.

U kunt de dimensies van de metrische tabel die in aanmerking moeten worden genomen voor de slicer en het filter met meerdere regels, opgeven in het bestand translate_metrics_output_for_report_config.json .

U maakt bijvoorbeeld Disaggregatie van broeikasgasemissies – per land als een aangepaste metriek met deze kolommen:

Weergegeven als
Land
Scope
Boekhoudmethode
Rapportageperiode
Naam van de maateenheid

Om deze metriek op het vooraf gebouwde dashboard te visualiseren, kunt u de gegevens in de configuratie als volgt opgeven:
```
{
         "metric_name": "Disaggregation of GHG emissions - by country",
         "dimensions_for_multiple_lines": [
             "Scope",
             "AccountingMethod"
         ],
         "dimension_for_slicer": "CountryOrRegion"
}
```
Met fragment wordt de dimensie LandOfRegio toegevoegd als een slicer op het dashboard. De dimensies Scope en AccountingMethod worden samengevoegd met een onderstrepingsteken (_) en vervolgens toegevoegd als basisfilter (of filter met meerdere regels) op het dashboard.
Nadat de configuratie is bijgewerkt, kunt u dezelfde stappen uitvoeren als hier zijn aangegeven voor het visualiseren van gegevens van vooraf samengestelde statistieken. TranslateOutputOfMetricsForReport_INTB notitieboek.
Vernieuw het semantische model DatasetForMetricsDashboard_DTST .
Open het item DashboardForMetrics_RPT . U vindt de aangepaste metriek op een van de vier tabbladen, op basis van het duurzaamheidsgebied dat aan de metriek is gekoppeld.

Notitie

Als het duurzaamheidsgebied is opgegeven als een andere waarde dan Klimaatverandering, Sociaal, Bestuur, Water en mariene hulpbronnen of Hulpbronnengebruik en circulaire economie, moet u het vooraf samengestelde Power BI rapport aanpassen.

Metrische gegevens publiceren voor het controleren van metrische gegevens in Compliance Manager

Voor de aangepaste metriek werkt u translate_metrics_output_for_CM_config.json bij door een object voor de aangepaste metriek toe te voegen met de volgende details:
- metricName: Naam van de metriek.
- metricExtractDataPath: Naam van de metrische map die moet worden gemaakt in de map ReportingData/year in de map ComputedESGMetrics_LH lakehouse, met daarin het vertaalde JSON-bestand voor de metrische gegevens.
  
  Notitie
  
  Speciale tekens of spaties worden niet ondersteund in metricExtractDataPath.
- disclosureRequirements: Naam van de openbaarmakingsvereiste (verbeteringsactie) in de CSRD-sjabloon Compliance Manager. Compliance Manager kan deze waarde lezen en metrische gegevens koppelen aan de juiste verbeteractie in de Compliance Manager CSRD-beoordeling.
- Kolommen: Kolom weergavenaam voor elk van de metrische kolommen, die gebruiksvriendelijke kolomnamen voor metrische gegevens in downstream-toepassingen weergeeft.
Wanneer de configuratie wordt bijgewerkt, voert u de notebook TranslateOutputOfMetricsForCM_INTB uit met de volgende parameters:
- metric_names: Naam van de gegenereerde aangepaste statistiek.
- reporting_period: Rapportagejaar voor de metrische gegevens.
- num_previous_years: Aantal vergelijkende jaren dat samen met de reporting_period gegevens moet worden verzonden.

Nadat het notebook is uitgevoerd, zijn de metrische gegevens als JSON-bestanden beschikbaar in de map ReportingData van de sectie bestanden in ComputedESGMetrics.json. U kunt nu de gepubliceerde metrische gegevens in Compliance Manager opnemen met behulp van de Sustainability-gegevensconnector.