Watershed er en klimaplattform for bedrifter som gjør det mulig å måle, rapportere og redusere organisasjonens karbonfotavtrykk.
Med Workiva-plattformen kan du bygge kjeder som automatisk laster ned karbonavtrykksdata fra Watershed - for eksempel til bruk i ESG-rapporteringen (Environment, Social and Governance) eller bærekraftsrapporteringen - til en tabell, basert på en tidsperiode som er spesifisert i et egendefinert Watershed regneark. Deretter kan du bruke tabellen som kilde for en spørring eller regnearktilkobling, for eksempel for å inkludere dataene i rapporteringsresultater.
Merk: Selv om du bygger flere kjeder i disse instruksjonene, kjører du bare én kjede - som deretter automatisk kjører de andre - for å laste ned data fra Watershed og oppdatere regnearket.
Merk: Regnearket Watershed som brukes av disse kjedene, er levert av Workiva. Hvis du ikke har det, men er interessert, kan du kontakte din Customer Success Manager for mer informasjon.
Forutsetninger
For å bygge disse kjedene trenger du disse kontaktene:
- Workiva kontakt
- Tabular Transformation kontakt
- JSON kontakt
- HTTP-forespørsel kontakt
- File Utilities kontakt
Tips: Alle kjedekommandoene bruker standard CloudRunner. Det er ikke behov for GroundRunners.
For å lykkes med å kjøre kjedene, må du også identifisere:
- -nøkkelen som aktivitetsleverandøren skal bruke for å autentisere seg med og utføre handlinger med Watershed API
- ID-ene til Watershed regnearket, dets kontrollark seksjon, og den tilknyttede tabellen
Bygg en kjede for å logge nedlastinger av data
Til å begynne med kan du bygge en kjede for å oppdatere Control sheet for å spore når data om karbonavtrykk lastes opp til Workiva.
Trinn 1. Opprett kjeden
- Fra Kjeder, klikk på Opprett, og velg Opprett kjede.
- I Setup skriver du inn et navn på
3. Watershedog en beskrivelse som gjør det lettere å identifisere at kjeden logger opplastinger av Watershed-data. - Klikk på Lagre.
Trinn 2. Start med en Runtime Inputs-hendelse
- Fra Kjedehendelser, flytt Runtime-innganger til Start.
- Velg hendelsen Runtime inputs, og klikk på Edit.
- I Basic info angir du et navn og en beskrivelse for å identifisere hendelsen.
- I Variables legger du til TextField-innganger med disse visningsnavnene:
OmrådeRegnearkIDArkID
Tips: La standardverdiene for disse variablene stå tomme; de blir generert når du kjører 1. Watershed -kjeden ble opprettet senere.
- Velg Required for alle tre variablene, og klikk på Save.
Trinn 3. Legg til en fil med kommandoen Create File Utilities
For å opprette loggfilen for Control Sheet legger du til kommandoen File Utilities Create file:
- Velg File Utilities fra Available connectors, og flytt Create file til lerretet.
- Dra en lenke fra Runtime-innganger til Opprett fil.
- Velg kommandoen Opprett fil, og klikk på Rediger.
- I Basic info angir du et navn og en beskrivelse for å identifisere kommandoen.
- Angi kommandoens egenskaper, og klikk på Lagre:
Egenskap Verdi Kontakt Velg File Utilities-kontakten du vil bruke. Tekst Skriv inn Fotavtrykksdata sist oppdatert på, og velg kjøretidsvariabelen System.DateTime.
Trinn 4. Legg til en Workiva Write Sheet Data-kommando
For å oppdatere Control Sheet med loggfilen, legger du til en Workiva Write sheet data -kommando:
- Fra Tilgjengelige koblinger, velg Workiva, og flytt Skriv arkdata til lerretet.
- Dra en lenke fra Opprett fil til Skriv arkdata.
- Velg kommandoen Skriv arkdata, og klikk på Rediger.
- I Basic info angir du et navn og en beskrivelse for å identifisere kommandoen.
- Angi kommandoens egenskaper, og klikk på Lagre:
Egenskap Verdi Kontakt Velg hvilken Workiva-kontakt du vil bruke. Regneark-ID Velg SpreadsheetID runtime input fra Trigger. Ark-ID/navn Velg SheetID runtime input fra Trigger. Datafil Velg Opprettet fil utdata fra kommandoen Opprett fil. Skilletegn Skriv inn et komma ( ,).Region Velg Range runtime input fra Trigger. - Klikk på Publiser, skriv inn en merknad om publiseringen, og klikk på Publiser.
Bygg kjeder fra malen Last inn data til Wdata
Deretter bruker du Load Data to Wdata malen til å bygge kjeder for å oppdatere Watershed regnearkets tilknyttede tabell med dataene som er lastet ned fra Watershed. Malen Load Data to Wdata oppretter kjeder som jobber sammen for å avgjøre om datasettet allerede finnes i tabellen, og oppdaterer tabellen med det nyeste datasettet.
For å opprette kjedene fra Maler, åpne malen Load Data to Wdata | Primary chain, og klikk på Ny kjede.
Bygg en kjede for å laste ned data fra Watershed
Til slutt kan du bygge en kjede for å laste ned og importere karbonavtrykksdata fra Watershed.
Merk: Opprett de to andre kjedene før denne, for Kjør kjeden hendelser.
Trinn 1. Opprett kjeden
- Fra Kjeder, klikk på Opprett, og velg Opprett kjede.
- I Setup, skriv inn et navn på
1. Watershedog en beskrivelse som hjelper deg med å identifisere kjeden. - I Variables legger du til variabler for Watershed API-nøkkelen og ID-ene til Watershed-regnearket og kontrollarket.
Navn Verdi APIKey Skriv inn Watershed API-nøkkelen. RegnearkID Skriv inn ID-en til regnearket for nedbørsfeltet. ArkID Skriv inn ID-en til Control-arket i regnearket Watershed. - Klikk på Lagre.
Trinn 2. Start med en Workiva Get Sheet Data-kommando
Start med en Workiva Get sheet data -kommando for å identifisere dataene som skal lastes ned, basert på tidsperioden i Watershed-regnearkets Control-ark:
- Fra Tilgjengelige kontakter, velg Workiva, og flytt Hent arkdata til Start.
- Velg kommandoen Hent arkdata, og klikk på Rediger.
- I Basic info angir du et navn og en beskrivelse for å identifisere kommandoen.
- Angi kommandoens egenskaper, og klikk på Lagre:
Egenskap Verdi Kontakt Velg hvilken Workiva-kontakt du vil bruke. Regneark-ID Velg kjedevariabelen Spreadsheet ID. Ark-ID/navn Velg kjedevariabelen Sheet ID. Region Skriv inn A11:.Verdistil Velg Beregnet. Revisjon For å sikre den nyeste versjonen, skriv inn -1.
Trinn 3. Legg til kommandoer for å forberede tidsperioden for Watershed
For å identifisere tidsperioden for Watershed legger du til Advanced query og CSV to JSON kommandoer:
- Velg Tabular Transformation fra Available connectors, og flytt Advanced query til lerretet.
- Dra en lenke fra Hent arkdata til Avansert spørring.
- Velg kommandoen Advanced query, og klikk på Edit.
- I Basic info angir du et navn og en beskrivelse for å identifisere kommandoen.
- Angi kommandoens egenskaper, og klikk på Lagre:
Egenskap Verdi Kontakt Velg den Tabular Transformation-kontakten som skal brukes. Tabeller Legg til tabellen for tidsperiodedataene: - I File velger du Data utdata fra kommandoen Get sheet data.
- I Tabellnavn, skriv inn
a.
Spørring Skriv inn spørringen som skal kjøres: select case when `Startmåned` = 'januar' then '01' when `Startmåned` = 'februar' then '02' when `Startmåned` = 'mars' then '03' when `Startmåned` = 'april' then '04' when `Startmåned` = 'mai' then '05' when `Startmåned` = 'juni' then '06' when `Startmåned` = 'juli' then '07' when `Startmåned` = 'august' then '08' when `Startmåned` = 'september' then then '06' when `Start Month` = 'July' then '07' when `Start Month` = 'August' then '08' when `Start Month` = 'September' then '09' when `Start Month` = 'October' then '10' when `Start Month` = 'November' then '11' else '12' end as 'sm', case when `End Month` = 'January' then '01' when `End Month` = 'February' then '02' when `End Month` = 'March' then '03' when `End Month` = 'April' then '04' when `End Month` = 'May' then '05' when `End Month` = 'June' then '06' when `End Month` = 'June' then '06' when `End Month` = 'June' then '06' når `Slutt måned` = 'juli' så '07' når `Slutt måned` = 'august' så '08' når `Slutt måned` = 'september' så '09' når `Slutt måned` = 'oktober' så '10' når `Slutt måned` = 'november' så '11' ellers '12' slutt som 'em', `Reporting Year` as 'ry', TableId as 'tid' from a
Skilletegn for inndata Velg Komma. Skilletegn for utdata Velg Komma. Forhåndsvisning av resultater Merk av i denne avmerkingsboksen. - Fra Tilgjengelige koblinger velger du JSON, og flytter CSV til JSON til lerretet.
- Dra en kobling fra Avansert spørring til CSV til JSON.
- Velg kommandoen CSV to JSON, og klikk på Edit.
- I Basic info angir du et navn og en beskrivelse for å identifisere kommandoen.
- Angi kommandoens egenskaper, og klikk på Lagre:
Egenskap Verdi Kontakt Velg JSON-kontakten som skal brukes. Inndatafil Velg Resultat fra kommandoen Avansert spørring. Skilletegn Velg komma (,).
Trinn 4. Legg til en HTTP Request GET-kommando
For å laste ned karbonavtrykksdata for den valgte tidsperioden legger du til en HTTP-forespørsel GET -kommando:
- Velg HTTP-forespørsel fra Tilgjengelige koblinger, og flytt GET til lerretet.
- Dra en lenke fra CSV til JSON til GET.
- Velg kommandoen GET, og klikk på Edit.
- I Basic info angir du et navn og en beskrivelse for å identifisere kommandoen.
- Angi kommandoens egenskaper, og klikk på Lagre:
Egenskap Verdi Kontakt Velg HTTP-forespørselskontakten som skal brukes. Vis svar Merk av i denne avmerkingsboksen. URL Skriv inn https://api.watershedclimate.com/v1/report/footprint_detail.Forespørselsstreng Skriv inn spørringsstrengen for å angi start- og sluttmånedene for dataene som skal lastes ned: - For startmåneden skriver du inn
startMonth=, og velger JSON-filen fra kommandoen CSV to JSON to ganger. - Deretter skriver du inn
&endMonth=for sluttmåneden, og velger JSON-filen fra kommandoen CSV to JSON to ganger til. - For begge månedene klikker du på den første JSON-filen output, og bruker en Get variable from JSON transformation:
- I Output velger du Text.
- I Verdi, skriv inn
0ogry.
- For begge månedene klikker du på den andre JSON-filen utdata, og bruker en annen Hent variabel fra JSON transformasjon:
- I Output velger du Text.
- I Verdi, skriv inn
0ogsm.
Topptekster Legg til en topptekst: - I Key, skriv inn
Authorization. - I Value, skriv inn
Bearer, og velg deretter kjedevariabelen APIKey.
Innholdstype Skriv inn application/json. - For startmåneden skriver du inn
Trinn 5. Legg til Run chain-hendelser for å utføre og logge dataopplastingen
For å laste opp dataene til Wdata og logge opplastingen i Control sheet -seksjonen, legger du til Run chain -hendelser for kjedene som er opprettet tidligere:
- Fra Kjedehendelser, flytt Kjør kjeden til lerretet.
- Dra en lenke fra GET til Kjør kjeden.
- Velg hendelsen Kjør kjede, og klikk på Rediger.
- I Basic info angir du et navn og en beskrivelse for å identifisere at hendelsen laster opp data til Wdata.
- I Chain to run velger du Load Data to Wdata | Primary chain opprettet tidligere fra malen Load Data to Wdata.
- Skriv inn kjedens kjøretidsinndata, og klikk på Lagre:
Inndata Verdi Tabell-ID For å angi ID-en til Wdata-tabellen som dataene skal lastes opp til: - Velg JSON-filen fra kommandoen CSV til JSON.
- Klikk på JSON-filen output, og bruk en Get variable from JSON transformasjon:
- I Output velger du Text.
- I Verdi, skriv inn
0ogtid.
Filprefiks For å definere prefikset for datasettet som skal lastes opp, basert på tidsperioden for dataene: - For startmåneden velger du JSON-filen fra kommandoen CSV til JSON to ganger.
- Skriv inn en understreking (
_). - For sluttmåneden velger du JSON-filen fra kommandoen CSV to JSON to ganger til.
- Skriv inn
.csv. - For begge månedene klikker du på den første JSON-filen utdata, og bruker en Get variable from JSON transformasjon:
- I Output velger du Text.
- I Verdi, skriv inn
0ogry.
- For begge månedene klikker du på den andre JSON-filen output, og bruker en annen Get variable from JSON transformasjon:
- I Output velger du Text.
- I Verdi, skriv inn
0ogsm.
Datafil Velg Response utdata fra kommandoen GET. Belastningsmetode Velg Erstatt datasett. Tilbakeføring Merk av i denne avmerkingsboksen. - Fra Kjedehendelser, flytt en annen Kjør kjeden til lerretet.
- Dra en lenke fra den første Run-kjeden til den andre.
- Velg den andre Kjør kjede -hendelsen, og klikk på Rediger.
- I Basic info angir du et navn og en beskrivelse for å identifisere at hendelsen logger dataopplastingen i Watershed-regnearket.
- I Chain to run velger du 3. Watershed -kjeden som ble opprettet tidligere.
- Skriv inn kjedens kjøretidsinndata, og klikk på Lagre:
Inndata Verdi Område Skriv inn F12:F12.Regneark-ID Velg kjedevariabelen SpreadsheetID. Ark-ID Velg kjedevariabelen SheetID. - Klikk på Publiser, skriv inn eventuelle merknader om publiseringen, og klikk på Publiser.
Kjør kjedene
For å oppdatere regnearket Watershed med de nyeste dataene om karbonfotavtrykk:
- Velg tidsperioden - måneder og år - for dataene som skal lastes ned fra Watershed, i delen Control sheet i regnearket Watershed.
- Fra Wdata Chains velger du 1. Watershed -kjeden, og klikk på Utfør og Kjør kjeden.
Merk: Når du kjører denne kjeden, kjører den automatisk de to andre kjedene for å oppdatere Wdata-tabellen og Watershed regnearket med dataene.