Utiliser les données du programme de développement durable dans les requêtes

À partir de Wdata, vous pouvez créer des requêtes basées sur les données de Sustainability Program, y compris :

Thèmes, mesures, valeurs et tâches
Dimensions personnalisées disponibles pour les valeurs métriques
Tags personnalisés disponibles pour les métriques

Grâce à ces requêtes, vous pouvez

Explorez vos données sur le développement durable à travers un objectif ciblé, en utilisant les filtres et les paramètres .
Connecter les résultats à une feuille de calcul, par exemple pour exporter des données sur la durabilité vers un fichier ou fournir des liens vers les sources des résultats des rapports.
Fournir un contexte supplémentaire pour les tags ou les dimensions des métriques.

Ajouter le programme comme source de requête

Pour utiliser les données d'un programme dans une requête :

From the query's Sources panel, click Add sources, and select Add program data.
Dans le panneau Sources de la requête, cliquez sur New source, et sélectionnez les données à inclure dans les résultats :
- Pour inclure des données sur un programme et ses thèmes, ses mesures, ses valeurs ou ses tâches, sélectionnez Sustainability, Sustainability program.
- Pour inclure des données sur les dimensions personnalisées disponibles pour les valeurs métriques d'un programme, sélectionnez Sustainability, Program dimensions.
- Pour inclure des données sur les custom tags disponibles pour les mesures d'un programme, sélectionnez Sustainability, Program tags.
Conseil : Pour obtenir un contexte supplémentaire autour des dimensions ou des balises des métriques d’un programme, ajoutez les données du programme et ses données de dimension ou de balise en tant que sources, et créez une relation pour les relier.
Recherchez et sélectionnez le programme à utiliser dans la requête, puis cliquez sur Add.

Dans le panneau Sources, indiquez comment utiliser les colonnes de données dans la requête :

Pour utiliser des colonnes comme résultats dans le Générateur, sélectionnez-les, puis sélectionnez Ajouter aux champs ou faites-les glisser vers l’onglet Champs.

Pour utiliser des colonnes comme filtres dans Builder, sélectionnez-les, puis Ajouter aux filtres ou faites-les glisser vers l'onglet Filtres.

Par exemple, pour une requête avec une source Programme de développement durable :

Filtrer	Retours
Année du programme	Seules les valeurs collectées pour des années spécifiques
Dimensions	Uniquement les métriques auxquelles des dimensions personnalisées spécifiques ont été appliquées, et les valeurs collectées pour ces dimensions.
État de la tâche	Uniquement les tâches avec des statuts de collecte de données spécifiques

Pour inclure une colonne dans l’instruction de la requête dans SQL, cliquez avec le bouton droit sur la colonne et sélectionnez Ajouter à la requête.

Créez la requête si nécessaire.

Colonnes sources

Lorsque vous ajoutez des données de programme comme source, vous pouvez inclure ses colonnes de données dans les résultats de la requête.

Lorsque vous sélectionnez Ajouter les données du programme comme source, la requête peut inclure ces colonnes :

Colonne	Description	Type
Nom du programme	Nom du programme	Texte
Année du programme	L'année des données du programme	Entier
Nom de la métrique	Le nom d'une métrique dans un thème du programme	Texte
Code de métrique	Identifiant unique généré pour une métrique	Texte
Type de métrique	Type de valeur collectée pour une métrique : Texte, Devise, Nombre, Pourcentage ou Date	Texte
Description de la métrique	Description entrée pour une métrique	Texte
Dimensions	Le nom et la valeur de la dimension personnalisée appliqués à une valeur métrique, tels que `{"Location » : « South »}` Conseil : Si vos mesures prennent en charge plusieurs dimensions, vous pouvez utiliser les champs Dimension name et Dimension value pour renvoyer des colonnes distinctes pour les noms et les valeurs des dimensions.	Texte
Valeur-Texte	Valeur entrée pour une métrique, sous forme de texte	Texte
Valeur-Nombre	Valeur quantitative entrée pour une mesure, sous forme de nombre	Décimale
Unité	Pour une métrique dont le type est Devise, Nombre ou Pourcentage, son unité de mesure	Texte
Pièces jointes justificatives	Les noms de fichiers des pièces jointes téléchargées pour une valeur métrique. Note : Si une valeur comporte plusieurs pièces jointes, leurs noms de fichiers apparaissent sous la forme d’une liste séparée par des virgules. Les résultats ne comprennent que les pièces jointes téléchargées sur ; aucun fichier Workiva ni aucune adresse web n'apparaissent.	Texte
Type de source	Mode de fourniture d’une valeur de métrique : Manuel, si elle est entrée directement dans la métrique Source connectée, si elle provient d’une feuille de calcul ou d’un document connecté Tâche, si à partir de Tâches Workiva	Texte
Fichier source	Pour une métrique dont le fichier source est connecté, nom de la source	Texte
Section source	Pour une métrique dont le fichier source est connecté, nom de la section du fichier source où la valeur apparaît	Texte
Référentiels	Tous les liens Sustainability Explorer contenu référencé par une métrique Conseil : Pour compléter le contenu connecté avec des détails supplémentaires provenant de Sustainability Explorer, ajoutez Sustainability Explorer comme source de requête.	Texte
Nom de la tâche	Nom d’une tâche de collecte de données créée pour la valeur d’une métrique	Texte
Personne assignée à la tâche	Nom d’utilisateur du membre de l’espace de travail chargé de la tâche de collecte de la valeur de la métrique Remarque : Si une valeur a plusieurs attributaires, ils apparaissent sous la forme d’une liste séparée par des virgules, telle que `homer@org.com,marge@org.com`. Si votre requête ne renvoie que un membre pour plusieurs cessionnaires, contactez votre Customer Success Manager (CSM) Workiva.	Texte
Approbateur de tâches	Nom d’utilisateur du membre de l’espace de travail chargé d’une tâche d’approbation de la valeur collectée pour une métrique Si une valeur a plusieurs approbateurs ou étapes d’approbation : Une virgule (,) sépare les approbateurs sélectionnés pour une étape spécifique, par exemple `homer@org.com,marge@org.com` Une barre verticale (\|) sépare les approbateurs sélectionnés pour chaque étape, par exemple `homer@org.com, marge@org.com \| bart@org.com, lisa@org.com`, dans l’ordre d’approbation	Texte
Date d’échéance de la tâche	Date d’échéance de la tâche de collecte de données d’une valeur	Date
Date d’échéance de l’approbateur de la tâche	Date d’échéance de la tâche d’approbation d’une valeur Conseil : Si une valeur a plusieurs étapes d’approbation, il s’agit de la date d’échéance de son approbation finale.	Date
État de la tâche	L’état général de la collecte des données d’une valeur, par exemple Pas démarré, En cours ou Terminé.	Texte
Instructions de la tâche	Instructions entrées pour la personne assignée et l’approbateur d’une valeur métrique	Texte
Notes	Toutes les notes saisies pour une métrique, par exemple pour les notes de bas de page	Texte
Sujet	Le nom d'un thème du programme	Texte
Chemin d’accès du sujet	Lorsqu'un sujet apparaît dans le plan du programme, par exemple `["Climat", "Gaz à effet de serre (GES)", "Émissions directes de GES"].`	Texte
Balises personnalisées	Toutes les balises personnalisées appliquées au sujet d’une métrique	Texte
Année du rapport	L'année de déclaration des valeurs métriques du programme	Entier
Début de la période de reporting	Mois de début de la période de rapport des valeurs des métriques du programme, par exemple `1` pour une valeur annuelle ou `10` pour une valeur trimestrielle T4.	Entier
Fin de la période de reporting	Mois de fin de la période de rapport des valeurs des métriques du programme, par exemple `12` pour une valeur annuelle ou une valeur trimestrielle T4.	Entier
Emplacement source	Pour une valeur dont la feuille de calcul source est connectée, les coordonnées de sa cellule	Texte
Nom de la dimension	Pour une valeur à laquelle une dimension est appliquée, le nom de la dimension. Remarque : Si vos mesures prennent en charge plusieurs dimensions, la requête peut inclure jusqu’à sept champs Nom de la dimension - un pour chaque dimension possible pour une mesure. La position d’une dimension - comme dans Nom de la dimension 1, Nom de la dimension 2, et ainsi de suite - reflète son ordre dans la métrique Configurer la métrique panneau.	Texte
Valeur de la dimension	Pour une valeur à laquelle une dimension est appliquée, sa valeur dimensionnelle Remarque : Si vos mesures prennent en charge plusieurs dimensions, la requête peut inclure jusqu’à sept champs Dimension value - un pour chaque dimension possible pour une mesure. La position d’une dimension - comme dans Dimension 1 value, Dimension 2 value, et ainsi de suite - reflète son ordre dans the metric’s Configure metric panel.	Texte

Note : Il se peut que votre espace de travail ne prenne pas encore en charge plusieurs dimensions pour les valeurs métriques. Restez à l'écoute !

Lorsque vous sélectionnez Ajouter les données de dimensions du programme comme source, la requête peut inclure ces colonnes :

Colonne	Description	Type
Nom de la dimension	Le nom d'une dimension personnalisée définie pour le programme, telle que le lieu ou le sexe.	Texte
ID de la valeur	L’ID unique attribué à la valeur d’une dimension, tel que IA ou NB	Texte
Nom de la valeur	Nom complet de la valeur d’une dimension, par exemple Iowa ou Non binaire	Texte
Statut de la dimension	Indique si une dimension est active ou inactive	Texte

Lorsque vous ajoutez la sélection Ajouter les données de balises du programme comme source, la requête peut inclure ces colonnes :

Colonne	Description	Type
Nom de la balise	Le nom d'une balise personnalisée mise en place pour le programme	Texte
Valeur de la balise	Nom de la valeur de la balise	Texte

Joindre des données de programme à des données de dimension ou d'étiquette

Pour obtenir un contexte supplémentaire autour des dimensions ou des balises d'un programme, ajoutez les données du programme et ses dimensions ou balises en tant que sources, puis créez une relation pour les relier.

Par exemple, pour inclure le contexte autour des dimensions d'un programme :

Dans Sources, sélectionnez Programme de durabilité et Dimensions du programme, et choisissez le même programme pour les deux.
Dans Fields, ajoutez les colonnes à inclure dans chaque source.

Au minimum, il faut inclure
- Dimensions à partir des données du programme
- Valeur ID à partir des dimensions
Dans Relations, ajoutez une liaison à gauche :
- Dans la source de gauche, sélectionnez Champ calculé, puis appliquez un calcul basé sur la colonne Dimensions du panneau Propriétés du champ :
```
JSON_FORMAT(JSON_ARRAY_GET(JSON_EXTRACT(JSON_PARSE( {1} ), ’$.*’), 0))
```
  Astuce : Vous pouvez rapidement ajouter les fonctions JSON au calcul à partir du menu Formula .
- Dans la source de droite, sélectionnez le champ Value ID de la dimension.
Cliquez sur Enregistrer.

Inclure des colonnes pour des cadres ou des balises spécifiques

Lorsque vous utilisez un programme comme source de requête, vous pouvez inclure des colonnes pour toutes les références du cadre et les balises personnalisées appliquées à ses métriques. Pour plus de clarté, vous pouvez appliquer des calculs pour inclure des colonnes uniquement pour des cadres ou des balises spécifiques.

Cadres
Balises

Lorsque vous incluez la colonne Frameworks dans une requête, elle fournit toutes les références de frameworks appliquées aux métriques. Par exemple :

Référentiels
"gri_2020" : ["305", "305-1"], "sasb_2021" : ["EM-CM-110a", "EM-CM-110a.1"]

Pour plus de clarté, vous pouvez inclure une colonne distincte pour les références d’un cadre, par exemple :

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

Pour inclure une colonne pour les références d’un cadre dans les résultats d’une requête, appliquez ce calcul :

Dans le panneau Sources, cliquez avec le bouton droit sur Calcul et sélectionnez Ajouter aux champs.
Sous Champs, sélectionnez Calcul.
Dans le panneau Propriétés du champ, entrez l’en-tête de colonne du calcul dans les résultats de la requête, par exemple « SASB » pour les références aux Sustainability Accounting Board Standards (SASB).
Dans le panneau Sources, cliquez avec le bouton droit sur la colonne Cadres du programme source et sélectionnez Inclure dans le calcul.
Dans le panneau Field properties, entrez le calcul :
```
 JSON_EXTRACT({[champ]}, ’$.[framework]’) 
```
- Remplacez [champ] par le numéro de la colonne Cadres sous Colonnes incluses, par exemple 1.
- Remplacez [cadre] par le nom et la version du cadre des références à inclure, par exemple sasb_2021.
Cliquez sur Appliquer.

Lorsque vous incluez la colonne Custom tags dans une requête, elle fournit toutes les valeurs de tag appliquées aux métriques. Par exemple :

Balises personnalisées
{"CDP" : ["C5.1", "C4.1a"], "Location" : ["Ames", "Denver"]}

Pour plus de clarté, vous pouvez inclure une colonne distincte pour une balise, par exemple :

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

Pour inclure une colonne pour les valeurs d’une balise personnalisée dans les résultats d’une requête, appliquez ce calcul :

Dans le panneau Sources, cliquez avec le bouton droit sur Calcul et sélectionnez Ajouter aux champs.
Sous Champs, sélectionnez Calcul.
Dans le panneau Propriétés du champ, entrez l’en-tête de colonne du calcul dans les résultats de la requête, par exemple « CDP » pour les métriques balisées avec des éléments du questionnaire CDP.
Dans le panneau Sources, cliquez avec le bouton droit sur la colonne Balises personnalisées du programme source et sélectionnez Inclure dans le calcul.
Dans le panneau Propriétés du champ, entrez le calcul et remplacez [balise] par le nom de la balise personnalisée des valeurs à inclure, par exemple CDP.
```
 JSON_EXTRACT({[champ]}, ’$["tag »]’) 
```
Astuce : Pour supprimer les guillemets des valeurs des balises dans les résultats de la requête, ajoutez l’instruction W_JSON_ARRAY_JOIN W_JSON_ARRAY_JOIN( JSON_EXTRACT( {[field]} , ’$["tag »]’), ’,’).
Cliquez sur Appliquer.

Mise à jour des sources d'interrogation du programme

Au fur et à mesure de l'évolution du programme et de l'introduction de nouvelles fonctionnalités, il peut être nécessaire de mettre à jour la source de la requête afin d'y inclure les colonnes correspondantes.

Conseil : Lorsqu'un programme doit inclure de nouvelles colonnes, sa source de requête affiche un avertissement dans Sources.

Pour mettre à jour la source d'interrogation d'un programme :

Dans Sources, cliquez avec le bouton droit sur la source et sélectionnez Supprimer la source.
Ajoutez à nouveau le programme comme source.
Modifiez la requête pour inclure les colonnes du programme si nécessaire.

Support

Communauté

Portail de support Workiva