Scarica i dati delle utenze da Urjanet® per il reporting di sostenibilità

Urjanet Utility Cloud® consente alle aziende di agire sul proprio impatto climatico grazie a dati accurati e on-demand provenienti dai fornitori di servizi di tutto il mondo.

Con Workiva puoi creare catene per scaricare automaticamente i dati delle utenze da Urjanet in una tabella, in base a un periodo di tempo specificato in un foglio di calcolo personalizzato Foglio di controllo Urjanet. Puoi quindi utilizzare questa tabella come fonte per una query o una connessione a un foglio di calcolo per includere i suoi dati negli output del reporting ambientale, sociale e di governance (ESG) o di sostenibilità.

Nota: Mentre in queste istruzioni costruisci più catene, ne eseguirai solo una (che poi eseguirà automaticamente le altre) per scaricare i dati da Urjanet e aggiornare il foglio di calcolo.

Nota: Il foglio di calcolo Foglio di controllo Urjanet utilizzato da queste catene è fornito da Workiva. Se non ce l'hai ma sei interessato, contatta il tuo Customer Success Manager (CSM) per maggiori dettagli.

Prerequisiti

Per costruire queste catene, avrai bisogno di questi connettori:

Suggerimento: Tutti i comandi delle catene utilizzano il CloudRunner predefinito. Non sono necessari GroundRunner.

Per gestire con successo le catene, identifica anche:

Il nome utente e la password da utilizzare per autenticarsi e accedere ai servizi Urjanet
Gli ID del foglio di calcolo Foglio di controllo Urjanet, della sua sezione Foglio di controllo e della tabella collegata

Crea una catena per registrare i download dei dati

Per iniziare, costruisci una catena per aggiornare la sezione Foglio di controllo per tenere traccia di quando i dati delle utility vengono caricati su Workiva.

Passo 1. Crea la catena

Da Catene, clicca su Crea e seleziona Crea catena.
In Impostazione, inserisci il nome 3. Urjanet e una descrizione per identificare che la catena registra i dati di utility caricati.
Clicca su Salva.

Passo 2. Inizia con un evento di input di runtime

Da Eventi catena, sposta Input di runtime in Avvia.
Seleziona l'evento Input di runtime e clicca su Modifica.
In Informazioni di base, inserisci un nome e una descrizione per identificare l'evento.
In Variabili, aggiungi gli input TextField con questi nomi di visualizzazione:
- Gamma
- SpreadsheetID
- SheetID
Suggerimento: Lascia in bianco i valori predefiniti di queste variabili, che verranno generati quando eseguirai 1. La catena Urjanet è stata creata successivamente.
Seleziona Richiesto per tutte e tre le variabili e clicca su Salva.

Passo 3. Aggiungi un comando Crea file di Utilità dei file

Per creare il file di registro per la sezione Foglio di controllo, aggiungi un comando Crea file di Utilità dei file:

Da Connettori disponibili, seleziona Utilità file, e sposta Crea file nell'area di disegno.
Trascina un link da Input di runtime a 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.

Inserisci le proprietà del comando e clicca su Salva:

Proprietà	Valore
Connettore	Seleziona il connettore Utilità dei file da utilizzare.
Testo	Inserisci `Ultimo aggiornamento dei dati di utilizzo del sito` e seleziona la variabile di runtime System.DateTime.

Passo 4. Aggiungi un comando di scrittura dei dati del foglio Workiva

Per aggiornare la sezione Foglio di controllo con il file di log, aggiungi un comando Scrivi dati foglio Workiva:

Da Connettori disponibili, seleziona Workiva, e sposta Scrivi i dati del foglio nell'area di disegno.
Trascina un link da Crea file a Scrivi dati foglio.
Seleziona il comando Scrivi dati foglio e clicca su Modifica.
In Informazioni di base, inserisci un nome e una descrizione per identificare il comando.

Inserisci le proprietà del comando e clicca su Salva:

Proprietà	Valore
Connettore	Seleziona il connettore Workiva da utilizzare.
ID del foglio di calcolo	Seleziona l'input di runtime SpreadsheetID da Trigger.
ID/nome del foglio	Seleziona l'input di runtime SheetID da Trigger.
File di dati	Seleziona l'output File creato del comando Crea file.
Delimitatore	Inserisci una virgola (`,`).
Regione	Seleziona l'input di runtime Gamma da Trigger.

Clicca su Pubblica, inserisci una nota sulla pubblicazione e clicca su Pubblica.

Costruisci le catene a partire dal template Carica dati su Wdata

Quindi, utilizza il template Carica i dati su Wdata per creare delle catene per aggiornare la tabella collegata del foglio di calcolo Foglio di controllo Urjanet con i dati scaricati da Urjanet. Il template Carica i dati su Wdata crea catene che lavorano insieme per determinare se il set di dati esiste già nella tabella e aggiornare la tabella con il set di dati più recente.

Per creare le catene da Template, apri il template Carica i dati su Wdata | Catena primaria e clicca su Nuova catena.

Crea una catena per scaricare i dati da Urjanet

Infine, costruisci una catena per scaricare e importare i dati di utilità da Urjanet.

Nota: Crea le altre due catene prima di questa, per i suoi eventi Esegui catena.

Passo 1. Crea la catena

Da Catene, clicca su Crea e seleziona Crea catena.
In Impostazioni, inserisci il nome 1. Urjanet e una descrizione per aiutare a identificare ulteriormente la catena.

In Variabili, aggiungi le variabili per le tue credenziali Urjanet e gli ID del foglio di calcolo Foglio di controllo Urjanet e della sua sezione Foglio di controllo.

Nome	Valore
Urjanetusername	Inserisci il nome utente da utilizzare per accedere ai servizi Urjanet.
Urjanetpassword	Inserisci la password da utilizzare per accedere ai servizi Urjanet.
SpreadsheetID	Inserisci l'ID del foglio di calcolo Foglio di controllo Urjanet.
SheetID	Inserisci l'ID della sezione Foglio di controllo del foglio di calcolo.

Clicca su Salva.

Passo 2. Inizia con un comando Ottieni dati foglio di Workiva

Inizia con il comando Ottieni dati foglio di Workiva per identificare i dati da scaricare, in base al periodo di tempo del foglio di calcolo Foglio di controllo Urjanet:

Da Connettori disponibili, selezionare Workiva, e spostare Ottenere i dati del foglio a Avviare.
Seleziona il comando Ottieni dati del foglio e clicca su Modifica.
In Informazioni di base, inserisci un nome e una descrizione per identificare il comando.

Inserisci le proprietà del comando e clicca su Salva:

Proprietà	Valore
Connettore	Seleziona lo stesso connettore Workiva della catena precedente.
ID del foglio di calcolo	Seleziona la variabile di catena ID del foglio di calcolo.
ID/nome del foglio	Seleziona la variabile di catena ID foglio.
Regione	Inserisci `A11:E12`.
Stile di valore	Seleziona Calcolato.
Revisione	Per assicurarsi la versione più recente, inserire `-1`.

Passo 3. Aggiungi i comandi per preparare il periodo di tempo per Urjanet

Per identificare il periodo di tempo per Urjanet, aggiungi i comandi Query avanzata e CSV a JSON:

Da Connettori disponibili, seleziona Trasformazione tabellare e sposta Query avanzata nell'area di disegno.
Trascina un link da Ottieni dati del foglio a Query avanzata.
Seleziona il comando Query avanzata e clicca su Modifica.
In Informazioni di base, inserisci un nome e una descrizione per identificare il comando.

Inserisci le proprietà del comando e clicca su Salva:

Proprietà	Valore
Connettore	Seleziona il connettore di trasformazione tabellare da utilizzare.
Tabelle	Aggiungi la tabella per i dati del periodo di tempo: In File, seleziona l'output Dati del comando Ottieni dati foglio. In Nome tabella, inserisci `a`.
Query	Inserisci la query da eseguire: select case when `Start Month` = 'January' then '01-01' when `Start Month` = 'February' then '02-01' when `Start Month` = 'March' then '03-01' when `Start Month` = 'April' then '04-01' when `Start Month` = 'May' then '05-01' when `Start Month` = 'June' then '06-01' when `Start Month` = 'July' then '07-01' when `Start Month` = 'August' then '08-01' when `Start Month` = 'September' then '09-01' when `Start Month` = 'October' then '10-01' when `Start Month` = 'November' then '11-01' else '12-01' end as 'sm', case when `End Month` = 'January' then '01-31' when `End Month` = 'February' then '02-28' when `End Month` = 'March' then '03-31' when `End Month` = 'April' then '04-30' when `End Month` = 'May' then '05-31' when `End Month` = 'June' then '06-30' when `End Month` = 'July' then '07-31' when `End Month` = 'August' then '08-31' when `End Month` = 'September' then '09-30' when `End Month` = 'October' then '10-31' when `End Month` = 'November' then '11-30' else '12-31' end as 'em', `Reporting Year` as 'ry', TableId as 'tid' from a
Delimitatore input	Seleziona la virgola.
Delimitatore output	Seleziona la virgola.
Anteprima dei risultati	Seleziona questa casella di controllo.

Da Connettori disponibili, seleziona JSON, e sposta CSV in JSON nel canvas.
Trascina un link da Query avanzata a CSV a JSON.
Seleziona il comando CSV a JSON e clicca su Modifica.
In Informazioni di base, inserisci un nome e una descrizione per identificare il comando.
Inserisci le proprietà del comando e clicca su Salva:

Proprietà Valore

Connettore Seleziona il connettore JSON da utilizzare.

File di input Seleziona l'output Risultato del comando Query avanzata.

Delimitatore Seleziona virgola (,).

Passo 4. Aggiungi un comando PUBBLICA per inviare un token portatore a Urjanet

Per fornire a Urjanet il token portatore per l'autenticazione, aggiungi un comando HTTP PUBBLICA:

Da Connettori disponibili, seleziona HTTP, e sposta POST nell'area di disegno.
Trascina un link da CSV a JSON a PUBBLICA.
Seleziona il comando PUBBLICA e clicca su Modifica.
In Informazioni di base, inserisci un nome e una descrizione per identificare il comando.

Inserisci le proprietà del comando e clicca su Salva:

Proprietà	Valore
Connettore	Seleziona il connettore HTTP da utilizzare.
Mostra la risposta	Seleziona questa casella di controllo.
URL	Inserisci `https://api.urjanet.com/auth/login`.
Tipo di contenuto	Inserisci `applicazione/json`.
Testo del corpo	Inserisci la stringa per creare il token portatore: Inserisci `{"password":"`. Seleziona la variabile Urjanetpassword da Catena. Inserisci `", "username":"` Seleziona la variabile Urjanetusername da Catena. Inserisci `"}`.
Schema di output	Inserisci questo esempio di risposta: {"status":200,"message":"Authentication Successful","type":"Bearer","token":"abc","expires":"1694017012"}

Passo 5. Aggiungi i comandi per ottenere i siti da Urjanet

Per recuperare e analizzare i siti dal tuo account Urjanet, aggiungi i comandi HTTP OTTIENI e i comandi Template render testo di Handlebars:

Da Connettori disponibili, seleziona HTTP e sposta GET nell'area di disegno.
Trascina un link da PUBBLICA a OTTIENI.
Seleziona il comando OTTIENI e clicca su Modifica.
In Informazioni di base, inserisci un nome e una descrizione per identificare il comando.

Inserisci le proprietà del comando e clicca su Salva:

Proprietà	Valore
Connettore	Seleziona lo stesso connettore HTTP di prima.
Mostra la risposta	Seleziona questa casella di controllo.
URL	Inserisci `https://api.urjanet.com/utility/sites`.
Intestazioni	Aggiungi questa intestazione: In Chiave, inserisci `autorizzazione`. In Valore, seleziona Tipo e poi Token dall'output Risposta del comando PUBBLICA.
Tipo di contenuto	Inserisci `applicazione/json`.
Schema di output	Inserisci questo esempio di risposta: { "_embedded" : { "sites" : [ { "createdBy" : "jack.doe", "createdDate" : "2023-08-29T18:49:32.000+00:00", "entityId" : "1ee469cc-a606-d007-9415-eeeb8714a7ae", "facilityType" : "Office", "lastModifiedBy" : "jack.doe", "lastModifiedDate" : "2023-08-29T18:49:32.000+00:00", "region" : null, "serviceAddress" : { "addressType" : "RAW", "city" : "CHICAGO", "country" : "USA", "fullAddress" : "123 EVERGREEN TERRACE, CHICAGO, IL, 60603, USA", "postalCode" : "60603", "recipient" : null, "state" : "IL", "streetLine1" : "123 EVERGREEN TERRACE", "streetLine2" : null }, "siteCode" : "DIO", "siteName" : "Doe, Inc.", "siteNumber" : "1", "subRegion" : null, "_links" : { "self" : { "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae" }, "accounts" : { "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae/accounts" }, "credentials" : { "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae/credentials" }, "events" : { "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae/events" }, "meters" : { "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae/meters" }, "statements" : { "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae/statements" } } } ] }, "_links" : { "self" : { "href" : "https://api.urjanet.com/utility/sites?page=0&size=20" } }, "page" : { "size" : 20, "totalElements" : 1, "totalPages" : 1, "number" : 0 } }

Da Connettori disponibili, seleziona Maniglie, e sposta Modello di testo di rendering sulla tela.
Trascina un link da OTTIENI a Template render testo.
Seleziona il comando Template render testo e clicca su Modifica.
In Informazioni di base, inserisci un nome e una descrizione per identificare il comando.

Inserisci le proprietà del comando e clicca su Salva:

Proprietà	Valore
Connettore	Seleziona il connettore Handlebars da utilizzare.
Template	Inserisci questo template di testo: [{{#each a}} "{{entityId}}" {{#unless @last}}, {{/unless}}{{/each}}]
Variabili JSON	Aggiungi questa variabile: In Nome, inserisci `a`. In Valore, seleziona siti da _embedded dell'output Risposta del comando OTTIENI.

Passo 6. Aggiungi i comandi per richiedere i dati del sito a Urjanet

Per richiedere i dati del sito della tua azienda a Urjanet, aggiungi un altro comando HTTP PUBBLICA, seguito da un evento Interrompi catena per consentire l'elaborazione della richiesta:

Da Connettori disponibili, seleziona HTTP e sposta POST nell'area di disegno.
Trascina un link da Template render testo a PUBBLICA.
Seleziona il comando PUBBLICA e clicca su Modifica.
In Informazioni di base, inserisci un nome e una descrizione per identificare il comando.

Inserisci le proprietà del comando e clicca su Salva:

Proprietà	Valore
Connettore	Seleziona lo stesso connettore HTTP di prima.
Mostra la risposta	Seleziona questa casella di controllo.
URL	Inserisci `https://api.urjanet.com/utility/sites/downloads/usages`.
Tipo di contenuto	Inserisci `applicazione/json`.
Testo del corpo	Inserisci la stringa per creare il token portatore: Inserisci `{"siteIds":`. Seleziona l'output Testo renderizzato del comando Template render testo. Inserisci `, "startDate":"` Seleziona l'output File JSON del comando CSV a JSON e applica una trasformazione variabile Ottieni valore da JSON: In Output, seleziona Testo. In Valore, inserisci `0` e poi `ry`. Inserisci `-`. Seleziona l'output File JSON del comando CSV a JSON e applica una trasformazione variabile Ottieni valore da JSON: In Output, seleziona Testo. In Valore, inserisci `0` e poi `sm`. Inserisci `","endDate":"`. Seleziona l'output File JSON del comando CSV a JSON e applica una trasformazione variabile Ottieni valore da JSON: In Output, seleziona Testo. In Valore, inserisci `0` e poi `ry`. Inserisci `-`. Seleziona l'output File JSON del comando CSV a JSON e applica una trasformazione variabile Ottieni valore da JSON: In Output, seleziona Testo. In Valore, inserisci `0` e poi `em`. Inserisci `","outputFormat":"CSV"}`.
Intestazioni	Aggiungi due intestazioni: Un'intestazione autorizzazione: In Chiave, inserisci `autorizzazione`. In Valore, seleziona Tipo e poi Token dall'output Risposta del primo comando PUBBLICA. Un'intestazione accetta: In Chiave, inserisci `accetta`. In Valore, inserisci `applicazione/json`.
Schema di output	Inserisci questo esempio di risposta: { "createdDate" : "2023-09-19T15:11:09.944+00:00", "entityId" : "1ee56fec-3a9c-d96e-a849-a6c381b08d2b", "_links" : { "download" : { "href" : "https://api.urjanet.com/utility/downloads/1ee56fec-3a9c-d96e-a849-a6c381b08d2btpnu" } }}

Da Eventi catena, sposta Interrompi catena sull'area di disegno.
Trascina un link da PUBBLICA a Interrompi catena.
Seleziona l'evento Interrompi catena e clicca su Modifica.
In Informazioni di base, inserisci un nome e una descrizione per identificare il comando.
Inserisci i dettagli dell'evento e clicca su Salva:

Dettaglio Valore

Tempo di attesa Inserisci 6.

Unità di tempo di attesa Seleziona Secondi.

Passo 7. Aggiungi i comandi per scaricare i dati del sito come CSV

Per scaricare i dati del sito da Urjanet come file CSV, aggiungi un altro comando HTTP OTTIENI e un comando Mappa intestazioni di Trasformazione tabellare:

Da Connettori disponibili, seleziona HTTP e sposta GET nell'area di disegno.
Trascina un link da PUBBLICA a OTTIENI.
Seleziona il comando OTTIENI e clicca su Modifica.
In Informazioni di base, inserisci un nome e una descrizione per identificare il comando.

Inserisci le proprietà del comando e clicca su Salva:

Proprietà	Valore
Connettore	Seleziona lo stesso connettore di richiesta HTTP di prima.
Mostra la risposta	Seleziona questa casella di controllo.
URL	Seleziona href da _links dell'output Risposta del secondo comando PUBBLICA.
Intestazioni	Aggiungi questa intestazione: In Chiave, inserisci `autorizzazione`. In Valore, seleziona Tipo e poi Token dall'output Risposta del primo comando PUBBLICA.
Tipo di contenuto	Inserisci `applicazione/json`.

Da Connettori disponibili, seleziona Trasformazione tabellare, e sposta Intestazioni di mappa nell'area di disegno.
Trascina un link da OTTIENI a Mappa intestazioni.
Seleziona il comando Mappa intestazioni e clicca su Modifica.
In Informazioni di base, inserisci un nome e una descrizione per identificare il comando.

Inserisci le proprietà del comando e clicca su Salva:

Proprietà	Valore
Connettore	Seleziona lo stesso connettore Trasformazione tabellare di prima.
File di input	Seleziona l'output Risposta del secondo comando OTTIENI.
File di output	Inserisci `urjanet.csv`.
Anteprima dei risultati	Seleziona questa casella di controllo.
Delimitatore	Seleziona la virgola.
Intestazioni di input	Aggiungi le intestazioni del file CSV scaricato da Urjanet, in questo ordine: Id Dichiarazione Inizio intervallo Fine intervallo Tipo di servizio Id contatore Numero contatore Stato del contatore Numero di conto corrente grezzo Numero di conto normalizzato Nome del fornitore Indirizzo di servizio Città del servizio Stato del servizio Codice postale del servizio Paese di servizio Codice del sito Nome del sito Numero del sito Regione del sito Sotto regione del sito Tipo di struttura del sito Indirizzo del sito Città del sito Stato del sito Codice postale del sito Paese del sito Nome della tariffa Consumo Unità di misura del consumo Nome del fornitore aggiuntivo Numero di conto del fornitore aggiuntivo Classificazione del fornitore Spese totali Codice valuta Spese totali
Intestazioni output	Aggiungi le intestazioni corrispondenti alla tabella che conterrà i dati, in questo ordine: statement_id interval_start interval_end service_type meter_id meter_number meter_status raw_account_number normalized_account_number provider_name service_address service_city service_state service_postal_code service_country site_code site_name site_number site_region site_sub_region site_facility_type site_address site_city site_state site_postal_code site_country tariff_name consumption consumption_unit_of_measure additional_provider_name additional_provider_account_number provider_classification total_charges total_charges_currency_code

Passo 8. Aggiungi gli eventi della catena Esegui per le altre catene

Per caricare i dati in Wdata e registrare il caricamento nella sezione Foglio di controllo, aggiungi gli eventi Esegui catena per le catene create in precedenza:

Da Eventi catena, sposta Esegui catena sull'area di disegno.
Trascina un link da Mappa intestazioni a Esegui catena.
Seleziona l'evento Esegui catena e clicca su Modifica.
In Informazioni di base, inserisci un nome e una descrizione per identificare che l'evento carica i dati in Wdata.
In Catena da eseguire, seleziona Carica dati su Wdata | Catena primaria creata in precedenza dal template Carica dati su Wdata.

Inserisci gli input per il runtime della catena e clicca su Salva:

Input	Valore
ID tabella	Per fornire l'ID della tabella Wdata in cui caricare i dati, seleziona l'output File JSON del comando CSV a JSON e applica una trasformazione variabile Ottieni variabile da JSON: In Output, seleziona Testo. In Valore, inserisci `0` e `tid`.
Nome del file	Per definire il nome del set di dati da caricare, in base al periodo di tempo dei dati: Inserisci `Utilizzo del sito_`. Per il mese iniziale, seleziona l'output File JSON del comando CSV a JSON, inserisci un trattino (`-`) e seleziona nuovamente l'output File JSON del comando CSV a JSON. Inserisci un trattino basso (`_`). Per il mese finale, seleziona l'output File JSON del comando CSV a JSON, inserisci un trattino (`-`) e seleziona nuovamente l'output File JSON del comando CSV a JSON. Inserisci `.csv`. Per entrambi i mesi, clicca sul primo output File JSON e applica la trasformazione Ottieni variabile da JSON: In Output, seleziona Testo. In Valore, inserisci `0` e `ry`. Per entrambi i mesi, clicca sul secondo output File JSON e applica un'altra trasformazione Ottieni variabile da JSON: In Output, seleziona Testo. In Valore, inserisci `0` e `em`.
File di dati	Seleziona l'output Mappa intestazioni del comando Mappa intestazioni.
Metodo di carico	Seleziona Sostituisci set di dati.
Rollback	Seleziona questa casella di controllo.

Da Eventi catena, sposta un altro Esegui catena sull'area di disegno.
Trascina un collegamento dalla prima Esegui catena alla seconda.
Seleziona il secondo evento Esegui catena e clicca su Modifica.
In Informazioni di base, inserisci un nome e una descrizione per identificare che l'evento registra il caricamento dei dati nel foglio di calcolo Foglio di controllo Urjanet.
In Catena da eseguire, seleziona 3. Catena Urjanet creata in precedenza.
Inserisci gli input per il runtime della catena e clicca su Salva:

Input Valore

Gamma Inserisci F12:F12.

ID del foglio di calcolo Seleziona la variabile di catena SpreadsheetID.

ID foglio Seleziona la variabile di catena SheetID.
Clicca su Pubblica, inserisci eventuali note sulla pubblicazione e clicca su Pubblica.

Esegui le catene

Per aggiornare la tabella con i dati di utilità più recenti:

Dalla sezione Foglio di controllo del foglio di calcolo Foglio di controllo Urjanet, seleziona il periodo di tempo (mesi e anno) dei dati da scaricare da Urjanet.
Da Catene, seleziona 1. catena Urjanet e clicca su Esegui e Esegui catena.

Nota: Quando esegui questa catena, vengono automaticamente eseguite le altre due catene per aggiornare la tabella Wdata e il foglio di calcolo Foglio di controllo Urjanet con i dati.

Assistenza

Community

Centro assistenza di Workiva