Centro assistenza di Workiva

La piattaforma climatica aziendale Watershed ti permette di misurare, riportare e ridurre l'impronta di carbonio della tua organizzazione.

Con la Piattaforma Workiva, puoi creare catene per scaricare automaticamente i dati sull'impronta di carbonio da Watershed - ad esempio per la divulgazione nel tuo bilancio ambientale, sociale e di governance (ESG) o di sostenibilità - in una tabella, in base a un periodo di tempo specificato in un foglio di calcolo personalizzato Watershed. Potrai quindi utilizzare la tabella come fonte per una query o una connessione al foglio di calcolo, ad esempio per includere i dati nei report.

Nota: Mentre costruisci più catene in queste istruzioni, eseguirai solo una catena - che poi esegue automaticamente le altre - per scaricare i dati da Watershed e aggiornare il foglio di calcolo.

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

Prerequisiti

Per costruire queste catene, avrai bisogno di questi connettori:

• Connettore Workiva
• Connettore Trasformazione tabellare
• Connettore JSON
• Connettore di richiesta HTTP
• Connettore Utilità dei file

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

Per gestire con successo le catene, identifica anche:

• La chiave del provider di attività da utilizzare per autenticarsi ed eseguire azioni con l'API Watershed.
• Gli ID del foglio di calcolo Watershed , della sua sezione Control sheet e della tabella collegata

Crea una catena per registrare i download dei dati

Per iniziare, crea una catena per aggiornare la sezione Foglio di controllo per tenere traccia del caricamento dei dati dell'impronta di carbonio su Workiva.

Passo 1. Crea la catena

1. Da Catene, clicca su Crea e seleziona Crea catena.
   
2. In Impostazione, inserisci il nome 3. Watershed e una descrizione per identificare che la catena registra il caricamento dei dati Watershed.
   
3. Clicca su Salva.
   
   

Passo 2. Inizia con un evento di input di runtime

1. Da Eventi catena, sposta Input di runtime in Avvia.
2. Seleziona l'evento Input di runtime e clicca su Modifica.
3. In Informazioni di base, inserisci un nome e una descrizione per identificare l'evento.
   
4. 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. Catena Watershed creata in seguito.

5. 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:

1. Da Connettori disponibili, seleziona Utilità file, e sposta Crea file nell'area di disegno.
2. Trascina un link da Input di runtime a Crea file.
3. Seleziona il comando Crea file e clicca su Modifica.
4. In Informazioni di base, inserisci un nome e una descrizione per identificare il comando.
   
5. Inserisci le proprietà del comando e clicca su Salva:
   

   Proprietà	Valore
   Connettore	Seleziona il connettore Utilità dei file da utilizzare.
   Testo	Inserisci i dati di Footprint aggiornati l'ultima volta su 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:

1. Da Connettori disponibili, seleziona Workiva, e sposta Scrivi i dati del foglio nell'area di disegno.
2. Trascina un link da Crea file a Scrivi dati foglio.
3. Seleziona il comando Scrivi dati foglio e clicca su Modifica.
4. In Informazioni di base, inserisci un nome e una descrizione per identificare il comando.
5. 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.

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

Costruisci le catene a partire dal template Carica dati su Wdata

Quindi, usa il modello Load Data to Wdata per creare catene per aggiornare la tabella collegata del foglio Watershed con i dati scaricati da Watershed. 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.

Costruisci una catena per scaricare i dati da Watershed

Infine, costruisci una catena per scaricare e importare i dati dell'impronta di carbonio da Watershed.

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

Passo 1. Crea la catena

1. Da Catene, clicca su Crea e seleziona Crea catena.
2. In Impostazioni, inserisci il nome 1. Watershed e una descrizione che aiuti a identificare ulteriormente la catena.
   
3. In Variables, aggiungi le variabili per la chiave API di Watershed e gli ID del foglio di calcolo Watershed e del suo foglio di controllo.
   

   Nome	Valore
   Chiave API	Inserisci la chiave API di Watershed.
   SpreadsheetID	Inserisci l'ID del foglio di calcolo Watershed.
   SheetID	Inserisci l'ID della sezione Control sheet del foglio di calcolo Watershed.

4. Clicca su Salva.
   
   

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

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

1. Da Connettori disponibili, seleziona Workiva, e sposta Ottieni i dati del foglio a Avvia.
2. Seleziona il comando Ottieni dati del foglio e clicca su Modifica.
3. In Informazioni di base, inserisci un nome e una descrizione per identificare il comando.
4. Inserisci le proprietà del comando e clicca su Salva:
   
   

   Proprietà	Valore
   Connettore	Seleziona il connettore Workiva da utilizzare.
   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:.
   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 Watershed

Per identificare il periodo di tempo per Watershed, aggiungi i comandi Advanced query e CSV to JSON:

1. Da Connettori disponibili, seleziona Trasformazione tabellare e sposta Query avanzata nell'area di disegno.
2. Trascina un link da Ottieni dati del foglio a Query avanzata.
3. Seleziona il comando Query avanzata e clicca su Modifica.
4. In Informazioni di base, inserisci un nome e una descrizione per identificare il comando.
5. 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 `Mese iniziale` = 'Gennaio' then '01' when `Mese iniziale` = 'Febbraio' then '02' when `Mese iniziale` = 'Marzo' then '03' when `Mese iniziale` = 'Aprile' then '04' when `Mese iniziale` = 'Maggio' then '05' when `Mese iniziale` = 'Giugno' allora '06' quando `Mese di inizio` = 'Luglio' allora '07' quando `Mese di inizio` = 'Agosto' allora '08' quando `Mese di inizio` = 'Settembre' allora '09' quando `Mese di inizio` = 'Ottobre' allora '10' quando `Mese di inizio` = 'Novembre' allora '11' altrimenti '12' termina come 'sm', case quando `Fine Mese` = 'Gennaio' allora '01' quando `Fine Mese` = 'Febbraio' allora '02' quando `Fine Mese` = 'Marzo' allora '03' quando `Fine Mese` = 'Aprile' allora '04' quando `Fine Mese` = 'Maggio' allora '05' quando `Fine Mese` = 'Giugno' allora '06' quando `Fine Mese` = 'Luglio' allora '07' quando `Fine Mese` = 'Agosto' allora '08' quando `Fine Mese` = 'Settembre' allora '09' quando `Fine Mese` = 'Ottobre' allora '10' quando `Fine Mese` = 'Novembre' allora '11' altrimenti '12' fine come 'em', `Anno di riferimento` come 'ry', TableId come 'tid' da a
   Delimitatore input	Seleziona la virgola.
   Delimitatore output	Seleziona la virgola.
   Anteprima dei risultati	Seleziona questa casella di controllo.

6. Da Connettori disponibili, seleziona JSON, e sposta CSV in JSON nel canvas.
7. Trascina un link da Query avanzata a CSV a JSON.
8. Seleziona il comando CSV a JSON e clicca su Modifica.
9. In Informazioni di base, inserisci un nome e una descrizione per identificare il comando.
   
10. 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 HTTP Request GET

Per scaricare i dati sull'impronta di carbonio per il periodo di tempo selezionato, aggiungi un comando HTTP Request GET:

1. Da Connettori disponibili, seleziona Richiesta HTTP e sposta GET nell'area di disegno.
2. Trascina un link da CSV a JSON a GET.
3. Seleziona il comando OTTIENI e clicca su Modifica.
4. In Informazioni di base, inserisci un nome e una descrizione per identificare il comando.
5. Inserisci le proprietà del comando e clicca su Salva:
   
   

   Proprietà	Valore
   Connettore	Seleziona il connettore HTTP Request da utilizzare.
   Mostra la risposta	Seleziona questa casella di controllo.
   URL	Inserisci https://api.watershedclimate.com/v1/report/footprint_detail.
   Stringa di query	Inserisci la stringa di query per indicare i mesi iniziali e finali dei dati da scaricare: Per il mese iniziale, inserisci startMonth=, e seleziona il file JSON prodotto dal comando CSV to JSON due volte. Poi, per il mese finale, inserisci &endMonth=, e seleziona il file JSON output del comando CSV to JSON altre due volte. 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 Value, inserisci 0 e sm.
   Intestazioni	Aggiungi un'intestazione: In Chiave, inserisci Autorizzazione. In Value, inserisci Bearer , quindi seleziona la variabile di catena APIKey.
   Tipo di contenuto	Inserisci applicazione/json.

Passo 5. Aggiungi eventi della catena Run per eseguire e registrare il caricamento dei dati

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:

1. Da Eventi catena, sposta Esegui catena sull'area di disegno.
2. Trascina un link da GET a Esegui la catena.
3. Seleziona l'evento Esegui catena e clicca su Modifica.
4. In Informazioni di base, inserisci un nome e una descrizione per identificare che l'evento carica i dati in Wdata.
5. In Catena da eseguire, seleziona Carica dati su Wdata | Catena primaria creata in precedenza dal template Carica dati su Wdata.
   
6. Inserisci gli input per il runtime della catena e clicca su Salva:

   Input	Valore
   ID tabella	Per fornire l'ID della tabella Wdata su cui caricare i dati: Seleziona l'output File JSON del comando CSV a JSON. Clicca sull'output JSON file e applica la trasformazione Get variable from JSON: In Output, seleziona Testo. In Valore, inserisci 0 e tid.
   Prefisso del file	Per definire il prefisso del set di dati da caricare, in base al periodo di tempo dei dati: Per il mese di inizio, seleziona due volte il file JSON emesso dal comando CSV to JSON. Inserisci un trattino basso (_). Per la fine del mese, seleziona il file JSON in uscita dal comando CSV to JSON altre due volte. 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 Value, inserisci 0 e sm.
   File di dati	Seleziona l'output Response del comando GET.
   Metodo di carico	Seleziona Sostituisci set di dati.
   Rollback	Seleziona questa casella di controllo.

7. Da Eventi catena, sposta un altro Esegui catena sull'area di disegno.
8. Trascina un collegamento dalla prima Esegui catena alla seconda.
9. Seleziona il secondo evento Esegui catena e clicca su Modifica.
10. In Basic info, inserisci un nome e una descrizione per identificare l'evento che registra il caricamento dei dati nel foglio di calcolo Watershed.
11. In Catena da eseguire, seleziona 3. Catena Watershed creata in precedenza.
    
12. 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.

13. Clicca su Pubblica, inserisci eventuali note sulla pubblicazione e clicca su Pubblica.
    
    

Esegui le catene

Per aggiornare il foglio di calcolo Watershed con i dati più recenti sull'impronta di carbonio:

1. Dalla sezione Control sheet del foglio di calcolo Watershed, seleziona il periodo - mesi e anno - dei dati da scaricare da Watershed.
   
2. Da Wdata Chains, seleziona la catena 1. Watershed e clicca su . Catena Watershed e clicca su Esegui e Esegui la catena.
   
   

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