Download koolstofvoetafdrukgegevens van Watershed® voor duurzaamheidsrapportage

Met het klimaatplatform van Watershed kunt u de CO2-voetafdruk van uw organisatie meten, rapporteren en verminderen.

Met het Workiva Platform kunt u ketens bouwen om automatisch CO2-voetafdrukgegevens uit Watershed te downloaden - bijvoorbeeld voor openbaarmaking in uw Environment, Social, and Governance (ESG) of duurzaamheidsrapportage - in een tabel, gebaseerd op een tijdsperiode die is opgegeven in een aangepaste Watershed spreadsheet. U kunt de tabel dan gebruiken als bron voor een query of spreadsheetverbinding, bijvoorbeeld om de gegevens op te nemen in rapportages.

Opmerking: Hoewel u in deze instructies meerdere ketens bouwt, voert u slechts één keten uit - die vervolgens automatisch de andere uitvoert - om gegevens van Watershed te downloaden en de spreadsheet bij te werken.

Opmerking: De Watershed spreadsheet die door deze ketens wordt gebruikt, wordt geleverd door Workiva. Als u dit niet hebt, maar wel geïnteresseerd bent, neem dan contact op met uw Customer Success Manager voor meer informatie.

Vereisten

Om deze kettingen te maken, hebt u deze connectors nodig:

Tip: Alle opdrachten van de ketens gebruiken de standaard CloudRunner. Er zijn geen GroundRunners nodig.

Identificeer ook om de ketens met succes uit te voeren:

De sleutel voor de activity provider om te gebruiken om te authenticeren met en acties uit te voeren met de Watershed API
De ID's van het werkblad Watershed , de sectie Controleblad en de bijbehorende tabel

Bouw een ketting om gegevensdownloads te loggen

Bouw om te beginnen een keten om het gedeelte Controleblad bij te werken om bij te houden wanneer gegevens over de CO2-voetafdruk naar Workiva worden geüpload.

Stap 1. Creëer de ketting

Ga naar Ketens, klik op Maken, en selecteer Keten maken.
In Setup, voert u een naam in van 3. Watershed en een beschrijving om aan te geven dat de keten de uploads van Watershed-gegevens registreert.
Klik op Opslaan.

Stap 2. Begin met een gebeurtenis Runtime Inputs

Van Ketengebeurtenissen, verplaatst u Runtime-ingangen naar Start.
Selecteer de gebeurtenis Runtime-ingangen en klik op bewerken.
Voer in Basisinfo een naam en beschrijving in om de gebeurtenis te helpen identificeren.
In Variables, voegt u TextField-ingangen toe met deze weergavenamen:
- Bereik
- WerkbladID
- BladID
Tip: Laat de standaardwaarden van deze variabelen leeg; ze worden gegenereerd wanneer u 1 uitvoert. Watershed keten later gecreëerd.
Selecteer Vereist voor alle drie variabelen en klik op Opslaan.

Stap 3. Een bestand toevoegen Opdracht Bestand maken met hulpprogramma's

Om het logbestand voor de sectie Control Sheet (Controleblad) te maken, voegt u een opdracht File Utilities (Bestandsfuncties) Create file (Bestand maken) toe:

Ga naar Beschikbare connectors, selecteer Bestand Hulpprogramma's, en verplaats Bestand maken naar het canvas.
Sleep een koppeling van Runtime-ingangen naar Bestand maken.
Selecteer de opdracht Bestand maken en klik op Bewerken.
Voer in Basisinfo een naam en beschrijving in om de opdracht te helpen identificeren.

Voer de eigenschappen van de opdracht in en klik op Opslaan:

Eigendom	Waarde
Verbindingen	Selecteer de connector Bestandshulpprogramma's die u wilt gebruiken.
Tekst	Voer `Footprint-gegevens in die het laatst zijn vernieuwd op`, en selecteer de System.DateTime runtime variabele.

Stap 4. Een opdracht Workiva Write Sheet Data toevoegen

Om de sectie Control Sheet bij te werken met het logbestand, voegt u een Workiva Write sheet data opdracht toe:

Selecteer op Beschikbare connectors, Workiva, en verplaats Schrijf bladgegevens naar het canvas.
Sleep een koppeling van Bestand maken naar Bladgegevens schrijven.
Selecteer de opdracht Bladgegevens schrijven en klik op Bewerken.
Voer in Basisinfo een naam en beschrijving in om de opdracht te helpen identificeren.

Voer de eigenschappen van de opdracht in en klik op Opslaan:

Eigendom	Waarde
Verbindingen	Selecteer de Workiva-connector die u wilt gebruiken.
Spreadsheet-ID	Selecteer de SpreadsheetID runtime-invoer van Trigger.
Blad-ID/naam	Selecteer de SheetID runtime-invoer van Trigger.
Gegevensbestand	Selecteer de uitvoer Bestand maken van de opdracht Bestand maken.
Scheidingsteken	Voer een komma in (`,`).
Regio	Selecteer de runtime-invoer Bereik van Trigger.

Klik op Publiceer, voer een opmerking over de publicatie in en klik op Publiceer.

Bouw ketens van de sjabloon Gegevens laden naar Wdata

Gebruik vervolgens de sjabloon Load Data to Wdata om ketens te bouwen om de gekoppelde tabel van Watershed spreadsheet bij te werken met de gegevens die u van Watershed hebt gedownload. De sjabloon Load Data to Wdata maakt ketens die samenwerken om te bepalen of de dataset al in de tabel bestaat en de tabel bij te werken met de nieuwste dataset.

Om de ketens te maken van Sjablonen, opent u de sjabloon Gegevens laden naar Wdata | Primaire keten en klikt u op Nieuwe keten.

Bouw een keten om gegevens van Watershed te downloaden

Bouw ten slotte een keten om CO2-voetafdrukgegevens uit Watershed te downloaden en te importeren.

Opmerking: Maak de andere twee ketens vóór deze, voor de Run-keten gebeurtenissen.

Stap 1. Creëer de ketting

Ga naar Ketens, klik op Maken, en selecteer Keten maken.
In Setup, voert u een naam in van 1. Watershed en een beschrijving om de keten verder te identificeren.

Voeg in Variabelen variabelen toe voor de Watershed API-sleutel en de ID's van de Watershed-spreadsheet en het bijbehorende controleblad.

Naam	Waarde
APIKey	Voer de Watershed API-sleutel in.
Spreadsheet-ID	Voer het ID van de watershed-spreadsheet in.
BladID	Voer het ID van het Controleblad gedeelte van de Watershed-spreadsheet in.

Klik op Opslaan.

Stap 2. Begin met een Workiva Get Sheet Data opdracht

Begin met een Workiva Get sheet data opdracht om de te downloaden gegevens te identificeren, gebaseerd op de tijdsperiode in de spreadsheet van Watershed Control sheet:

Van Beschikbare connectors, selecteer Workiva, en verplaats Get sheet data naar Start.
Selecteer de opdracht Get sheet data en klik op Edit.
Voer in Basisinfo een naam en beschrijving in om de opdracht te helpen identificeren.

Voer de eigenschappen van de opdracht in en klik op Opslaan:

Eigendom	Waarde
Verbindingen	Selecteer de Workiva-connector die u wilt gebruiken.
Spreadsheet-ID	Selecteer de ketenvariabele Spreadsheet ID.
Blad-ID/naam	Selecteer de ketenvariabele Sheet ID.
Regio	Voer `A11 in:`.
Waardevolle stijl	Selecteer Berekend.
Herziening	Om zeker te zijn van de laatste versie voert u `-1` in.

Stap 3. Opdrachten toevoegen om de tijdsperiode voor Watershed voor te bereiden

Om de tijdsperiode voor Watershed te identificeren, voegt u Geavanceerde query en CSV toe aan JSON opdrachten:

Ga naar Beschikbare connectors, selecteer Tabulaire transformatie, en verplaats Geavanceerde query naar het canvas.
Sleep een koppeling van Bladgegevens ophalen naar Geavanceerde query.
Selecteer de opdracht Geavanceerde query en klik op Bewerken.
Voer in Basisinfo een naam en beschrijving in om de opdracht te helpen identificeren.

Voer de eigenschappen van de opdracht in en klik op Opslaan:

Eigendom	Waarde
Verbindingen	Selecteer de Tabular Transformation-connector die u wilt gebruiken.
Tabellen	Voeg de tabel voor de periodegegevens toe: Selecteer in Bestand de uitvoer Gegevens van de opdracht Bladgegevens ophalen. In Tabelnaam, voert u `een` in.
Query	Voer de uit te voeren query in: select case when `Start Month` = 'January' then '01' when `Start Month` = 'February' then '02' when `Start Month` = 'March' then '03' when `Start Month` = 'April' then '04' when `Start Month` = 'May' then '05' when `Start Month` = 'June' dan "06" wanneer `Beginmaand` = 'Juli' dan "07" wanneer `Beginmaand` = 'Augustus' dan "08" wanneer `Beginmaand` = 'September' dan "09" wanneer `Beginmaand` = 'Oktober' dan "10" wanneer `Beginmaand` = 'November' dan "11" anders "12" einde als "sm", case when `Eindmaand` = 'Januari' then '01' when `Eindmaand` = 'Februari' then '02' when `Eindmaand` = 'Maart' then '03' when `Eindmaand` = 'April' then '04' when `Eindmaand` = 'Mei' then '05' when `Eindmaand` = 'Juni' then 06" wanneer `Eindmaand` = "Juli" dan "07" wanneer `Eindmaand` = "Augustus" dan "08" wanneer `Eindmaand` = "September" dan "09" wanneer `Eindmaand` = "Oktober" dan "10" wanneer `Eindmaand` = "November" dan "11" anders "12" einde als "em", `Rapportagejaar` als 'ry', TableId als 'tid' uit a
Scheidingsteken voor invoer	Selecteer Komma.
Uitgangsbegrenzer	Selecteer Komma.
Voorbeeld resultaten	Schakel dit selectievakje in.

Op Beschikbare connectors, selecteert u JSON, en verplaatst u CSV naar JSON naar het canvas.
Sleep een koppeling van Geavanceerde query naar CSV naar JSON.
Selecteer de opdracht CSV to JSON en klik op Bewerken.
Voer in Basisinfo een naam en beschrijving in om de opdracht te helpen identificeren.

Voer de eigenschappen van de opdracht in en klik op Opslaan:

Eigendom	Waarde
Verbindingen	Selecteer de JSON-connector die u wilt gebruiken.
Invoerbestand	Selecteer de uitvoer Resultaat van de opdracht Geavanceerde query.
Scheidingsteken	Selecteer Komma (,).

Stap 4. Een HTTP Request GET opdracht toevoegen

Om gegevens over de koolstofvoetafdruk voor de geselecteerde tijdsperiode te downloaden, voegt u een HTTP Request GET opdracht toe:

Selecteer op Beschikbare connectors, HTTP Request, en verplaats GET naar het canvas.
Sleep een koppeling van CSV naar JSON naar GET.
Selecteer de opdracht GET en klik op bewerken.
Voer in Basisinfo een naam en beschrijving in om de opdracht te helpen identificeren.

Voer de eigenschappen van de opdracht in en klik op Opslaan:

Eigendom	Waarde
Verbindingen	Selecteer de HTTP Request-connector die u wilt gebruiken.
Reactie tonen	Schakel dit selectievakje in.
URL	Voer `https://api.watershedclimate.com/v1/report/footprint_detail` in.
Querystring	Voer de querystring in om de begin- en eindmaanden van de te downloaden gegevens aan te geven: Voer voor de startmaand `startMonth=` in en selecteer tweemaal het JSON-bestand uitvoer van de opdracht CSV to JSON. Voer vervolgens voor de eindmaand `&endMonth=` in en selecteer het JSON-bestand uitvoer van de opdracht CSV to JSON nog twee keer. Klik voor beide maanden op de eerste JSON-bestand uitvoer, en pas een Get variable from JSON transformatie toe: Selecteer in Uitvoer, Tekst. In Waarde, voert u `0` en `ry` in. Klik voor beide maanden op de tweede JSON-bestand uitvoer, en pas nog een Haal variabele uit JSON transformatie toe: Selecteer in Uitvoer, Tekst. In Waarde, voert u `0` en `sm` in.
Koppen	Een koptekst toevoegen: Voer in Key, `Authorization` in. In Waarde, voert u `Bearer` in en selecteert u vervolgens de ketenvariabele APIKey.
Type inhoud	Voer in `application/json`.

Stap 5. Run chain-gebeurtenissen toevoegen om de gegevensupload uit te voeren en te loggen

Om de gegevens te uploaden naar Wdata en de upload te loggen in de sectie Controleblad, voegt u Run chain events toe voor de eerder gemaakte ketens:

Van Ketengebeurtenissen, verplaats Keten uitvoeren naar het canvas.
Sleep een link van GET naar Run chain.
Selecteer de gebeurtenis Uitvoeren keten en klik op Bewerken.
Voer in Basisinfo een naam en beschrijving in om aan te geven dat de gebeurtenis de gegevens uploadt naar Wdata.
In Chain to run, selecteert u Load Data to Wdata | Primary chain die u eerder hebt gemaakt van de sjabloon Load Data to Wdata.

Voer de chain runtime inputs in en klik op Opslaan:

Ingang	Waarde
Tabel ID	Om het ID van de Wdata-tabel op te geven waarnaar de gegevens moeten worden geüpload: Selecteer het JSON-bestand uitvoer van de opdracht CSV naar JSON. Klik op de JSON-bestand uitvoer, en pas een Get variable from JSON transformatie toe: Selecteer in Uitvoer, Tekst. In Waarde, voert u `0` en `tid` in.
Bestandsvoorvoegsel	Om het voorvoegsel van de te uploaden dataset te definiëren, gebaseerd op de tijdsperiode van de gegevens: Selecteer voor de beginmaand tweemaal het JSON-bestand uitvoer van de opdracht CSV to JSON. Voer een underscore in (`_`). Selecteer voor de eindmaand nog twee keer het JSON-bestand uitvoer van de opdracht CSV to JSON. Voer `.csv`. Klik voor beide maanden op de eerste JSON-bestand uitvoer, en pas een Get variable from JSON transformatie toe: Selecteer in Uitvoer, Tekst. In Waarde, voert u `0` en `ry` in. Klik voor beide maanden op de tweede JSON-bestand uitvoer, en pas nog een Get variable from JSON transformatie toe: Selecteer in Uitvoer, Tekst. In Waarde, voert u `0` en `sm` in.
Gegevensbestand	Selecteer de uitvoer Response van de opdracht GET.
Belastingsmethode	Selecteer Dataset vervangen.
Terugdraaien	Schakel dit selectievakje in.

Van Ketengebeurtenissen, verplaats een andere Keten uitvoeren naar het canvas.
Sleep een schakel van de eerste Run ketting naar de tweede.
Selecteer de tweede gebeurtenis Run chain en klik op Edit.
Voer in Basisinfo een naam en beschrijving in om te helpen identificeren dat de gebeurtenis de upload van gegevens in de Watershed-spreadsheet logt.
In Chain om uit te voeren, selecteert u 3. Watershed eerder gemaakte keten.
Voer de chain runtime inputs in en klik op Opslaan:

Ingang Waarde

Bereik Voer F12:F12 in.

Spreadsheet-ID Selecteer de ketenvariabele SpreadsheetID.

Blad ID Selecteer de ketenvariabele SheetID.
Klik op Publiceer, voer eventuele opmerkingen over de publicatie in en klik op Publiceer.

Laat de kettingen lopen

Om de Watershed spreadsheet te vernieuwen met de meest recente CO2-voetafdrukgegevens:

Selecteer in het gedeelte Control sheet van de Watershed spreadsheet de tijdsperiode - maanden en jaar - van de gegevens die u van Watershed wilt downloaden.
Van Wdata Chains, selecteer de 1. Watershed keten, en klik op Voer uit en Voer keten uit.

Opmerking: Wanneer u deze keten uitvoert, worden automatisch de twee andere ketens uitgevoerd om de tabel Wdata en Watershed spreadsheet bij te werken met de gegevens.

Ondersteuning

Community

Workiva-ondersteuningscentrum