|
Klassiske filtyper er ikke lenger tilgjengelige for bruk fra og med januar 2021. Du kan overføre klassiske filer eller laste ned en PDF-fil. Finn ut mer

Workiva kundestøttesenter

Last ned utslippsdata fra Enablon® for bærekraftsrapportering

Last ned utslippsdata fra Enablon® for bærekraftsrapportering

  • Sist oppdatert

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

download-enablon_08.png

Forutsetninger

For å bygge denne kjeden bruker du disse kjernekontaktene:

Merk: Alle kommandoene i denne kjeden bruker standard CloudRunner. Det er ikke nødvendig med GroundRunner.

For å kjøre kjeden trenger du informasjon fra Enablon for å få tilgang til dataene:

  • Enablon Simple Object Access Protocol (SOAP) Application Programming Interface (API) endepunkt som skal brukes til å laste ned dataene
  • ID-en til Enablon-miljøet som skal åpnes
  • Brukernavn og passord som skal brukes for å få tilgang til miljøet

Trinn 1. Opprett kjeden

  1. Fra Kjeder, klikk på Opprett, og velg Opprett kjede.
    download-schneider_01.png
  2. Under Setup angir du et navn og en beskrivelse for å identifisere kjeden og dens hensikt.
    download-enablon_09.png
  3. Under Variables legger du til variabler for Enablon-opplysningene som kreves for å få tilgang til dataene:
    • Sluttpunkt
      Tips: For variabelen Endpoint angir du standardverdien ExportData eller, for å laste ned dataene i et 64-biters kodingsformat, ExportBinaryData.
    • Miljø
    • Brukernavn
    • Passord
  4. Klikk på Lagre.

Trinn 2. Start med Runtime Inputs-utløserhendelsen

For å filtrere utdataene hver gang kjeden kjøres, starter du med en Runtime Inputs -hendelse for å be om kriteriene for dataene som skal lastes ned.

  1. Flytt Runtime Inputs fra under Trigger Events til Start.
  2. Velg hendelsen Runtime Inputs, og klikk på Edit.
    download-enablon_10.png
  3. Legg til inndataene i forespørselen hver gang kjeden kjøres:
    Visningsnavn Type Er det nødvendig?
    Startdato for rapportperioden DatoFelt Ja
    Sluttdato for rapportperioden DatoFelt Ja
    Kampanjen TextField eller DropdownField:
    • TextField, for et åpent tekstfelt
    • DropdownField, for å velge fra en bestemt liste med alternativer
    		 Ja
    Enheter ArrayField Ja
  4. Klikk på Lagre.

Trinn 3. Legg til en HTTP Request Connector POST-kommando

For å hente data fra Enablon-sluttpunktet setter du opp en HTTP -kontakt POST -kommando:

  1. Under Connectors klikker du på HTTP, og flytter kommandoen POST til lerretet.
  2. Dra en kobling fra Start til kommandoen POST .
  3. Velg kommandoen POST, og klikk på Edit.
  4. Under Kommandoegenskaper velger du HTTP -kontakten som skal brukes.
  5. Angi egenskapene til kommandoen:
    download-enablon_01.png
    Egenskap Beskrivelse
    Brukernavn Velg variabelen Brukernavn under Kjede.
    Passord Velg variabelen Password under Chain.
    Vis svar Kryss av i denne boksen.
    URL Velg variabelen Endpoint under Chain.
    Innholdstype Skriv inn text/xml.
  6. I Body text, skriv inn denne XML-syntaksen (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"> <soapenv:Header> <UserInfo xsi:type="wsdl:AuthHeader" xmlns:wsdl="http://enablon/wsdl/"> <EnaHomeSite xsi:type="xsd:string">[Environment]</EnaHomeSite> <EnaUserName xsi:type="xsd:string">[Brukernavn]</EnaUserName> <EnaPassword xsi:type="xsd:string">[Passord]</EnaPassword> </UserInfo> </soapenv:Header> <soapenv:Body> <enab:ExportData soapenv:encoding:Style="http://schemas.xmlsoap.org/soap/encoding/"&gt <Table>/sd/Entities/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&gt
  7. Oppdater XML-syntaksen med kjøretidsinndata og kjedevariabler:
    • I toppteksten erstatter du [Environment], [Username], og [Password] med de respektive variablene under Chain.
    • I brødteksten erstatter du [ReportPeriodEndDate], [ReportPeriodStartDate], [Campaign], og [Entities] med deres kjøretidsinnganger under Trigger.
  8. Klikk på Lagre.

Trinn 4. Legg til kommandoen Finn og erstatt i File Utilities-kontakten

For å klargjøre de nedlastede XML-dataene legger du til File Utilities connector Find and replace kommandoer for å fikse vinkelparenteser og pipes.

Tips: For å gjøre det enkelt å skille Finn og erstatt -kommandoene fra hverandre, kan du skrive inn navn som identifiserer tegnet hver kommando retter, for eksempel "Finn og erstatt startvinkelparenteser" eller "Finn og erstatt rør".
  1. Under Connectors klikker du på File Utilities, og flytter kommandoen Find and replace til lerretet.
  2. Dra en kobling fra kommandoen POST til kommandoen Find and replace .
  3. Velg kommandoen Finn og erstatt, og klikk på Rediger.
  4. Under Kommandoegenskaper velger du File Utilities kontakten som skal brukes.
    download-enablon_02.png
  5. Angi kommandoens egenskaper, og klikk på Lagre:
    Egenskap Beskrivelse
    Kilde Velg Response utdata fra kommandoen POST.
    Finn Skriv inn <.
    Erstatt Skriv inn en startvinkelparentes (<).
    Finn syntaks Velg Exact.
  6. Under Connectors klikker du på File Utilities, og flytter en ny Find and replace -kommando til lerretet.
  7. Dra en kobling mellom Finn og erstatt -kommandoene.
  8. Velg den nye kommandoen Finn og erstatt, og klikk på Rediger.
  9. Under Kommandoegenskaper velger du den samme File Utilities -kontakten.
    download-enablon_03.png
  10. Angi kommandoens egenskaper, og klikk på Lagre:
    Egenskap Beskrivelse
    Kilde Velg Erstattet resultat utdata fra kommandoen Finn og erstatt.
    Finn Skriv inn >.
    Erstatt Skriv inn en startvinkelparentes (>).
    Finn syntaks Velg Exact.
  11. Under Connectors klikker du på File Utilities, og flytter en ny Find and replace -kommando til lerretet.
  12. Dra en kobling mellom den andre og tredje Finn og erstatt -kommandoer.
  13. Velg den tredje kommandoen Finn og erstatt, og klikk på Rediger.
  14. Under Kommandoegenskaper velger du den samme File Utilities -kontakten.
    download-enablon_04.png
  15. Angi kommandoens egenskaper, og klikk på Lagre:
    Egenskap Beskrivelse
    Kilde Velg Erstattet resultat utdata fra den andre Finn og erstatt kommandoen.
    Finn Skriv inn >.
    Erstatt Skriv inn en pipe (|).
    Finn syntaks Velg Exact.

Trinn 5. Legg til en XML-kontaktelementliste i CSV-kommandoen

Hvis du vil konvertere den nedlastede XML-filen til tabelldata, kan du legge til en XML connector Element list to CSV kommando:

  1. Under Connectors klikker du på XML, og flytter en annen Element list to CSV -kommando til lerretet.
  2. Dra en kobling fra den tredje kommandoen Finn og erstatt til kommandoen Elementliste til CSV.
  3. Velg kommandoen Elementliste til CSV, og klikk på Rediger.
  4. Under Kommandoegenskaper velger du XML Connector som skal brukes.
    download-enablon_05.png
  5. Angi egenskapene til kommandoen:
    Egenskap Beskrivelse
    Kilde Velg Erstattet resultat utdata fra den tredje Finn og erstatt kommandoen.
    Sti til roten Gå inn på //Dokument/Post.
    Forhåndsvisning av resultat Kryss av i denne boksen.
  6. Under Columns legger du til kolonnenavn og XPath for hvert element:
    download-enablon_11.png
    Kolonnenavn XPath
    Periode /ReportingPeriod
    Indikator /Ref
    IndName /IndicatorName
    NumValue /ValueNumber
    Enhet /LocalUnit
  7. I Multi-value delimiter, skriv inn et komma (,).
  8. Klikk på Lagre.

Trinn 6. Legg til en fil ved hjelp av Create File-kommandoen

Hvis du vil opprette en CSV-fil (kommaseparerte verdier) fra tabelldataene, legger du til en File Utilities -tilkobling Create file -kommando:

  1. Under Connectors klikker du på File Utilities, og flytter kommandoen Create file til lerretet.
  2. Dra en kobling fra kommandoen Elementliste til CSV til kommandoen Opprett fil .
  3. Velg kommandoen Opprett fil, og klikk på Rediger.
  4. Under Kommandoegenskaper velger du den samme File Utilities -kontakten som Finn og erstatt -kommandoene.
    download-enablon_07.png
  5. Angi kommandoens egenskaper, og klikk på Lagre:
    Egenskap Beskrivelse
    Tekst Velg Konvertert fil utdata fra kommandoen Elementliste til CSV.
    Filbane Velg variabelen Chain.Workspace under Runtime, og legg til \test.csv.

Trinn 7. 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 Enablon-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 8. 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, og klikk på Lagre.
    Merk: For variabelen Endpoint skriver du inn ExportData eller, for å laste ned dataene i et 64-biters kodingsformat, ExportBinaryData.
  3. Klikk på Utfør.
  4. Fra Monitor, klikk på Run with inputs, skriv inn inndataene for kjøretiden, og klikk på Start.
Var denne artikkelen nyttig?
0 av 0 syntes dette var nyttig
Fra Chain Builder kan du opprette en kjede for å laste ned data fra Enablon®, for eksempel klimagassutslippene dine f...