Da Chain Builder, puoi creare una catena per scaricare i dati da Schneider Electric® in Workiva, ad esempio le emissioni di gas serra (GHG) per il reporting ambientale, sociale e di governance (ESG) o di sostenibilità.
Prerequisiti
Per costruire questa catena, utilizzerai questi connettori centrali:
Nota: Tutti i connettori utilizzano il CloudRunner. Per questa catena non sono necessari GroundRunner.
Per scaricare i dati sulle emissioni, ti serviranno anche il nome utente e la password utilizzati per l'autenticazione di base con Schneider Electric.
Passo 1. Crea la catena
- Da Catene, clicca su Crea e seleziona Crea catena.
- In Impostazioni, inserisci un nome e una descrizione per identificare la catena.
- In Variabili, aggiungi delle variabili per specificare i dati da scaricare da Schneider Electric:
Nome Valore clientHierIds Inserisci l'ID della gerarchia dei clienti della tua azienda, come impostato per Schneider Electric in Resource Advisor. serviceIds Per scaricare i dati solo per una fonte specifica, inserisci l'ID della fonte GHG per cui scaricare i dati sulle emissioni. fromMonth Inserisci il primo mese del periodo di tempo per cui scaricare i dati, nel formato aaaa-MM.toMonth Inserisci l'ultimo mese del periodo di tempo per cui scaricare i dati, nel formato aaaa-MM.carbonMapType Inserisci la mappa del carbonio da Resource Advisor da utilizzare - Primaria o Secondaria. Se viene lasciato vuoto, il comando utilizza la mappa del carbonio primaria. emissionUOMId Inserisci l'unità di misura preferita da utilizzare per i dati sulle emissioni scaricati. emissionURL Inserisci l'URL dell'endpoint Schneider Electric API da cui richiedere i dati. - Clicca su Salva.
Passo 2. Iniziare con una richiesta HTTP
Per richiedere i dati da scaricare a Schneider Electric, inizia con un comando HTTP PUBBLICA.
- Sotto Connettori, seleziona HTTP, e sposta POST a Avvia.
- Seleziona il comando PUBBLICA e clicca su Modifica.
- In Informazioni di base, inserisci un nome e una descrizione per identificare il comando.
- In Proprietà dei comandi, seleziona il connettore Richiesta HTTP da utilizzare.
- Inserisci le proprietà del comando:
Proprietà Descrizione Nome utente Inserisci il nome utente utilizzato per l'autenticazione di base con Schneider Electric. Password Inserisci la password utilizzata per l'autenticazione di base con Schneider Electric. Mostra la risposta Seleziona questa casella. URL Seleziona la variabile emissionsURL in Catena. Tipo di contenuto Seleziona applicazione/json. Testo del corpo Inserisci la richiesta come stringa JavaScript Object Notation (JSON), selezionando la variabile applicabile in Catena come valore di ogni coppia nome/valore: { "clientHierIds": [<clientHierId variable>], "serviceIds": [<serviceIds variable>], "fromMonth": "<fromMonth variable>", "toMonth": "<toMonth variable>", "carbonMapType": "<carbonMapType variable>", "emissionsUOMId": "<emissionUOMId variable>" }Schema di output Inserisci la risposta JSON campione di 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" } - Clicca su Salva.
Passo 3. Aggiungi un comando Array a CSV
Per convertire la risposta JSON di Schneider Electric in un formato di valori separati da virgole (CSV), aggiungi il comando Array a CSV:
- Sotto Connettori, seleziona JSON e sposta Array in CSV nell'area di disegno.
- Trascina un link da Avvia al comando Array a CSV.
- Seleziona il comando Array a CSV e clicca su Modifica.
- In Informazioni di base, inserisci un nome e una descrizione per identificare il comando.
- In Proprietà dei comandi, seleziona il connettore JSON da utilizzare.
- Per i dati JSON, seleziona l'output Risposta del comando PUBBLICA.
- In Colonne, aggiungi le colonne per i dati scaricati da Schneider Electric:
Nome della colonna JSONPath utilizzo .usage emissioni .emissions - Per Delimitatore, seleziona Virgola.
- Clicca su Salva.
Passo 4. Aggiungi un comando Crea file
Per creare un file CSV dai dati, aggiungi un comando Crea file:
- In Connettori, seleziona Utilità file, e sposta Crea il file nell'area di disegno.
- Trascina un link dal comando Array a CSV al comando Crea file.
- Seleziona il comando Crea file e clicca su Modifica.
- In Informazioni di base, inserisci un nome e una descrizione per identificare il comando.
- In Proprietà dei comandi, seleziona il connettore Utilità dei file da utilizzare.
- Inserisci le proprietà del comando:
Proprietà Descrizione Testo Seleziona l'output File convertito del comando Array a CSV. Percorso del file Seleziona la variabile Chain.Workspace in Runtime e inserisci \e il nome del file con estensione.csv. - Clicca su Salva.
Passo 5. Aggiungi i comandi per utilizzare i dati in Workiva
Per utilizzare i dati CSV nella piattaforma Workiva, aggiungi i comandi del connettore Workiva per utilizzare l'output variabile File creato del comando Crea file con un foglio di calcolo o una tabella Wdata. Ad esempio, per aggiungere i dati di Schneider Electric come set di dati in una tabella Wdata, aggiungi un evento Esegui catena che utilizza una catena creata dai template Aggiorna set di dati in una tabella.
Passo 6. Pubblicare ed eseguire la catena
Per consentire l'esecuzione della catena:
- Clicca su Pubblica.
- Inserisci un commento sulla sua pubblicazione e clicca su Pubblica.
Per eseguire la catena:
- Da Catene, seleziona Modifica dal menu della catena.
- Clicca su Impostazioni catena, inserisci i valori delle variabili per specificare i dati da scaricare e clicca su Salva.
- Clicca su Esegui ed Esegui catena.