Workiva supportcenter

På Chain Builder kan du skapa en kedja för att hämta data från Schneider Electric® till Workiva, t.ex. dina utsläpp av växthusgaser (GHG) för ESG-rapportering (Environmental, Social, Governance) eller hållbarhetsrapportering.

Förkunskapskrav

För att bygga den här kedjan använder du dessa kärnkontakter:

• Anslutningsdon för HTTP-förfrågan
• JSON-anslutning
• Anslutningsdon för filverktyg
• Workiva-kontakt

Obs: Alla anslutningar använder CloudRunner. Inga GroundRunners krävs för denna kedja.

För att ladda ner utsläppsdata behöver du också det användarnamn och lösenord som du använder för grundläggande autentisering med Schneider Electric.

Steg 1. Skapa kedjan

1. Från Chains, klicka på Create, och välj Create chain.
   
2.  Under Setup anger du ett namn och en beskrivning för att identifiera kedjan.
   
3. Under Variables lägger du till variabler för att ange vilka data som ska hämtas från Schneider Electric:

   Namn	Värde
   klientHierIds	Ange ID för ditt företags klienthierarki, så som den har ställts in för Schneider Electric i Resource Advisor.
   serviceIds	Om du endast vill hämta data för en viss källa anger du GHG-källans ID för att hämta utsläppsdata för.
   frånMånad	Ange den tidigaste månaden i den tidsperiod för vilken data ska hämtas, i formatet åååå-MM.
   tillMånad	Ange den senaste månaden i den tidsperiod som data ska hämtas för, i formatet åååå-MM.
   kolMapTyp	Ange vilken koldioxidkarta från Resource Advisor som ska användas - primär eller sekundär. Om den lämnas tom använder kommandot den primära kolkartan.
   emissionUOMId	Ange önskad måttenhet som ska användas för nedladdade utsläppsdata.
   emissionURL	Ange URL:en för Schneider Electric API-endpoint för att begära data från.

4. Klicka på Spara.

Steg 2. Börja med en HTTP-begäran

För att begära att data hämtas från Schneider Electric börjar du med ett HTTP POST -kommando.

1. Under Connectors, välj HTTP, och flytta POST till Start.
2. Välj kommandot POST och klicka på Edit.
3. Under Basic info anger du ett namn och en beskrivning som hjälper dig att identifiera kommandot.
4. Under Command properties väljer du den HTTP Request connector som ska användas.
5. Ange kommandots egenskaper:
   
   

   Egenskap	Beskrivning
   Användarens namn	Ange det användarnamn som används för grundläggande autentisering med Schneider Electric.
   Lösenord	Ange det lösenord som används för grundläggande autentisering med Schneider Electric.
   Visa svar	Kryssa i denna ruta.
   URL	Välj variabeln emissionsURL under Chain.
   Typ av innehåll	Välj application/json.
   Text i brödtext	Ange begäran som en JSON-sträng (JavaScript Object Notation) och välj den tillämpliga variabeln under Chain som värde för varje namn/värdepar: { "clientHierIds": [<clientHierId>], "serviceIds": [<serviceIds>], "fromMonth": "<fromMonth>", "toMonth": "<toMonth>","carbonMapType": "<carbonMapType>", "emissionsUOMId": "<emissionUOMId>" }
   Utmatningsschema	Ange prov på JSON-svar från 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": "sträng" } ],"errorMessage": "sträng", "errorCode": "sträng" }

6. Klicka på Spara.

Steg 3. Lägg till en Array i CSV-kommandot

Om du vill konvertera JSON-svaret från Schneider Electric till ett CSV-format (comma-separated values) lägger du till kommandot Array to CSV:

1. Under Connectors, välj JSON, och flytta Array to CSV till canvasen.
2. Dra en länk från Starta till kommandot Array to CSV.
3. Välj kommandot Array to CSV och klicka på Edit.
4. Under Basic info anger du ett namn och en beskrivning som hjälper dig att identifiera kommandot.
5. Under Command properties väljer du den JSON-anslutning som ska användas.
   
6. För JSON-data väljer du Response som utgång för kommandot POST.
7. Under Kolumner lägger du till kolumner för de data som hämtats från Schneider Electric:
   
   

   Namn på kolumn	JSONSökväg
   användning	.användning
   utsläpp	.utsläpp

8. För Delimiter, välj Comma.
9. Klicka på Spara.

Steg 4. Lägg till kommandot Create File

Om du vill skapa en CSV-fil från data lägger du till kommandot Create file:

1. Under Connectors väljer du File Utilities och flyttar Create file till Canvas.
2. Dra en länk från till Array to CSV kommandot till Skapa fil kommandot.
3. Välj kommandot Skapa fil och klicka på Redigera.
4. Under Basic info anger du ett namn och en beskrivning som hjälper dig att identifiera kommandot.
5. Under Command properties, välj den File Utilities connector som ska användas.
   
6. Ange kommandots egenskaper:
   

   Egenskap	Beskrivning
   Text	Välj Konverterad fil utdata från kommandot Array to CSV.
   Filens sökväg	Välj variabeln Chain.Workspace under Exekvering och ange \ och namnet på filen med tillägget .csv.

7. Klicka på Spara.

Steg 5. Lägg till kommandon för att använda data i Workiva

Om du vill använda CSV-data i Workiva-plattformen lägger du till Workiva anslutningskommandon för att använda Created file variabelutdata från kommandot Create file med en kalkylark eller Wdata-tabell. Om du till exempel vill lägga till Schneider Electric-data som en datauppsättning i en Wdata-tabell lägger du till en Kör kedjan händelse som använder en kedja som skapats från Uppdatera dataset i en tabell mall. 

Steg 6. Publicera och kör kedjan

För att kedjan ska kunna löpa:

1. Klicka på Publicera.
2. Skriv en kommentar om publiceringen och klicka på Publicera.

För att driva kedjan:

1. Från Chains, välj Edit från kedjans meny.
2. Klicka på Chain Settings, ange variabelvärdena för att ange vilka data som ska hämtas och klicka på Save.
3. Klicka på Execute och Run chain.