Download emissiegegevens van Enablon® voor duurzaamheidsrapportage

Op Chain Builder kunt u een keten aanmaken om gegevens van Enablon® te downloaden, zoals uw uitstoot van broeikasgassen (BKG) voor milieu-, maatschappelijke en bestuursrapportage (ESG) of duurzaamheidsrapportage.

Vereisten

Om deze ketting te bouwen, gebruikt u deze kernverbinders:

HTTP-aanvraag connector
Bestandshulpprogramma's connector
XML connector
Workiva connector, als u de gegevens in een spreadsheet of Wdatatabel moet gebruiken

Opmerking: Alle opdrachten van deze keten gebruiken de standaard CloudRunner. Er is geen GroundRunner nodig.

Om de keten uit te voeren, hebt u gegevens van Enablon nodig om toegang te krijgen tot de gegevens:

Het SOAP (Simple Object Access Protocol) Application Programming Interface (API) eindpunt van Enablon dat gebruikt moet worden om de gegevens te downloaden
Het ID van de Enablon-omgeving waartoe toegang moet worden verkregen
De gebruikersnaam en het wachtwoord om toegang te krijgen tot de omgeving

Stap 1. Creëer de ketting

Ga naar Ketens, klik op Maken, en selecteer Keten maken.
Voer onder Setup een naam en beschrijving in om de keten en de bedoeling ervan te helpen identificeren.
Voeg onder Variabelen variabelen toe voor de Enablongegevens die nodig zijn om toegang te krijgen tot de gegevens:
- Eindpunt
  Tip: Voer voor de variabele Endpoint de standaardwaarde ExportData in of, om de gegevens in een 64-bits coderingsindeling te downloaden, ExportBinaryData.
- Milieu
- Gebruikersnaam
- Wachtwoord
Klik op Opslaan.

Stap 2. Begin met de Runtime Inputs triggergebeurtenis

Om de uitvoer elke keer dat de keten loopt te filteren, begint u met een Runtime Inputs event om de criteria van de te downloaden gegevens op te vragen.

Verplaats Runtime Inputs van onder Trigger Events naar Start.
Selecteer de gebeurtenis Runtime Inputs en klik op Bewerken.

Voeg de invoer toe aan het verzoek telkens wanneer de ketting wordt uitgevoerd:

Naam weergeven	type	Vereist?
Begindatum rapportperiode	Datumveld	Ja
Einddatum verslagperiode	Datumveld	Ja
Campagne	Tekstveld of Dropdownveld: TextField, voor een open tekstveld DropdownField, om te kiezen uit een specifieke lijst met opties	Ja
Entiteiten	Arrayveld	Ja

Klik op Opslaan.

Stap 3. Een HTTP Request connector POST commando toevoegen

Om de gegevens van het Enablon eindpunt op te halen, stelt u een HTTP connector POST opdracht in:

Klik onder Connectors op HTTP en verplaats de opdracht POST naar het canvas.
Sleep een koppeling van Start naar de opdracht POST .
Selecteer de opdracht POST en klik op Bewerken.
Selecteer onder Opdrachteigenschappen de te gebruiken HTTP connector.

Voer de eigenschappen van de opdracht in:

Eigendom	Beschrijving
Gebruikersnaam	Selecteer de variabele Gebruikersnaam onder Keten.
Wachtwoord	Selecteer de variabele Password onder Chain.
Reactie tonen	Vink dit vakje aan.
URL	Selecteer de variabele Endpoint onder Chain.
Type inhoud	Voer `text/xml` in.

In Body text voert u deze Extensible Markup Language (XML) syntaxis in:

<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">[Omgeving]</EnaHomeSite> <EnaUserName xsi:type="xsd:string">[Gebruikersnaam]</EnaUserName> <EnaPassword xsi:type="xsd:string">[Wachtwoord]</EnaPassword> </UserInfo> </soapenv:Header> <soapenv:Body> <enab:ExportData soapenv:encoding:Style="http://schemas.xmlsoap.org/soap/encoding/"&gt <Table>/sd/Entiteiten/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

Werk de XML-syntaxis bij met de runtime invoer- en kettingvariabelen:
- Vervang in de koptekst [Omgeving], [Gebruikersnaam], en [Wachtwoord] door hun respectievelijke variabelen onder Keten.
- Vervang in de body [ReportPeriodEndDate], [ReportPeriodStartDate], [Campaign], en [Entities] door hun runtime-invoer onder Trigger.
Klik op Opslaan.

Stap 4. De opdrachten Vinden en vervangen van de connector Bestandshulpprogramma's toevoegen

Om de gedownloade XML-gegevens voor te bereiden, voegt u File Utilities connector Find and replace opdrachten toe om de hoekhaken en pijpen te repareren.

Tip: Om de opdrachten Zoeken en vervangen gemakkelijk van elkaar te onderscheiden, voert u namen in om het teken aan te geven dat elke opdracht oplost, zoals "Hoekhaken zoeken en vervangen" of "Pijpen zoeken en vervangen".

Klik onder Connectors op File Utilities en verplaats de opdracht Find and replace naar het canvas.
Sleep een koppeling van de opdracht POST naar de opdracht Zoeken en vervangen .
Selecteer de opdracht Zoeken en vervangen en klik op bewerken.
Selecteer onder Command properties de connector File Utilities die u wilt gebruiken.
Voer de eigenschappen van de opdracht in en klik op Opslaan:

Eigendom Beschrijving

Bron Selecteer de uitvoer Response van de opdracht POST.

Zoeken Voer < in.

Vervangen Voer een starthoek in (<).

Syntax zoeken Selecteer Exact.
Klik onder Connectors op File Utilities en verplaats nog een opdracht Find and replace naar het canvas.
Sleep een koppeling tussen de opdrachten Zoeken en vervangen .
Selecteer de nieuwe opdracht Zoek en vervang en klik op Bewerk.
Selecteer onder Command properties dezelfde File Utilities connector.

Voer de eigenschappen van de opdracht in en klik op Opslaan:

Eigendom	Beschrijving
Bron	Selecteer de uitvoer Vervangen resultaat van de opdracht Zoeken en vervangen.
Zoeken	Voer `>` in.
Vervangen	Voer een starthoek in (`>`).
Syntax zoeken	Selecteer Exact.

Klik onder Connectors op File Utilities en verplaats nog een opdracht Find and replace naar het canvas.
Sleep een koppeling tussen de tweede en derde Opdrachten Zoeken en vervangen .
Selecteer de derde opdracht Zoeken en vervangen en klik op bewerken.
Selecteer onder Command properties dezelfde File Utilities connector.

Voer de eigenschappen van de opdracht in en klik op Opslaan:

Eigendom	Beschrijving
Bron	Selecteer het resultaat Vervangen van de tweede opdracht Zoeken en vervangen.
Zoeken	Voer `>` in.
Vervangen	Voer een pijp in (`\|`).
Syntax zoeken	Selecteer Exact.

Stap 5. Een XML-connector Element List toevoegen aan CSV-opdracht

Om de gedownloade XML naar gegevens in tabelvorm te converteren, voegt u een opdracht XML connector Element list to CSV toe:

Klik onder Connectors op XML en verplaats nog een opdracht Element list to CSV naar het canvas.
Sleep een koppeling van de derde opdracht Zoeken en vervangen naar de opdracht Elementenlijst naar CSV.
Selecteer de opdracht Element list to CSV en klik op Bewerken.
Selecteer onder Opdrachteigenschappen de connector XML die u wilt gebruiken.
Voer de eigenschappen van de opdracht in:

Eigendom Beschrijving

Bron Selecteer het resultaat Vervangen van de derde opdracht Zoeken en vervangen.

Pad naar root Enter //Document/opname.

Voorbeeld resultaat Vink dit vakje aan.
Voeg onder Kolommen de kolomnaam en het XPath voor elk element toe:

Kolomnaam XPath

Periode /ReportingPeriode

Indicator /Ref

IndNaam /IndicatorNaam

NumValue /WaardeAantal

Unit /Lokale Eenheid
Voer in Multi-value delimiter een komma in (,).
Klik op Opslaan.

Stap 6. Een opdracht Bestand toevoegen connector Bestand maken

Om een CSV-bestand (comma-separated values) te maken van de gegevens in tabelvorm, voegt u een Bestandshulpprogramma's connector Bestand maken opdracht toe:

Klik onder Connectors op File Utilities en verplaats de opdracht Create file naar het canvas.
Sleep een koppeling van de opdracht Elementenlijst naar CSV naar de opdracht Bestand maken .
Selecteer de opdracht Bestand maken en klik op Bewerken.
Selecteer onder Opdrachteigenschappen dezelfde connector Bestandshulpprogramma's als de opdrachten Zoeken en vervangen.
Voer de eigenschappen van de opdracht in en klik op Opslaan:

Eigendom Beschrijving

Tekst Selecteer de uitvoer Converted file van de opdracht Element list to CSV.

Bestandspad Selecteer de variabele Chain.Workspace onder Runtime en voeg \test.csv toe.

Stap 7. Opdrachten toevoegen om gegevens in Workiva te gebruiken

Om de CSV-gegevens in het Workiva-platform te gebruiken, voegt u Workiva connectoropdrachten toe om de Created file variabele uitvoer van de Create file opdracht te gebruiken met een spreadsheet of Wdatatabel. Om bijvoorbeeld de Enablon-gegevens als gegevensset aan een Wdatatabel toe te voegen, voegt u een gebeurtenis Run chain toe die een keten gebruikt die is gemaakt van de Update datasets in een tabel sjabloon.

Stap 8. De ketting publiceren en uitvoeren

Om de ketting te laten lopen:

Klik op Publiceren.
Voer opmerkingen over de publicatie in en klik op Publiceren.

De ketting laten lopen:

Ga naar Ketens, selecteer Bewerken in het menu van de keten.
Klik op Kettinginstellingen, voer de variabele waarden in en klik op Opslaan.
Opmerking: Voer voor de variabele Endpoint ExportData in of, om de gegevens in een 64-bits coderingsindeling te downloaden, ExportBinaryData.
Klik op Uitvoeren.
Ga naar Monitor, klik op Uitvoeren met invoer, voer de runtime-invoer in en klik op Start.

Ondersteuning

Community

Workiva-ondersteuningscentrum