Urjanet Utility Cloud® gjør det mulig for bedrifter å gjøre noe med klimapåvirkningen sin ved hjelp av nøyaktige data fra energileverandører over hele verden.
Med Workiva kan du bygge kjeder for automatisk nedlasting av bruksdata fra Urjanet til en tabell, basert på en tidsperiode som er angitt i et egendefinert Urjanet-kontrollark regneark. Du kan deretter bruke denne tabellen som kilde for en spørring eller regnearktilkobling for å inkludere dataene i ESG-data (Environmental, Social and Governance) eller bærekraftsrapportering.
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 Urjanet og oppdatere regnearket.
Merk: Regnearket Urjanet kontrollark som brukes av disse kjedene, er levert av Workiva. Hvis du ikke har det, men er interessert, kan du kontakte din Customer Success Manager (CSM) for mer informasjon.
Forutsetninger
For å bygge disse kjedene trenger du disse kontaktene:
- Workiva kontakt
- Tabular Transformation kontakt
- JSON kontakt
- HTTP-forespørsel kontakt
- Styr 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:
- brukernavn og passord som skal brukes for å autentisere seg med og få tilgang til Urjanet-tjenester
- ID-ene til Urjanet kontrollark regneark, dets kontrollark seksjon, og den tilknyttede tabellen
Bygg en kjede for å logge nedlastinger av data
Til å begynne med kan du lage en kjede for å oppdatere Control sheet for å spore når bruksdata 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. Urjanetog en beskrivelse som hjelper deg med å identifisere at kjeden logger opplastinger av verktøydata. - 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. Urjanet 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 Site use data last refreshed on, 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 Urjanet-kontrollarket regnearkets tilknyttede tabell med dataene som er lastet ned fra Urjanet. 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, åpner du Load Data to Wdata | Primary chain mal, og klikker på Ny kjede.
Bygg en kjede for å laste ned data fra Urjanet
Til slutt bygger du en kjede for å laste ned og importere bruksdata fra Urjanet.
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. Urjanetog en beskrivelse som hjelper deg med å identifisere kjeden. - I Variabler legger du til variabler for Urjanet-legitimasjonen din og ID-ene til Urjanet-kontrollarket regnearket og dets Kontrollark seksjon.
Navn Verdi Urjanetbrukernavn Skriv inn brukernavnet som skal brukes for å få tilgang til Urjanet-tjenester. Urjanetpassord Skriv inn passordet som skal brukes for å få tilgang til Urjanets tjenester. RegnearkID Skriv inn ID-en til Urjanet kontrollark regneark. ArkID Skriv inn ID-en til Kontrollark i regnearket. - 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 Urjanet kontrollark regnearket:
- 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 den samme Workiva-kontakten som i den tidligere kjeden. Regneark-ID Velg kjedevariabelen Spreadsheet ID. Ark-ID/navn Velg kjedevariabelen Sheet ID. Region Skriv inn A11:E12.Verdistil Velg Beregnet. Revisjon For å sikre den nyeste versjonen, skriv inn -1.
Trinn 3. Legg til kommandoer for å forberede tidsperioden for Urjanet
For å identifisere tidsperioden for Urjanet, legg 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 `Start Month` = 'January' then '01-01' when `Start Month` = 'February' then '02-01' when `Start Month` = 'March' then '03-01' when `Start Month` = 'April' then '04-01' when `Start Month` = 'May' then '05-01' when `Start Month` = 'June' then '06-01' when `Start Month` = 'July' then '07-01' when `Start Month` = 'August' then '08-01' when `Start Month` = 'September' then '09-01' when `Start Month` = 'October' then '10-01' when `Start Month` = 'November' then '11-01' else '12-01' end as 'sm', case when `End Month` = 'January' then '01-31' when `End Month` = 'February' then '02-28' when `End Month` = 'March' then '03-31' when `End Month` = 'April' then '04-30' when `End Month` = 'May' then '05-31' when `End Month` = 'June' then '06- 30' when `End Month` = 'June' then '06- 30' when `End Month` = 'June' then '05-31' when `End Month` = 'June' then '06-30' når `Slutt måned` = 'juli' så '07-31' når `Slutt måned` = 'august' så '08-31' når `Slutt måned` = 'september' så '09-30' når `Slutt måned` = 'oktober' så '10-31' når `Slutt måned` = 'november' så '11-30' ellers '12-31' end som 'em', `Rapporteringsår` som 'ry', TableId som 'tid' fra 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 utdata fra kommandoen Avansert spørring. Skilletegn Velg komma (,).
Trinn 4. Legg til en POST-kommando for å sende et bærertoken til Urjanet
For å gi Urjanet bærertokenet for autentisering, legger du til en HTTP POST -kommando:
- Fra Tilgjengelige koblinger velger du HTTP, og flytter POST til lerretet.
- Dra en lenke fra CSV til JSON til POST.
- Velg kommandoen POST, 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-kontakten som skal brukes. Vis svar Merk av i denne avmerkingsboksen. URL Skriv inn https://api.urjanet.com/auth/login.Innholdstype Skriv inn application/json.Brødtekst Skriv inn strengen som skal brukes til å lage bærertokenet: - Skriv inn
{"password":". - Velg variabelen Urjanetpassword fra Chain.
- Skriv inn
","brukernavn":" - Velg variabelen Urjanetusername fra Chain.
- Skriv inn
"}.
Utgangsskjema Skriv inn dette eksempelet på svar: {"status":200,"message":"Authentication Successful","type":"Bearer","token":"abc","expires":"1694017012"} - Skriv inn
Trinn 5. Legg til kommandoer for å hente nettsteder fra Urjanet
For å hente og analysere nettstedene fra Urjanet-kontoen din, legger du til en HTTP GET og Handlebars Render tekstmal kommandoer:
- Velg HTTP fra Tilgjengelige koblinger, og flytt GET til lerretet.
- Dra en lenke fra POST 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 den samme HTTP-kontakten som tidligere. Vis svar Merk av i denne avmerkingsboksen. URL Skriv inn https://api.urjanet.com/utility/sites.Topptekster Legg til denne overskriften: - I Key, skriv inn
autorisasjon. - I Value velger du Type og deretter Token fra Response fra POST -kommandoen.
Innholdstype Skriv inn application/json.Utgangsskjema Skriv inn dette eksempelet på svar: { "_embedded" : { "sites" : [ { "createdBy" : "jack.doe", "createdDate" : "2023-08-29T18:49:32.000+00:00","entityId" : "1ee469cc-a606-d007-9415-eeeb8714a7ae","facilityType" : "Office","lastModifiedBy" : "jack.doe","lastModifiedDate" : "2023-08-29T18:49:32.000+00:00","region" : null,"serviceAddress" : { "addressType" : "RAW","city" : "CHICAGO", "country" : "USA", "fullAddress" : "123 EVERGREEN TERRACE, CHICAGO, IL, 60603, USA", "postalCode" : "60603", "recipient" : null, "state" : "IL", "streetLine1" : "123 EVERGREEN TERRACE", "streetLine2" : null }, "siteCode" : "DIO", "siteName" : "Doe, Inc.","siteNumber" : "1","subRegion" : null,"_links" : { "self" : { "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae" }, "accounts" : { "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae/accounts" }, "credentials" : { "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae/credentials" }, "events" : { "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae/events" }, "meters" : { "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae/meters" }, "statements" : { "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae/statements" } } } ] }, "_links" : { "self" : { "href" : "https://api.urjanet.com/utility/sites?page=0&size=20" } } }, "_links" : { "self" : { "href" : "https://api.urjanet.com/utility/sites?page=0&size=20" } }, "page" : { "size" : 20, "totalElements" : 1, "totalPages" : 1, "number" : 0 } } } - I Key, skriv inn
- Fra Tilgjengelige koblinger velger du Lenker, og flytter Render tekstmal til lerretet.
- Dra en lenke fra GET til Render tekstmal.
- Velg kommandoen Render tekstmal, 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 kontakten som skal brukes på styret. Mal Skriv inn denne tekstmalen: [{{#each a}} "{{entityId}}" {{#unless @last}},{{/unless}}{{/each}}]JSON-variabler Legg til denne variabelen: - I Navn, skriv inn
a. - I Value velger du sites fra _embedded av Response output av GET kommandoen.
- I Navn, skriv inn
Trinn 6. Legg til kommandoer for å be om nettstedsdata fra Urjanet
For å be om bedriftens nettsteddata fra Urjanet legger du til en ny HTTP POST -kommando, etterfulgt av en Pause chain -hendelse for å gi forespørselen tid til å behandles:
- Fra Tilgjengelige koblinger velger du HTTP, og flytter POST til lerretet.
- Dra en lenke fra Render tekstmal til POST.
- Velg kommandoen POST, 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 samme HTTP-kontakten som tidligere. Vis svar Merk av i denne avmerkingsboksen. URL Skriv inn https://api.urjanet.com/utility/sites/downloads/usages.Innholdstype Skriv inn application/json.Brødtekst Skriv inn strengen som skal brukes til å lage bærertokenet: - Skriv inn
{"siteIds":. - Velg Rendert tekst som resultat av kommandoen Render tekstmal.
- Skriv inn
,"startDate":" - Velg JSON-filen fra kommandoen CSV til JSON , og bruk en Get value from JSON variabeltransformasjon:
- I Output velger du Text.
- I Verdi, skriv inn
0og deretterry.
- Skriv inn
-. - Velg JSON-filen fra kommandoen CSV til JSON , og bruk en Get value from JSON variabeltransformasjon:
- I Output velger du Text.
- I Verdi, skriv inn
0og derettersm.
- Skriv inn
","endDate":". - Velg JSON-filen fra kommandoen CSV til JSON , og bruk en Get value from JSON variabeltransformasjon:
- I Output velger du Text.
- I Verdi, skriv inn
0og deretterry.
- Skriv inn
-. - Velg JSON-filen fra kommandoen CSV til JSON , og bruk en Get value from JSON variabeltransformasjon:
- I Output velger du Text.
- I Verdi, skriv inn
0og deretterem.
- Enter
","outputFormat":"CSV"}.
Topptekster Legg til to overskrifter: - En autorisasjon header:
- I Key, skriv inn
autorisasjon. - I Value velger du Type og deretter Token fra Response fra den første POST -kommandoen.
- I Key, skriv inn
- En accept header:
- I Tast, skriv inn
godta. - I Value, skriv inn
application/json.
- I Tast, skriv inn
Utgangsskjema Skriv inn dette eksempelet på svar: { "createdDate" : "2023-09-19T15:11:09.944+00:00", "entityId" : "1ee56fec-3a9c-d96e-a849-a6c381b08d2b", "_links" : { "download" : { "href" : "https://api.urjanet.com/utility/downloads/1ee56fec-3a9c-d96e-a849-a6c381b08d2btpnu" } }} - Skriv inn
- Fra Kjedehendelser, flytt Pause kjede til lerretet.
- Dra en lenke fra POST til Pause-kjeden.
- Velg hendelsen Pause kjede, og klikk på Rediger.
- I Basic info angir du et navn og en beskrivelse for å identifisere kommandoen.
- Skriv inn informasjon om arrangementet, og klikk på Lagre:
Detaljer Verdi Ventetid Gå inn på 6.Enhet for ventetid Velg Sekunder.
Trinn 7. Legg til kommandoer for å laste ned nettsteddataene som en CSV-fil
Hvis du vil laste ned nettsteddataene fra Urjanet som en CSV-fil, legger du til en ny HTTP GET -kommando og en Tabular Transformation Map headers -kommando:
- Fra Tilgjengelige koblinger velger du HTTP, og flytter GET til lerretet.
- Dra en lenke fra POST 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 den samme HTTP-forespørselskoblingen som tidligere. Vis svar Merk av i denne avmerkingsboksen. URL Velg href fra _links i Response -utdataene fra den andre POST -kommandoen. Topptekster Legg til denne overskriften: - I Key, skriv inn
autorisasjon. - I Value velger du Type og deretter Token fra Response fra den første POST -kommandoen.
Innholdstype Skriv inn application/json. - I Key, skriv inn
- Velg Tabular Transformation fra Available connectors, og flytt Map headers til lerretet.
- Dra en lenke fra GET til Kartoverskrifter.
- Velg kommandoen Map headers, 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 samme Tabular Transformation-kontakten som tidligere. Inndatafil Velg Response for den andre GET -kommandoen. Utdatafil Skriv inn urjanet.csv.Forhåndsvisning av resultater Merk av i denne avmerkingsboksen. Skilletegn Velg Komma. Inngangsoverskrifter Legg til overskriftene i CSV-filen som er lastet ned fra Urjanet, i denne rekkefølgen: - Uttalelse Id
- Intervall Start
- Intervall slutt
- Type tjeneste
- Måler-ID
- Målernummer
- Målerstatus
- Rå kontonummer
- Normalisert kontonummer
- Leverandørens navn
- Tjenesteadresse
- Service City
- Servicestatus
- Tjeneste Postnummer
- Serviceland
- Nettstedskode
- Stedets navn
- Stedsnummer
- Område Region
- Stedets underregion
- Type anlegg
- Adresse på stedet
- Sted By
- Site State
- Stedets postnummer
- Nettsted Land
- Tariffnavn
- Forbruk
- Forbruk Måleenhet
- Ytterligere leverandørnavn
- Ytterligere leverandørkontonummer
- Klassifisering av leverandør
- Totale kostnader
- Totale kostnader Valutakode
Utgangsoverskrifter Legg til de tilsvarende overskriftene for tabellen som skal inneholde dataene, i denne rekkefølgen: - statement_id
- intervall_start
- intervall_slutt
- service_type
- måler_id
- måler_nummer
- meter_status
- raw_account_number
- normalisert_kontonummer
- leverandør_navn
- service_adresse
- service_by
- service_state
- tjeneste_postnummer
- service_country
- site_code
- nettsted_navn
- site_number
- site_region
- site_sub_region
- site_facility_type
- site_address
- sted_by
- site_state
- sted_postnummer
- site_country
- tariff_navn
- forbruk
- forbruk_enhet_av_mål
- navn_på_ytterligere_leverandør
- ekstra_leverandør_kontonummer
- leverandør_klassifisering
- total_charges
- sum_gebyrer_valuta_kode
Trinn 8. Legg til Kjør kjedehendelser for de andre kjedene
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 Kartlegg overskrifter 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 å oppgi ID-en til Wdata-tabellen som dataene skal lastes opp til, velger du JSON-filen utdata fra kommandoen CSV til JSON, og bruker en Get variable from JSON variabeltransformasjon: - I Output velger du Text.
- I Verdi, skriv inn
0ogtid.
Filnavn For å definere navnet på datasettet som skal lastes opp, basert på tidsperioden for dataene: - Gå inn på
Site Usage_. - For startmåneden velger du JSON-filen fra kommandoen CSV til JSON, skriver inn en bindestrek (
-), og velger JSON-filen fra kommandoen CSV til JSON igjen. - Skriv inn en understreking (
_). - For sluttmåneden velger du JSON-filen fra kommandoen CSV til JSON, skriver inn en bindestrek (
-), og velger JSON-filen fra kommandoen CSV til JSON igjen. - 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
0ogem.
Datafil Velg Map headers output i kommandoen Map headers. 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 Urjanet control sheet regnearket.
- I Chain to run velger du 3. Urjanet kjede 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 tabellen med de nyeste bruksdataene:
- Velg tidsperioden - måneder og år - for dataene som skal lastes ned fra Urjanet, i delen Control sheet i regnearket Urjanet control sheet.
- Fra Kjeder velger du 1. Urjanet 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 Urjanet Control Sheet regnearket med dataene.