Avanzamento dei fogli di calcolo delle fonti di dati sulla sostenibilità con le catene

Da Chain Builder, puoi utilizzare questi modelli di catena che insieme semplificano il roll forward dei dati ambientali, sociali e di governance (ESG) o di sostenibilità:

1a. Roll forward ESG | Primario | Inizia qui
1b. Roll forward ESG | Aggiorna le connessioni e gli stati
1c. Roll forward ESG | Aggiorna connessione | Esecuzione

Suggerimento: Mentre crei tre catene da questi template, eseguirai solo la prima catena creata, che le esegue automaticamente tutte.

Nota: Queste catene inoltrano solo i fogli di calcolo della raccolta dati - non a Programma di sostenibilità. Per imparare a riportare i valori in un Programma, visualizza Riportare e gestire gli anni di rendicontazione nel Programma di sostenibilità.

Quando esegui le catene create da questi modelli, esse lavorano insieme per archiviare e importare automaticamente il set di dati dell'anno precedente in una tabella. Quando esegui le catene, puoi anche scegliere di:

Aggiornare le connessioni del foglio di calcolo di origine prima di importare il set di dati, ad esempio per assicurarti i valori più recenti
Cancellare i valori nel foglio di calcolo della fonte (ad eccezione di quelli collegati alle fonti o alle destinazioni), ad esempio per preparare la raccolta dati dell'anno successivo

Nota: Queste catene sostituiscono automaticamente qualsiasi set di dati dello stesso periodo nella tabella Wdata collegata. Se si verifica un errore durante l'importazione del nuovo set di dati, la tabella torna al set di dati precedente.

Prerequisiti

Le catene create da questi template richiedono connettori specifici per eseguire i comandi.

Prima di creare catene da questi template, imposta questi connettori in Builder catena:

Nota: Tutti i connettori utilizzati nelle catene di questi template utilizzano il CloudRunner predefinito. Non sono necessari GroundRunner.

Nota: Per eseguire i suoi comandi, il connettore HTTP Request richiede il client ID e il segreto della concessione OAuth creato per l'utente di integrazione del connettore Workiva. Assicurati che la concessione OAuth abbia lo scope appropriato.

Passo 1. Imposta i file di Workiva

Le catene create da questi modelli richiedono una configurazione specifica dei file di Workiva per i dati sulla sostenibilità. Prima di eseguire le catene di questi modelli, imposta i file di Workiva per la raccolta e l'inoltro dei dati:

In Fogli di calcolo, identifica il foglio di raccolta dati utilizzato per il reporting di sostenibilità.
In Wdata, crea una tabella che utilizza il foglio di calcolo come set di dati collegato e registra l'ID della tabella per l'esecuzione delle catene.
Nel foglio di calcolo, aggiungi un foglio per monitorare lo stato di aggiornamento della connessione in uscita alla tabella Wdata e registra il nome del foglio per quando eseguirai le catene.
Crea una query da eseguire quando le catene archiviano i dati:
- Utilizza la tabella Wdata collegata al foglio di calcolo di raccolta dati come fonte di dati.
- Nella query, includi un parametro di selezione multipla per l'Anno, con lo stesso tipo di dati della colonna Anno della tabella.
- Registra l'ID della query per quando eseguirai le catene.

Passo 2. Determina i valori delle variabili e degli input di runtime

Per consentire alle catene di lavorare con più workspace, si utilizzano delle variabili per identificare l'utente e gli ambienti di integrazione per il connettore Workiva. In Builder catena, crea queste variabili del workspace:

Variabile	Valore
wsv-ClientID	L'ID del client della concessione OAuth2 creato per l'utente dell'integrazione Workiva
wsv-ClientSecret	Il segreto del client generato per la concessione OAuth2 creato per l'utente dell'integrazione
wsv-BaseURL-Wdata	L'URL host base e il percorso base per i comandi Wdata, in base alla regione dell'ambiente: USA: `https://h.app.wdesk.com/s/cerebral` UE: `https://h.eu.wdesk.com/s/cerebral` APAC: `https://h.apac.wdesk.com/s/cerebral`
wsv-BaseURL-IAM	L'URL host base e il percorso base per i comandi di Identity and Access Management, in base alla regione dell'ambiente: USA: `https://api.app.wdesk.com/iam/v1/oauth2/token` UE: `https://api.eu.wdesk.com/iam/v1/oauth2/token` APAC: `https://api.apac.wdesk.com/iam/v1/oauth2/token`
wsv-BaseURL-OC	L'URL host base e il percorso base per i comandi di Catene, in base alla regione dell'ambiente: USA: `https://h.app.wdesk.com/s/wdata/oc/api/` UE: `https://h.eu.wdesk.com/s/wdata/oc/api/` APAC: `https://h.apac.wdesk.com/s/wdata/oc/api/`

Quando esegui la catena creata in 1a. Il template Roll forward ESG | Primario | Inizia qui richiede input di runtime per identificare i file di Workiva con cui interagire e come identificare il set di dati:

Input di runtime	Valore
Raccolta dati - ID tabella di roll forward	L'ID della tabella Wdata - collegata al foglio elettronico di raccolta dati - in cui importare il set di dati
Raccolta dei dati: ID della query di roll forward	L'ID della query Wdata da eseguire per archiviare i dati
Anno PY	L'anno dei dati da archiviare
Valore del tag	Il nome del set di dati archiviato Nota: Le catene utilizzano l'input Valore del tag con l'input Anno PY per creare il nome del file del set di dati, come `[Valore tag]_[Anno PY].csv`. Ad esempio, se l'anno PY è il 2021 e il valore del tag è Archiviato, il nome del file sarà `Archiviato_2021.csv`.
Status—SheetName	Il nome del foglio che tiene traccia dello stato di aggiornamento della connessione in uscita del foglio di calcolo alla tabella Wdata

Passo 3. Crea le catene

Per creare le catene necessarie all'avanzamento della raccolta dei dati, utilizza il sito 1a. Roll forward ESG | Primario | Inizia qui:

Da Template in Builder catena, apri 1a. Roll forward ESG | Primario | Inizia qui e clicca su Nuova catena.
Inserisci un nome per identificare la catena.
Seleziona l'ambiente in cui utilizzare la catena e clicca su Avanti.
Per la variabile dcv-clearSuccess, inserisci il nome dvc-clearSuccess e clicca su Avanti.
Per ogni connessione, seleziona il connettore da utilizzare e clicca su Catena successiva.
Nota: Per ogni connettore, utilizza il CloudRunner predefinito.

Imposta ogni variabile e clicca su Avanti.

Variabile	Tipo di variabile	Nuova variabile
wsv-ClientID	Workspace	Seleziona wsv-ClientID.
cv-TimeToCheck	Catena	`cv-TimeToCheck`
wsv-ClientSecret	Workspace	Seleziona wsv-ClientSecret.
dcv-RefreshStatus	Catena dinamica	`dcv-RefreshStatus`
wsv-BaseURL-IAM	Workspace	Seleziona wsv-BaseURL-IAM.
wsv-BaseURL-OC	Workspace	Seleziona wsv-BaseURL-OC.

Per ogni connessione, seleziona il connettore da utilizzare e clicca su Catena successiva.
Nota: Per ogni connettore, utilizza il CloudRunner predefinito.

Imposta ogni variabile e clicca su Avanti.

Variabile	Tipo di variabile	Nuova variabile
dcv-srcStatus	Catena dinamica	`dcv-srcStatus`
wsv-ClientID	Workspace	Seleziona wsv-ClientID.
dcv-destStatus	Catena dinamica	`dcv-destStatus`
wsv-ClientSecret	Workspace	Seleziona wsv-ClientSecret.
wsv-BaseURL-Wdata	Workspace	Seleziona wsv-BaseURL-Wdata.
wsv-BaseURL-IAM	Workspace	Seleziona wsv-BaseURL-IAM.

Per ogni connessione, seleziona il connettore da utilizzare e clicca su Invia.
Nota: Per ogni connettore, utilizza il CloudRunner predefinito.

Passo 4. Pubblicare le catene

Nota: Per facilitare l'installazione, il template Aggiorna connessioni e stato ha un evento Esegui catena. Prima di pubblicare le catene create dai template, elimina questo evento estraneo Esegui catena.

Da Catene, per la catena creata dal templateAggiorna connessioni e stato, seleziona Modifica.
Seleziona l'evento Esegui catena - Elimina e clicca su Elimina ed Elimina.
Clicca su Pubblica e Pubblica.
Da Catene, per la catena creata dal template Primario, seleziona Modifica.
Clicca su Pubblica e Pubblica.
Da Catene, per la catena creata dal template Esecuzione, seleziona Modifica.
Clicca su Pubblica e Pubblica.

Esegui le catene

Per archiviare i dati e prepararsi alla raccolta dati dell'anno successivo:

In Builder catena, da Catene, seleziona Esegui per la catena creata dal template 1a.Roll forward ESG | Primario | Inizia qui.

Clicca su Esegui con gli input e inserisci gli input di runtime:

Input di runtime	Valore
Raccolta dati - ID tabella di roll forward	Inserisci l'ID della tabella Wdata in cui importare il set di dati.
Raccolta dei dati: ID della query di roll forward	Inserisci l'ID della query da eseguire per archiviare i dati.
Anno PY	Inserisci l'anno dei dati da archiviare.
Valore del tag	Inserisci il nome del set di dati archiviato. Nota: Con l'input Anno PY, questo input crea il nome del file del set di dati come `[Valore tag]_[Anno PY].csv`. Ad esempio, se l'anno PY è il 2021 e il valore del tag è Archiviato, il nome del file sarà `Archiviato_2021.csv`.
Aggiorna le connessioni dei fogli prima dell'archiviazione dei dati	Seleziona se aggiornare le connessioni in uscita del foglio di calcolo alla tabella Wdata prima dell'esecuzione della query di roll forward, ad esempio per aggiornare il set di dati prima dell'archiviazione.
Status—SheetName	Inserisci il nome del foglio che tiene traccia dello stato di aggiornamento delle connessioni in uscita dal foglio di calcolo alla tabella Wdata.
RefreshExecution-ChainName	Inserisci il nome della catena creata dal template Roll forward ESG \| Aggiorna connessione \| Esecuzione.
Cancella la colonna Valore del foglio di calcolo	Seleziona se eliminare i valori di input dal foglio di calcolo come parte del roll forward. Nota: Non verranno eliminati i valori con un link di origine o di destinazione.

Per assicurarsi che vi siano i valori più recenti prima di importare il set di dati, seleziona Aggiorna le connessioni prima dell'archiviazione dei dati.

Se selezioni questa opzione, le catene aggiornano le connessioni in uscita del foglio di calcolo e tengono traccia del loro stato di aggiornamento in un foglio di controllo:
- In Status—SheetName, inserisci il nome del foglio nel foglio di calcolo di origine in cui le catene possono salvare lo stato di aggiornamento delle connessioni in uscita.
- In RefreshExecution—ChainName, inserisci il nome della catena creata dal template Roll forward ESG | Aggiorna connessione | Esecuzione.
Suggerimento: L'aggiornamento può richiedere fino a qualche minuto, a seconda del numero di connessioni in uscita del foglio di calcolo. Per regolare il tempo di attesa, modifica l'evento Interrompi catena della catena creata dal template 1b. Roll forward ESG | Aggiorna le connessioni e gli stati.
Per eliminare i valori di input dal foglio di calcolo di origine come parte dell'archiviazione, ad esempio per preparare la raccolta dati dell'anno successivo, seleziona Cancella la colonna dei valori del foglio di calcolo.

Nota: La catena conserva tutti i valori collegati a una sorgente o a una destinazione. Non è possibile recuperare i valori eliminati dal foglio di calcolo. Ti consigliamo di selezionare questa opzione solo per il roll forward finale dell'anno, per preparare il foglio di calcolo per la raccolta dati dell'anno successivo.

Suggerimento: Per impostazione predefinita, la catena elimina i valori a partire dalla riga 2 dei fogli del foglio di calcolo. Per regolare questo aspetto, modifica la proprietà Regione del comando Cancella dati foglio.
Clicca su Avvia.

Assistenza

Community

Centro assistenza di Workiva