À 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.
- 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.
- 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 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 :
|
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 |
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 :
|
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
JSONau 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.
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 exemple1. - Remplacez
[cadre]par le nom et la version du cadre des références à inclure, par exemplesasb_2021.
- Remplacez
- 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 exempleCDP.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_JOINW_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.