Gebruik gegevens duurzaamheidsprogramma in Query

Vanuit Wdata kunt u query's maken op basis van gegevens in Duurzaamheidsprogramma, inclusief:

Onderwerpen, statistieken, waarden en taken
Aangepaste afmetingen beschikbaar voor metrische waarden
Aangepaste tags beschikbaar voor statistieken

Met deze zoekopdrachten kunt u:

Verken uw duurzaamheidsgegevens door een gerichte lens, met behulp van filters en parameters.
Verbind de resultaten met een Spreadsheet, bijvoorbeeld om duurzaamheidsgegevens naar een bestand te exporteren of om bronkoppelingen naar rapportoutputs te bieden.
Bied extra context voor tags of dimensies van metrics.

Programma als querybron toevoegen

Om de gegevens van een programma in een query te gebruiken:

From the query's Sources panel, click Add sources, and select Add program data.
Klik in het paneel Bronnen van de query op Nieuwe bron en selecteer de gegevens die u in de resultaten wilt opnemen:
- Als u gegevens over een programma en de onderwerpen, meetgegevens, waarden of taken ervan wilt opnemen, selecteert u Duurzaamheid, Duurzaamheidsprogramma.
- Als u gegevens wilt opnemen over de aangepaste dimensies die beschikbaar zijn voor de metrische waarden van een programma, selecteert u Duurzaamheid, Programmadimensies.
- Om gegevens op te nemen over de aangepaste tags die beschikbaar zijn voor de statistieken van een programma, selecteert u Duurzaamheid, Programmatags.
Tip: Voor extra context rond de dimensies of tags van de statistieken van een programma voegt u de gegevens van het programma en de gegevens van de dimensies of tags toe als bronnen en maakt u een relatie om ze te verbinden.
Zoek en selecteer het programma dat u in de query wilt gebruiken en klik op Toevoegen.

Geef in het paneel Sources aan hoe de gegevenskolommen in de query moeten worden gebruikt:

Als u kolommen als resultaten wilt gebruiken in Builder, selecteer ze dan en selecteer Toevoegen aan velden of sleep ze naar het tabblad Velden.

Om kolommen als filters te gebruiken in Builder, selecteert u ze en selecteert u vervolgens Toevoegen aan filters of sleept u ze naar het tabblad Filters.

Bijvoorbeeld, voor een query met een Duurzaamheidsprogramma bron:

Filter	Geeft als resultaat
Programmajaar	Alleen waarden verzameld voor specifieke jaren
Afmetingen	Alleen statistieken met specifieke aangepaste dimensies toegepast, en de verzamelde waarden voor die dimensies
Taakstatus	Alleen taken met specifieke gegevensverzamelingsstatussen

Om een kolom op te nemen in de verklaring van de query in SQL, klikt u er met de rechtermuisknop op en selecteert u Toevoegen aan query.

Maak de query zoals nodig.

Bron kolommen

Wanneer u Programmagegevens als bron toevoegt, kunt u de gegevenskolommen ervan opnemen in de queryresultaten.

Wanneer u Programmagegevens toevoegen als bron kiest, kan de query deze kolommen bevatten:

Kolom	Beschrijving	type
Naam programma	De naam van het programma	Tekst
Programmajaar	Het jaar van de programmagegevens	Geheel getal
Metrische naam	De naam van een metriek binnen een Programmathema	Tekst
Metrische code	De unieke identificatie die voor een metriek wordt gegenereerd	Tekst
Metrisch type	Het type waarde dat voor een metriek wordt verzameld - Tekst, Valuta, Getal, Procent of Datum	Tekst
Metrische beschrijving	De ingevoerde beschrijving voor een metriek	Tekst
Afmetingen	De aangepaste dimensie naam en waarde toegepast op een metrische waarde, zoals `{"Location":"South"}` Tip: Als uw statistieken meerdere dimensies ondersteunen, kunt u de velden Dimensienaam en Dimensiewaarde gebruiken om aparte kolommen voor dimensienamen en -waarden te retourneren.	Tekst
Waarde-tekst	De ingevoerde waarde voor een metriek, als tekst	Tekst
Waarde-nummer	De ingevoerde kwantitatieve waarde voor een metriek, als een getal	Decimaal
Unit	Voor een metriek met als type Valuta, Getal of Procent, de meeteenheid	Tekst
Ondersteunende bijlagen	De bestandsnamen van bijlagen die zijn geüpload voor een metrische waarde Opmerking: Als een waarde meerdere bijlagen heeft, worden hun bestandsnamen weergegeven als een door komma's gescheiden lijst. De resultaten bevatten alleen geüploade bijlagen; er verschijnen geen Workiva bestanden of webadressen.	Tekst
Bron	Hoe een metrische waarde wordt opgegeven: Handmatig, indien rechtstreeks ingevoerd in de metriek Aangesloten bron, indien van een aangesloten spreadsheet of document Taak, indien van Workiva Taken	Tekst
Bronbestand	Voor een metriek met een gekoppeld bronbestand wordt de naam van het bronbestand	Tekst
Bron sectie	Voor een metric met een gekoppeld bronbestand, de naam van de sectie in het bronbestand waar de waarde verschijnt	Tekst
Kaders	Alle gerelateerde Sustainability Explorer inhoud waarnaar een metric verwijst Tip: Om gekoppelde inhoud aan te vullen met extra details van Sustainability Explorer, voeg Sustainability Explorer toe als een querybron.	Tekst
Taaknaam	De naam van een gegevensverzamelingstaak die is gemaakt voor de waarde van een metriek	Tekst
Taak toegewezen	De gebruikersnaam van het werkruimte-lid dat een taak toegewezen heeft gekregen om de waarde van de metriek te verzamelen Opmerking: Als een waarde meerdere geadresseerden heeft, worden deze weergegeven als een door komma's gescheiden lijst, zoals `homer@org.com,marge@org.com`. Als uw zoekopdracht alleen één lid voor meerdere gevolmachtigden oplevert, neem dan contact op met uw Workiva Customer Success Manager (CSM).	Tekst
Taak goedkeurder	De gebruikersnaam van het lid van de werkruimte waaraan een taak is toegewezen om de verzamelde waarde voor een metriek goed te keuren Als een waarde meerdere goedkeurders of goedkeuringsstappen heeft: Een komma (,) scheidt de goedkeurders die zijn geselecteerd voor een specifieke stap, zoals `homer@org.com,marge@org.com` Een pijp (\|) scheidt de goedkeurders die voor elke stap zijn geselecteerd - zoals `homer@org.com, marge@org.com \| bart@org.com, lisa@org.com` - in volgorde van goedkeuring	Tekst
Taakvervaldatum	De vervaldatum voor de gegevensverzamelingstaak van een waarde	Datum
Taak goedkeurder vervaldatum	De vervaldatum voor de goedkeuringstaak van een waarde Tip: Als een waarde meerdere goedkeuringsstappen heeft , is dit de uiterste datum voor de uiteindelijke goedkeuring.	Datum
Taakstatus	De algemene status van de gegevensverzameling van een waarde, zoals Niet gestart, In uitvoering of Voltooid	Tekst
Taakinstructies	De instructies die zijn ingevoerd voor de ontvanger en goedkeurder van een metrische waarde	Tekst
Notities	Eventuele opmerkingen die voor een metriek zijn ingevoerd, zoals voor voetnoten	Tekst
Onderwerp	De naam van een onderwerp binnen het programma	Tekst
Onderwerp pad	Waar een onderwerp voorkomt in het overzicht van het programma, zoals `["Klimaat", "Broeikasgassen", "Directe broeikasgasemissies"]`	Tekst
Aangepaste tags	Alle aangepaste tags toegepast op een onderwerpmetriek	Tekst
Verslagjaar	Het rapportagejaar van de metrische waarden van het programma	Geheel getal
Begin rapportageperiode	De beginmaand van de rapportageperiode van de metrische waarden van het programma; bijvoorbeeld `1` voor een jaarwaarde, of `10` voor een kwartaalwaarde Q4	Geheel getal
Einde verslagperiode	De eindmaand van de rapportageperiode van de metrische waarden van het Programma; bijvoorbeeld `12` voor een jaarwaarde of een Q4 kwartaalwaarde	Geheel getal
Bron locatie	Voor een waarde met een verbonden bron-spreadsheet, zijn de coördinaten van de cel	Tekst
Naam dimensie	Voor een waarde waarop een dimensie is toegepast, wordt de naam van de dimensie Opmerking: Als uw metriek meerdere dimensies ondersteunt, kan de query tot zeven velden Dimension name bevatten - één voor elke dimensie die mogelijk is voor een metriek. De positie van een dimensie - zoals in Dimensie 1 naam, Dimensie 2 naam, enzovoort - weerspiegelt de volgorde ervan in het Configureer metriek paneel.	Tekst
Dimensiewaarde	Voor een waarde met een toegepaste dimensie, is de dimensionale waarde Opmerking: Als uw metriek meerdere dimensies ondersteunt, kan de query tot zeven velden Dimensiewaarde bevatten - één voor elke dimensie die mogelijk is voor een metriek. De positie van een dimensie - zoals in Dimensie 1 waarde, Dimensie 2 waarde, enzovoort - weerspiegelt de volgorde ervan in het Configureer metriek paneel.	Tekst

Opmerking: Het is mogelijk dat uw werkruimte nog geen ondersteuning biedt voor meerdere afmetingen voor metrische waarden. Blijf kijken!

Wanneer u Programmadimensiegegevens toevoegen als bron selecteert, kan de query deze kolommen bevatten:

Kolom	Beschrijving	type
Naam dimensie	De naam van een aangepaste dimensie die is ingesteld voor het programma, zoals Locatie of Geslacht	Tekst
Waarde ID	De unieke ID die is toegewezen aan de waarde van een dimensie, zoals IA of NB	Tekst
Naam waarde	De volledige naam van de waarde van een dimensie, zoals Iowa of Non-binair	Tekst
Dimensie status	Of een dimensie actief of inactief is	Tekst

Wanneer u select Programmatag gegevens als bron toevoegt, kan de query deze kolommen bevatten:

Kolom	Beschrijving	type
Tag naam	De naam van een aangepaste tag die is ingesteld voor het programma	Tekst
Tag-waarde	De naam van de waarde van de tag	Tekst

Voeg programmagegevens samen met dimensie- of taggegevens

Voor extra context rond de dimensies of tags van een programma voegt u de gegevens van het programma en de dimensies of tags toe als bronnen, en dan maakt u een relatie om ze te verbinden.

Bijvoorbeeld om context op te nemen rond de dimensies van een Programma:

Selecteer in Bronnen, Duurzaamheidsprogramma en Programmadimensies, en kies voor beide hetzelfde programma.
Voeg in Velden de kolommen toe die u van elke bron wilt opnemen.

Vermeld op zijn minst:
- Afmetingen van de programmagegevens
- Waarde ID van de afmetingen
Voeg in Relaties een linker join toe:
- Selecteer in de linkerbron Berekend veld en pas vervolgens een berekening toe op basis van de kolom Afmetingen in het paneel Veldeigenschappen :
```
JSON_FORMAT(JSON_ARRAY_GET(JSON_EXTRACT(JSON_PARSE( {1} ), '$.*'), 0)
```
  Tip: U kunt snel de JSON functies aan de berekening toevoegen vanuit het menu Formule .
- Selecteer in de rechterbron het veld Value ID van de dimensie.
Klik op Opslaan.

Kolommen opnemen voor specifieke frameworks of tags

Wanneer u een programma als querybron gebruikt, kunt u kolommen opnemen voor alle frameworkreferenties en aangepaste tags die op de metriek zijn toegepast. Voor de duidelijkheid kunt u berekeningen toepassen om in plaats daarvan kolommen voor alleen specifieke kaders of tags op te nemen.

Kaders
Labels

Wanneer u de kolom Frameworks in een query opneemt, worden alle frameworkreferenties weergegeven die op de metriek zijn toegepast. Bijvoorbeeld:

Kaders
"gri_2020": ["305", "305-1"], "sasb_2021": ["EM-CM-110a", "EM-CM-110a.1"]

Voor de duidelijkheid kunt u in plaats daarvan een aparte kolom opnemen voor de referenties van een raamwerk, zoals:

GRI	SASB
["305", "305-1"]	["EM-CM-110a", "EM-CM-110a.1"]

Om een kolom voor de referenties van een framework in de resultaten van een query op te nemen, past u deze berekening toe:

Klik in het paneel Bronnen met de rechtermuisknop op Berekening en selecteer Toevoegen aan velden.
Selecteer onder Velden, Berekening.
Voer in het paneel Veldeigenschappen de kolomkop van de berekening in de queryresultaten in, zoals "SASB" voor verwijzingen naar Sustainability Accounting Board Standards (SASB).
Klik in het paneel Sources met de rechtermuisknop op de kolom Frameworks van het bronprogramma en selecteer Include in calculation.
Voer in het paneel Veldeigenschappen de berekening in:
```
 JSON_EXTRACT({[veld]}, "$.[kader]") 
```
- Vervang [veld] door het nummer van de kolom Kaders onder Inclusief kolommen, zoals 1.
- Vervang [framework] door de naam en versie van het framework van de referenties die u wilt opnemen, zoals sasb_2021.
Klik op Toepassen.

Wanneer u de kolom Aangepaste tags in een query opneemt, worden alle tagwaarden weergegeven die op de metriek zijn toegepast. Bijvoorbeeld:

Aangepaste tags
{"CDP": ["C5.1", "C4.1a"],"Location": ["Ames", "Denver"]}

Voor de duidelijkheid kunt u in plaats daarvan een aparte kolom voor een tag opnemen, zoals:

CDP	Locatie
["C5.1", "C4.1a"]	["Ames", "Denver"]

Om een kolom voor de waarden van een aangepaste tag op te nemen in de resultaten van een query, past u deze berekening toe:

Klik in het paneel Bronnen met de rechtermuisknop op Berekening en selecteer Toevoegen aan velden.
Selecteer onder Velden, Berekening.
In het paneel Veldeigenschappen voert u de kolomkop van de berekening in de queryresultaten in, zoals "CDP" voor metriek getagd met CDP-vragenlijstitems.
Klik in het paneel Bronnen met de rechtermuisknop op de kolom Aangepaste tags van het bronprogramma en selecteer Opnemen in berekening.
Voer in het paneel Veldeigenschappen de berekening in en vervang [tag] door de naam van de aangepaste tag van de waarden die u wilt opnemen, zoals CDP.
```
 JSON_EXTRACT({[field]}, '$["tag"]') 
```
Tip: Om de dubbele aanhalingstekens uit tag-waarden in de query-resultaten te verwijderen, voegt u de verklaring W_JSON_ARRAY_JOIN toe. W_JSON_ARRAY_JOIN( JSON_EXTRACT( {[field]} , '$["tag"]'), ',')).
Klik op Toepassen.

Vraagbronnen voor programma's bijwerken

Als het programma evolueert en nieuwe functies introduceert, moet u mogelijk de querybron bijwerken om alle gerelateerde kolommen op te nemen.

Tip: Wanneer een programma nieuwe kolommen heeft om op te nemen, geeft de querybron een waarschuwing weer in Bronnen.

Om de querybron van een programma bij te werken:

In Bronnen, klik met de rechtermuisknop op de bron en selecteer Bron verwijderen.
Voeg het Programma weer als bron toe.
Bewerk de query zo nodig om de kolommen van het programma op te nemen.

Ondersteuning

Community

Workiva-ondersteuningscentrum