Vanaf Chain Builder kunt u een keten aanmaken om gegevens van Schneider Electric® in Workiva 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:
Opmerking: Alle connectors gebruiken de CloudRunner. Voor deze ketting zijn geen GroundRunners nodig.
Om emissiegegevens te downloaden, hebt u ook de gebruikersnaam en het wachtwoord nodig die u gebruikt voor de basisauthenticatie bij Schneider Electric.
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 te identificeren.
- Voeg onder Variabelen variabelen toe om de gegevens te specificeren die van Schneider Electric moeten worden gedownload:
Naam Waarde clientHierIds Voer de ID van de klanthiërarchie van uw bedrijf in, zoals ingesteld voor Schneider Electric in Resource Advisor. serviceIds Als u alleen gegevens voor een specifieke bron wilt downloaden, voert u het ID van de broeikasgasbron in waarvoor u emissiegegevens wilt downloaden. vanmaand Voer de vroegste maand in van de periode waarvoor u gegevens wilt downloaden, in een formaat jjjj-MM.toMonth Voer de laatste maand in van de periode waarvoor u gegevens wilt downloaden, in een formaat jjjj-MM.carbonMapType Voer de koolstofkaart van Resource Advisor in die u wilt gebruiken - Primair of Secundair. Indien leeg gelaten, gebruikt de opdracht de primaire koolstofkaart. emissieUOMId Voer de gewenste meeteenheid in voor gebruik bij gedownloade emissiegegevens. emissieURL Voer de URL in van Schneider Electric API endpoint om gegevens op te vragen. - Klik op Opslaan.
Stap 2. Begin met een HTTP-verzoek
Om de te downloaden gegevens van Schneider Electric op te vragen, begint u met een opdracht HTTP POST.
- Selecteer onder Connectors HTTP, en verplaats POST naar Start.
- Selecteer de opdracht POST en klik op Bewerken.
- Voer onder Basisinfo een naam en beschrijving in om de opdracht te helpen identificeren.
- Selecteer onder Command properties de HTTP Request connector die u wilt gebruiken.
- Voer de eigenschappen van de opdracht in:
Eigendom Beschrijving Gebruikersnaam Voer de gebruikersnaam in die wordt gebruikt voor de basisverificatie bij Schneider Electric. Wachtwoord Voer het wachtwoord in dat wordt gebruikt voor de basisverificatie bij Schneider Electric. Reactie tonen Vink dit vakje aan. URL Selecteer de variabele emissionsURL onder Chain. Type inhoud Selecteer application/json. Tekst Voer het verzoek in als een JavaScript Object Notation (JSON)-string en selecteer de toepasselijke variabele onder Chain als de waarde van elk naam-/waardepaar: {"clientHierIds": [<clientHierId variabele>], "serviceIds": [<serviceIds variabele>], "fromMonth": "<fromMonth variabele>", "toMonth": "<toMonth variabele>", "carbonMapType": "<carbonMapType variabele>", "emissionsUOMId": "<emissionUOMId variabele>" }Uitvoer schema Geef het voorbeeld van de JSON-respons van 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" } - Klik op Opslaan.
Stap 3. Een matrix aan CSV toevoegen
Voeg een opdracht Array to CSV toe om het JSON-antwoord van Schneider Electric te converteren naar een CSV-indeling (comma-separated values):
- Selecteer onder Connectors JSON, en verplaats Array to CSV naar het canvas.
- Sleep een koppeling van Start naar de opdracht Array to CSV.
- Selecteer de opdracht Array to CSV en klik op Bewerken.
- Voer onder Basisinfo een naam en beschrijving in om de opdracht te helpen identificeren.
- Selecteer onder Opdrachteigenschappen de JSON-connector die u wilt gebruiken.
- Selecteer voor JSON-gegevens de uitvoer Response van de opdracht POST.
- Voeg onder Kolommen kolommen toe voor de gegevens die u van Schneider Electric hebt gedownload:
Kolomnaam JSONPath gebruik .gebruik uitstoot .emissies - Selecteer bij Scheidingsteken de komma.
- Klik op Opslaan.
Stap 4. Een opdracht Bestand maken toevoegen
Om een CSV-bestand van de gegevens te maken, voegt u een opdracht Bestand maken toe:
- Selecteer onder Connectors, File Utilities, en verplaats Create file naar het canvas.
- Sleep een koppeling van de opdracht Array to CSV naar de opdracht Bestand maken.
- Selecteer de opdracht Bestand maken en klik op Bewerken.
- Voer onder Basisinfo een naam en beschrijving in om de opdracht te helpen identificeren.
- Selecteer onder Command properties de File Utilities connector die u wilt gebruiken.
- Voer de eigenschappen van de opdracht in:
Eigendom Beschrijving Tekst Selecteer de uitvoer Geconverteerd bestand van de opdracht Array to CSV. Bestandspad Selecteer de variabele Chain.Workspace onder Runtime en voer en de bestandsnaam in met een.csvextensie. - Klik op Opslaan.
Stap 5. 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. Als u bijvoorbeeld de Schneider Electric-gegevens wilt toevoegen als gegevensset in een Wdatatabel, voegt u een gebeurtenis Run chain toe die gebruikmaakt van een keten die is gemaakt van de Update datasets in een tabel sjabloon.
Stap 6. 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 Keteninstellingen, voer de variabele waarden in om de te downloaden gegevens te specificeren en klik op Opslaan.
- Klik op Uitvoeren en Uitvoeren keten.