|
Klassiska filtyper är inte längre tillgängliga för användning från och med januari 2021. Du kan överföra dina klassiska filer eller ladda ner en PDF. Läs mer

Workiva supportcenter

Ladda ner utsläppsdata från Enablon® för hållbarhetsrapportering

Ladda ner utsläppsdata från Enablon® för hållbarhetsrapportering

  • Senast uppdaterad

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

download-enablon_08.png

Förkunskapskrav

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

Obs: Alla kommandon i den här kedjan använder standard CloudRunner. Ingen GroundRunner behövs.

För att köra kedjan behöver du information från Enablon för åtkomst till data:

  • Enablons SOAP-slutpunkt (Simple Object Access Protocol) för API (Application Programming Interface) som ska användas för att ladda ner data
  • ID för den Enablon-miljö som ska ges åtkomst
  • Det användarnamn och lösenord som ska användas för åtkomst till miljön

Steg 1. Skapa kedjan

  1. Från Chains, klicka på Create, och välj Create chain.
    download-schneider_01.png
  2. Under Setup anger du ett namn och en beskrivning som hjälper dig att identifiera kedjan och dess syfte.
    download-enablon_09.png
  3. Under Variables, lägg till variabler för de Enablon-uppgifter som krävs för åtkomst till data:
    • Endpoint
      Tips: För variabeln Endpoint anger du ett standardvärde på ExportData eller, om du vill ladda ner data i ett 64-bitars kodningsformat, ExportBinaryData.
    • Miljö
    • Användarnamn
    • Lösenord
  4. Klicka på Spara.

Steg 2. Börja med triggerhändelsen Runtime Inputs

För att filtrera utdata varje gång kedjan körs, börja med en Runtime Inputs händelse för att fråga efter kriterierna för de data som ska laddas ned.

  1. Flytta Exekvering Inputs från under Trigger Events till Starta.
  2. Välj händelsen Exekvering Inputs och klicka på Redigera.
    download-enablon_10.png
  3. Lägg till ingångarna i begäran varje gång kedjan körs:
    Visningsnamn Typ Krävs?
    Rapportperiodens startdatum Datumfält Ja
    Rapportperiodens slutdatum Datumfält Ja
    Kampanj TextField eller DropdownField:
    • TextField, för ett öppet textfält
    • DropdownField, för att välja från en specifik lista med alternativ
    		 Ja
    Enheter Arrayfält Ja
  4. Klicka på Spara.

Steg 3. Lägg till ett POST-kommando för HTTP-förfrågningar

För att hämta data från Enablon-slutpunkten ska du konfigurera ett kommando HTTP connector POST:

  1. Under Connectors klickar du på HTTP och flyttar kommandot POST till canvasen.
  2. Dra en länk från Starta till kommandot POSTa .
  3. Välj kommandot POST och klicka på Edit.
  4. Under Command properties väljer du HTTP connector som ska användas.
  5. Ange kommandots egenskaper:
    download-enablon_01.png
    Egenskap Beskrivning
    Användarens namn Välj variabeln Username under Chain.
    Lösenord Välj variabeln Password under Chain.
    Visa svar Kryssa i denna ruta.
    URL Välj variabeln Endpoint under Chain.
    Typ av innehåll Ange text/xml.
  6. I Body text, ange denna XML-syntax (Extensible Markup Language): 
     <soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:enab="enablon<4> <soapenv:Rubrik> <UserInfo xsi:type="wsdl:AuthHeader" xmlns:wsdl="http://enablon/wsdl/"> <EnaHomeSite xsi:type="xsd:string<6>[Miljö]</EnaHomeSite> <EnaUserName xsi:type="xsd:string">[Användarnamn]</EnaUserName> <EnaPassword xsi:type="xsd:string<8>[Lösenord]</EnaPassword> </UserInfo> </soapenv:Header> <soapenv:Body> <enab:ExportData soapenv:encoding:Style="http://schemas.xmlsoap.org/soap/encoding/"> <Table>/sd/Entiteter/Data</Table>       <FolderId>0</FolderId> <Fields>FolderPath|ReportingPeriod|Ref|IndicatorName|ValueNumber|LocalUnit|ValueList</Fields> <Filter>ReportingPeriod in ([ReportPeriodEndDate],[ReportPeriodStartDate]) AND Campaign in([Campaign]) AND Entities=[Entities]</Filter> <CSVSeparator>2</CSVSeparator> <FormatOptions>25</FormatOptions> <FormatType>3</FormatType> <ExportOptions>8192</ExportOptions> </enab:ExportData> </soapenv:Body> </soapenv:Envelope>
  7. Uppdatera XML-syntaxen med exekveringens indata och kedjevariabler:
    • I rubriken ersätter du [Miljö], [Användarnamn], och [Lösenord] med deras respektive variabler under Chain.
    • I brödtexten ersätter du [ReportPeriodEndDate], [ReportPeriodStartDate], [Campaign] och [Entities] med deras ingångar för exekvering under Trigger.
  8. Klicka på Spara.

Steg 4. Lägg till kommandon för Sök och ersätt i File Utilities-anslutningen

För att förbereda de nedladdade XML-data lägger du till File Utilities connector Find and replace kommandon för att fixa vinkelparenteser och rör.

Tips: För att enkelt kunna skilja på kommandona Hitta och ersätt anger du namn som identifierar det tecken som varje kommando åtgärdar, t.ex. "Hitta och ersätt startvinkelparenteser" eller "Hitta och ersätt rör".
  1. Under Connectors klickar du på File Utilities och flyttar kommandot Find and replace till arbetsytan.
  2. Dra en länk från kommandot POST till kommandot Hitta och ersätt .
  3. Välj kommandot Sök och ersätt och klicka på Redigera.
  4. Under Command properties väljer du File Utilities connector som ska användas.
    download-enablon_02.png
  5. Ange kommandots egenskaper och klicka på Spara:
    Egenskap Beskrivning
    Källa Välj Svar utmatning av kommandot POST.
    Hitta Ange <.
    Ersätt Ange en startvinkelparentes ( <).
    Hitta syntax Välj Exact.
  6. Under Connectors klickar du på File Utilities och flyttar ytterligare ett Find and replace kommando till canvasen.
  7. Dra en länk mellan kommandona Sök och ersätt .
  8. Markera det nya kommandot Hitta och ersätt och klicka på Redigera.
  9. Under Command properties väljer du samma File Utilities kontakt.
    download-enablon_03.png
  10. Ange kommandots egenskaper och klicka på Spara:
    Egenskap Beskrivning
    Källa Välj Ersatt resultat som resultat av kommandot Hitta och ersätt.
    Hitta Ange >.
    Ersätt Ange en startvinkelparentes (>).
    Hitta syntax Välj Exact.
  11. Under Connectors klickar du på File Utilities och flyttar ytterligare ett Find and replace kommando till canvasen.
  12. Dra en länk mellan den andra och tredje Hitta och ersätt kommandon.
  13. Välj det tredje kommandot Hitta och ersätt och klicka på Redigera.
  14. Under Command properties väljer du samma File Utilities kontakt.
    download-enablon_04.png
  15. Ange kommandots egenskaper och klicka på Spara:
    Egenskap Beskrivning
    Källa Välj Ersatt resultat utdata från det andra kommandot Hitta och ersätt.
    Hitta Ange >.
    Ersätt Ange ett pip (|).
    Hitta syntax Välj Exact.

Steg 5. Lägg till en XML-anslutning Element List till CSV-kommando

Om du vill konvertera den nedladdade XML-filen till tabelldata lägger du till kommandot XML connector Element list to CSV:

  1. Klicka på XML under Connectors och flytta ytterligare ett kommando Element list to CSV till canvasen.
  2. Dra en länk från det tredje kommandot Hitta och ersätt till kommandot Elementlista till CSV.
  3. Välj kommandot Element list to CSV och klicka på Edit.
  4. Under Command properties väljer du XML connector som ska användas.
    download-enablon_05.png
  5. Ange kommandots egenskaper:
    Egenskap Beskrivning
    Källa Välj Ersatt resultat resultatet av det tredje Sök och ersätt kommandot.
    Sökväg till rot Enter //Document/Record.
    Förhandsgranskning av resultat Kryssa i denna ruta.
  6. Under Columns lägger du till kolumnnamnet och XPath för varje element:
    download-enablon_11.png
    Namn på kolumn XPath
    Period /RapporteringPeriod
    Indikator /Ref
    IndNamn /Indikatornamn
    NumValue /VärdeNummer
    Enhet /Lokal enhet
  7. I Multi-value delimiter, ange ett kommatecken (,).
  8. Klicka på Spara.

Steg 6. Lägg till en fil kommandot Create File i verktygsanslutningen

Om du vill skapa en CSV-fil (Comma-separated values) från tabelldata lägger du till ett File Utilities connector Create file kommando:

  1. Under Connectors klickar du på File Utilities och flyttar kommandot Create file till arbetsytan.
  2. Dra en länk från kommandot Element list to CSV till kommandot Create file .
  3. Välj kommandot Skapa fil och klicka på Redigera.
  4. Under Command properties väljer du samma File Utilities kontakt som Find and replace kommandon.
    download-enablon_07.png
  5. Ange kommandots egenskaper och klicka på Spara:
    Egenskap Beskrivning
    Text Välj Konverted file output of the Element list to CSV command.
    Filens sökväg Välj variabeln Chain.Workyta under Exekvering och lägg till \test.csv.

Steg 7. 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 Enablon-data som ett dataset 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 8. 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 och klicka på Save.
    Obs: Ange ExportData för variabeln Endpoint eller ExportBinaryData om du vill hämta data i ett 64-bitars kodningsformat.
  3. Klicka på Utför.
  4. Från Monitor, klicka på Run with inputs, ange exekveringens indata och klicka på Start.
Var denna artikel till hjälp?
0 av 0 tyckte detta var till hjälp
På Chain Builder kan du skapa en kedja för att ladda ner data från Enablon®, t.ex. dina utsläpp av växthusgaser (GHG)...