Workiva kundestøttesenter

Fra Chain Builder kan du opprette en kjede for å laste ned data fra Schneider Electric® til Workiva, for eksempel klimagassutslippene dine for ESG-rapportering (Environmental, Social and Governance) eller bærekraftsrapportering.

Forutsetninger

For å bygge denne kjeden bruker du disse kjernekontaktene:

• HTTP-forespørselskontakt
• JSON-kontakt
• File Utilities-kontakt
• Workiva-kontakt

Merk: Alle koblinger bruker CloudRunner. Det kreves ingen GroundRunners for denne kjeden.

For å laste ned utslippsdata trenger du også brukernavnet og passordet som brukes til grunnleggende autentisering hos Schneider Electric.

Trinn 1. Opprett kjeden

1. Fra Kjeder, klikk på Opprett, og velg Opprett kjede.
   
2. Under Setup angir du et navn og en beskrivelse for å identifisere kjeden.
   
3. Under Variables legger du til variabler for å spesifisere dataene som skal lastes ned fra Schneider Electric:

   Navn	Verdi
   clientHierIds	Skriv inn ID-en til bedriftens kundehierarki, slik det er satt opp for Schneider Electric i Resource Advisor.
   serviceIds	For å laste ned data kun for en spesifikk kilde, skriver du inn klimagasskilde-ID-en du vil laste ned utslippsdata for.
   fraMåned	Angi den tidligste måneden i tidsperioden du vil laste ned data for, i formatet yyyy-MM.
   tilMåned	Angi den siste måneden i tidsperioden du vil laste ned data for, i formatet yyyy-MM.
   carbonMapType	Angi hvilket karbonkart fra Resource Advisor som skal brukes - primær eller sekundær. Hvis kommandoen ikke fylles ut, bruker kommandoen det primære karbonkartet.
   emissionUOMId	Angi ønsket måleenhet som skal brukes med nedlastede utslippsdata.
   utslippsURL	Skriv inn URL-adressen til Schneider Electric API-endepunkt for å be om data fra.

4. Klikk på Lagre.

Trinn 2. Start med en HTTP-forespørsel

For å be om data som skal lastes ned fra Schneider Electric, starter du med en HTTP POST -kommando.

1. Under Connectors, velg HTTP, og flytt POST til Start.
2. Velg kommandoen POST, og klikk på Edit.
3. Under Basic info skriver du inn et navn og en beskrivelse for å identifisere kommandoen.
4. Under Command properties velger du HTTP Request-kontakten som skal brukes.
5. Angi egenskapene til kommandoen:
   
   

   Egenskap	Beskrivelse
   Brukernavn	Skriv inn brukernavnet som brukes til grunnleggende autentisering hos Schneider Electric.
   Passord	Skriv inn passordet som brukes for grunnleggende autentisering med Schneider Electric.
   Vis svar	Kryss av i denne boksen.
   URL	Velg variabelen emissionsURL under Chain.
   Innholdstype	Velg application/json.
   Brødtekst	Skriv inn forespørselen som en JSON-streng (JavaScript Object Notation), og velg den aktuelle variabelen under Chain som verdi for hvert navn/verdi-par: { "clientHierIds": [<klientHierId-variabel>], "serviceIds": [<variabel for serviceIds>], "fromMonth": "<variabel for fromMonth>", "toMonth": "<variabel for toMonth>", "carbonMapType": "<carbonMapType-variabel>", "emissionsUOMId": "<emissionUOMId-variabel>" }
   Utgangsskjema	Skriv inn eksempelet på JSON-svaret fra Schneider Electric: { "serviceOutput": [ { { "divisionClientHierId": 0, "divisionName": "string", "siteClientHierId": 0, "siteName": "string", "dataSourceLevel": "string", "serviceId": 0, "serviceName": "string", "scope": "string", "usage": 0, "emission": 0, "emissionUOM": "string", "usageUOM": "string", "serviceMonth": "string" } ],"errorMessage":"string","errorCode":"string" }

6. Klikk på Lagre.

Trinn 3. Legg til en matrise i CSV-kommandoen

Hvis du vil konvertere JSON-svaret fra Schneider Electric til et CSV-format (kommaseparerte verdier), legger du til en Array to CSV -kommando:

1. Under Connectors velger du JSON, og flytter Array to CSV til lerretet.
2. Dra en kobling fra Start til kommandoen Array to CSV.
3. Velg kommandoen Array to CSV, og klikk på Edit.
4. Under Basic info skriver du inn et navn og en beskrivelse for å identifisere kommandoen.
5. Under Command properties velger du JSON-kontakten som skal brukes.
   
6. For JSON-data velger du Response utdata fra POST -kommandoen.
7. Under Columns legger du til kolonner for dataene som er lastet ned fra Schneider Electric:
   
   

   Kolonnenavn	JSONPath
   bruk	.bruk
   utslipp	.utslipp

8. For Delimiter velger du komma.
9. Klikk på Lagre.

Trinn 4. Legg til en Create File-kommando

Hvis du vil opprette en CSV-fil fra dataene, legger du til en Create file -kommando:

1. Under Connectors velger du File Utilities, og flytter Create file til lerretet.
2. Dra en kobling fra kommandoen Array to CSV til kommandoen Create file.
3. Velg kommandoen Opprett fil, og klikk på Rediger.
4. Under Basic info skriver du inn et navn og en beskrivelse for å identifisere kommandoen.
5. Under Command properties velger du File Utilities-kontakten som skal brukes.
   
6. Angi egenskapene til kommandoen:
   

   Egenskap	Beskrivelse
   Tekst	Velg Konvertert fil utdata fra kommandoen Array to CSV.
   Filbane	Velg variabelen Chain.Workspace under Runtime, og skriv inn \ og filnavnet med filtypen .csv.

7. Klikk på Lagre.

Trinn 5. Legg til kommandoer for å bruke data i Workiva

For å bruke CSV-dataene i Workiva-plattformen må du legge til Workiva connector-kommandoer for å bruke Created file variabelutdata fra kommandoen Create file med et regneark eller en Wdata-tabell. Hvis du for eksempel vil legge til Schneider Electric-dataene som et datasett i en Wdata-tabell, legger du til en Kjør kjede -hendelse som bruker en kjede opprettet fra Oppdater datasett i en tabell mal. 

Trinn 6. Publiser og kjør kjeden

For å aktivere kjeden til å kjøre:

1. Klikk på Publiser.
2. Skriv inn en kommentar om publiseringen, og klikk på Publish.

For å kjøre kjeden:

1. Fra Kjeder velger du Rediger i menyen for kjeden.
2. Klikk på Kjedeinnstillinger, skriv inn variabelverdiene for å angi dataene som skal lastes ned, og klikk på Lagre.
3. Klikk på Utfør og Kjør kjede.