Usa i dati del Programma di sostenibilità nelle query

Da Wdata, puoi creare query basate sui dati di Programma di Sostenibilità, tra cui:

Argomenti, metriche, valori e attività
Dimensioni personalizzate disponibili per i valori metrici
Tag personalizzati disponibili per le metriche

Con queste query puoi:

Esplora i tuoi dati sulla sostenibilità attraverso una lente mirata, utilizzando i filtri e i parametri .
Collega i risultati a un foglio di calcolo, ad esempio per esportare i dati sulla sostenibilità in un file o per fornire collegamenti alle fonti dei report.
Fornire un contesto aggiuntivo per i tag o le dimensioni delle metriche.

Aggiungi Programma come fonte di query

Per utilizzare i dati di un Programma in una query:

From the query's Sources panel, click Add sources, and select Add program data.
Dal pannello Fonti della query, clicca su Nuova fonte e seleziona i dati da includere nei risultati:
- Per includere i dati relativi a un Programma e ai suoi argomenti, metriche, valori o compiti, seleziona Sostenibilità, Programma di sostenibilità.
- Per includere i dati relativi alle dimensioni personalizzate disponibili per i valori metrici di un programma, seleziona Sostenibilità, Dimensioni del programma.
- Per includere i dati relativi ai tag personalizzati disponibili per le metriche di un Programma, seleziona Sostenibilità, Tag del programma.
Suggerimento: Per ottenere un contesto aggiuntivo sulle dimensioni o sui tag delle metriche di un programma, aggiungi i dati del programma e i dati delle sue dimensioni o tag come fonti e crea una relazione per unirli.
Cerca e seleziona il Programma da utilizzare nella query e clicca su Aggiungi.

Dal pannello Fonti specifica come utilizzare le colonne di dati nella query:

Per utilizzare le colonne come risultati in generatore, selezionale e poi seleziona Aggiungi ai campi o trascinale nella scheda Campi.

Per utilizzare le colonne come filtri nel Builder, selezionale e poi seleziona Aggiungi ai filtri o trascinale nella scheda Filtri.

Ad esempio, per una query con fonte Programma di sostenibilità:

Filtro	Restituzioni
Anno del programma	Solo i valori raccolti per anni specifici
Dimensioni	Solo le metriche con specifiche dimensioni personalizzate applicate e i valori raccolti per tali dimensioni
Stato dell’attività	Solo le attività con specifici stati di raccolta dati

Per includere una colonna nell'istruzione della query in SQL, fai clic con il tasto destro del mouse e seleziona Aggiungi alla query.

Crea la query come necessario.

Colonne dell'origine

Quando aggiungi i dati del Programma come fonte, puoi includere le colonne dei suoi dati nei risultati della query.

Quando selezioni Aggiungi i dati del programma come fonte, la query può includere queste colonne:

Colonna	Descrizione	Tipo
Nome del programma	Il nome del programma	Testo
Anno del programma	L'anno dei dati del Programma	Numero intero
Nome della metrica	Il nome di una metrica all'interno di un argomento del Programma	Testo
Codice metrico	L'identificatore univoco generato per una metrica	Testo
Tipo di metrica	Il tipo di valore raccolto per una metrica: testo, valuta, numero, percentuale o data.	Testo
Descrizione della metrica	La descrizione inserita per una metrica	Testo
Dimensioni	Il nome e il valore della dimensione personalizzata applicata a un valore metrico, come ad esempio `{"Località": "Sud"}` Suggerimento: Se le tue metriche supportano più dimensioni, puoi utilizzare i campi Nome dimensione e Valore dimensione per ottenere colonne separate per i nomi e i valori delle dimensioni.	Testo
Valore-testo	Il valore inserito per una metrica, come testo	Testo
Valore-numero	Il valore quantitativo inserito per una metrica, come numero	Decimale
Unità	Per una metrica con un tipo di valuta, numero o percentuale, la sua unità di misura	Testo
Allegati a sostegno	I nomi dei file degli allegati caricati per un valore metrico Nota: Se un valore ha più allegati, i nomi dei file vengono visualizzati come un elenco separato da virgole. I risultati includono solo gli allegati caricati; non compaiono file Workiva o indirizzi web allegati.	Testo
Tipo di fonte	Come viene fornito il valore della metrica: Manuale, se inserito direttamente nel computo metrico Fonte collegata, se proveniente da un foglio di calcolo o documento collegato a Attività, se da Workiva Tasks	Testo
File di origine	Per una metrica con un file sorgente collegato, il nome della fonte	Testo
Sezione di origine	Per una metrica con un file sorgente collegato, il nome della sezione del file sorgente in cui compare il valore	Testo
Framework	Tutti i contenuti di Sustainability Explorer collegati fanno riferimento a una metrica Suggerimento: Per integrare i contenuti collegati con ulteriori dettagli da Sustainability Explorer, aggiungere Sustainability Explorer come fonte di query.	Testo
Nome dell’attività	Il nome dell'attività di raccolta dati creata per il valore di una metrica	Testo
Assegnatario dell'attività	Il nome utente del membro dell'area di lavoro a cui è stato assegnato il compito di raccogliere il valore della metrica Nota: Se un valore ha più assegnatari, questi appaiono come un elenco separato da virgole, ad esempio `homer@org.com,marge@org.com`. Se la tua ricerca restituisce solo un membro per più assegnatari, contatta il tuo Customer Success Manager (CSM) di Workiva.	Testo
Approvatore dell'attività	Il nome utente del membro dell'area di lavoro a cui è stato assegnato il compito di approvare il valore raccolto per una metrica. Se un valore ha più approvatori o fasi di approvazione: Una virgola (,) separa gli approvatori selezionati per un passo specifico, ad esempio `homer@org.com,marge@org.com` Un tubo (\|) separa gli approvatori selezionati per ogni passo - ad esempio `homer@org.com, marge@org.com \| bart@org.com, lisa@org.com` - in sequenza di approvazione	Testo
Scadenza dell'attività	La data di scadenza dell'attività di raccolta dati di un valore	Data
Data di scadenza dell'attività di approvazione	La data di scadenza dell'attività di approvazione di un valore Suggerimento: Se un valore ha più fasi di approvazione, questa è la data di scadenza per la sua approvazione finale.	Data
Stato dell’attività	Lo stato generale della raccolta dati di un valore, ad esempio Non iniziata, In corso o Completata	Testo
Istruzioni dell’attività	Le istruzioni inserite per l'assegnatario e l'approvatore di un valore metrico	Testo
Note	Eventuali note inserite per una metrica, ad esempio per le note a piè di pagina	Testo
Argomento	Il nome di un argomento all'interno del Programma	Testo
Percorso dell'argomento	Dove appare un argomento nel sommario del Programma, ad esempio `["Clima", "Gas serra (GHG)", "Emissioni dirette di GHG"].`	Testo
Tag personalizzati	Tutti i tag personalizzati applicati a un argomento metrico	Testo
Anno di riferimento	L'anno di riferimento dei valori metrici del Programma	Numero intero
Inizio del periodo di riferimento	Il mese di inizio del periodo di riferimento dei valori metrici del Programma; ad esempio, `1` per un valore annuale o `10` per un valore trimestrale Q4	Numero intero
Fine del periodo di riferimento	Il mese finale del periodo di riferimento dei valori metrici del Programma; per esempio, `12` per un valore annuale o un valore trimestrale Q4	Numero intero
Posizione della fonte	Per un valore con un foglio di calcolo sorgente collegato, le coordinate della sua cella	Testo
Nome della dimensione	Per un valore con una dimensione applicata, il nome della dimensione Nota: Se le tue metriche supportano più dimensioni, la query può includere fino a sette campi Nome dimensione - uno per ogni dimensione possibile per una metrica. La posizione di una dimensione - come ad esempio in Nome della dimensione 1, Nome della dimensione 2, e così via - riflette il suo ordine nella metrica Configura la metrica pannello.	Testo
Valore della dimensione	Per un valore con una dimensione applicata, il suo valore dimensionale Nota: Se le metriche supportano più dimensioni, la query può includere fino a sette campi Valore della dimensione - uno per ogni dimensione possibile per una metrica. La posizione di una dimensione - come ad esempio in Valore della dimensione 1, Valore della dimensione 2 e così via - riflette il suo ordine nel pannello della metrica Configurare la metrica .	Testo

Nota: Il tuo spazio di lavoro potrebbe non supportare ancora le dimensioni multiple per i valori metrici. Resta sintonizzato!

Quando selezioni Aggiungi dati di dimensione del programma come fonte, la query può includere queste colonne:

Colonna	Descrizione	Tipo
Nome della dimensione	Il nome di una dimensione personalizzata impostata per il Programma, ad esempio Ubicazione o Genere.	Testo
ID valore	L'ID univoco assegnato al valore di una dimensione, come ad esempio IA o NB	Testo
Nome del valore	Il nome completo del valore di una dimensione, ad esempio Iowa o Non-binary.	Testo
Stato della dimensione	Se una dimensione è attiva o inattiva	Testo

Quando aggiungi Aggiungi i dati del tag del programma come fonte, la query può includere queste colonne:

Colonna	Descrizione	Tipo
Nome del tag	Il nome di un tag personalizzato impostato per il Programma	Testo
Valore del tag	Il nome del valore del tag	Testo

Unisci i dati del programma con i dati delle dimensioni o dei tag

Per aggiungere un contesto alle dimensioni o ai tag di un programma, aggiungi i dati del programma e le sue dimensioni o tag come fonti e poi crea una relazione per unirli.

Ad esempio, per includere il contesto intorno alle dimensioni di un Programma:

In Fonti, seleziona Programma di sostenibilità e Dimensioni del programma, e scegli lo stesso programma per entrambi.
In Fields, aggiungi le colonne da includere da ogni fonte.

Come minimo, includi:
- Dimensioni dai dati del Programma
- ID valore dalle dimensioni
In Relationships, aggiungi un join a sinistra:
- Nell'origine sinistra, seleziona Campo calcolato, quindi applica un calcolo basato sulla colonna Dimensioni dal pannello Proprietà del campo :
```
JSON_FORMAT(JSON_ARRAY_GET(JSON_EXTRACT(JSON_PARSE( {1} ), '$.*'), 0))
```
  Suggerimento: Puoi aggiungere rapidamente le funzioni JSON al calcolo dal menu Formula .
- Nella fonte di destra, seleziona il campo ID valore della dimensione.
Clicca su Salva.

Includi colonne per framework o tag specifici

Quando utilizzi un Programma come fonte di query, puoi includere le colonne per tutti i riferimenti ai framework e ai tag personalizzati applicati alle sue metriche. Per maggiore chiarezza, puoi applicare dei calcoli per includere le colonne solo per framework o tag specifici.

Quadri normativi
Tag

Quando includi la colonna Frameworks in una query, questa fornisce tutti i riferimenti ai framework applicati alle metriche. Ad esempio:

Quadri normativi
"gri_2020": ["305", "305-1"], "sasb_2021": ["EM-CM-110a", "EM-CM-110a.1"].

Per maggiore chiarezza, puoi invece includere una colonna separata per i riferimenti di un framework, come ad esempio:

GRI	SASB
["305", "305-1"]	["EM-CM-110a", "EM-CM-110a.1"]

Per includere una colonna per i riferimenti di un framework nei risultati di una query, applica questo calcolo:

Dal pannello Sources, fai clic con il tasto destro del mouse su Calculation e seleziona Add to Fields.
In Campi, seleziona Calcolo.
Nel pannello Proprietà dei campi inserisci l'intestazione della colonna del calcolo nei risultati della query, ad esempio "SASB" per i riferimenti ai Sustainability Accounting Board Standards (SASB).
Dal pannello Sources, fai clic con il tasto destro del mouse sulla colonna Frameworks del programma di origine e seleziona Include in calculation.
Dal pannello Proprietà del campo inserisci il calcolo:
```
 JSON_EXTRACT({[campo]}, '$.[framework]') 
```
- Sostituisci [campo] con il numero della colonna Frameworks sotto Colonne incluse, ad esempio 1.
- Sostituisci [framework] con il nome e la versione del framework dei riferimenti da includere, ad esempio sasb_2021.
Fai clic su Applica.

Quando includi la colonna Custom tags in una query, questa fornisce tutti i valori dei tag applicati alle metriche. Ad esempio:

Tag personalizzati
{"CDP": ["C5.1", "C4.1a"], "Località": ["Ames", "Denver"]}

Per maggiore chiarezza, puoi invece includere una colonna separata per un tag, come ad esempio:

CDP	Posizione
["C5.1", "C4.1a"]	["Ames", "Denver"]

Per includere una colonna per i valori di un tag personalizzato nei risultati di una query, applica questo calcolo:

Dal pannello Sources, fai clic con il tasto destro del mouse su Calculation e seleziona Add to Fields.
In Fields, seleziona Calculation.
Dal pannello Proprietà del campo inserisci l'intestazione della colonna del calcolo nei risultati della query, ad esempio "CDP" per le metriche etichettate con le voci del questionario CDP.
Dal pannello Sorgenti fai clic con il tasto destro del mouse sulla colonna Tag personalizzati del programma sorgente e seleziona Includi nel calcolo.
Dal pannello Proprietà del campo inserisci il calcolo e sostituisci [tag] con il nome del tag personalizzato dei valori da includere, ad esempio CDP.
```
 JSON_EXTRACT({[campo]}, '$["tag"]') 
```
Suggerimento: Per rimuovere i doppi apici dai valori dei tag nei risultati delle query, aggiungi l'istruzione W_JSON_ARRAY_JOIN W_JSON_ARRAY_JOIN( JSON_EXTRACT( {[field]} , '$["tag"]'), ',')).
Fai clic su Applica.

Aggiornare le fonti di query del programma

Man mano che il programma si evolve e introduce nuove funzionalità, potrebbe essere necessario aggiornare la sua fonte di query per includere le colonne correlate.

Suggerimento: Quando un programma ha nuove colonne da includere, la sua fonte di query visualizza un avviso in Fonti.

Per aggiornare la fonte di query di un programma:

In Sorgenti, fai clic con il tasto destro del mouse sulla sorgente e seleziona Rimuovi la sorgente.
Aggiungi nuovamente il Programma come fonte.
Modifica la query per includere le colonne del Programma come necessario.

Assistenza

Community

Centro assistenza di Workiva