Télécharger les données de l'empreinte carbone de Watershed® pour les rapports sur le développement durable

La plateforme climatique d'entreprise Watershed vous permet de mesurer, de rapporter et de réduire l'empreinte carbone de votre organisation.

Avec la plateforme Workiva, vous pouvez créer des chaînes pour télécharger automatiquement les données d'empreinte carbone de Watershed - par exemple pour les divulguer dans votre rapport environnemental, social et de gouvernance (ESG) ou de développement durable - dans un tableau, sur la base d'une période spécifiée dans une feuille de calcul personnalisée Watershed. Vous pouvez ensuite utiliser le tableau comme source pour une requête ou une connexion à une feuille de calcul, par exemple pour inclure les données dans des rapports.

Note : Bien que vous construisiez plusieurs chaînes dans ces instructions, vous n'en exécuterez qu'une seule - qui exécutera ensuite automatiquement les autres - pour télécharger les données de Watershed et mettre à jour la feuille de calcul.

Note : La feuille de calcul Watershed utilisée par ces chaînes est fournie par Workiva. Si vous ne l'avez pas mais que vous êtes intéressé, contactez votre Customer Success Manager pour plus d'informations.

Conditions préalables

Pour construire ces chaînes, vous aurez besoin de ces connecteurs :

Conseil : Toutes les commandes des chaînes utilisent le CloudRunner par défaut. Aucun GroundRunner n’est nécessaire.

Pour réussir à faire fonctionner les chaînes, il faut aussi identifier :

La clé du fournisseur d'activités à utiliser pour s'authentifier et effectuer des actions avec l'API Watershed.
Les identifiants de la feuille de calcul , de la feuille de contrôle et de la table qui lui est associée.

Construire une chaîne pour enregistrer les téléchargements de données

Pour commencer, créez une chaîne pour mettre à jour la feuille de contrôle , section, afin de savoir quand les données relatives à l'empreinte carbone sont téléchargées sur Workiva.

Étape 1. Créer la chaîne

À partir de Chains, cliquez sur Create, et sélectionnez Create chain.
Dans Setup, entrez un nom pour 3. Watershed et une description permettant d'identifier que la chaîne enregistre les téléchargements de données de Watershed.
Cliquez sur Enregistrer.

Étape 2. Commencer par un événement Runtime Inputs

À partir de Événements en chaîne, déplacez Entrées d'exécution vers Démarrage.
Sélectionnez l'événement Runtime inputs et cliquez sur Modifier.
Dans Basic info, saisissez un nom et une description pour identifier l'événement.
Dans Variables, ajoutez des entrées TextField avec ces noms d'affichage :
- Plage
- ID feuille de calcul
- ID de la feuille
Conseil : Laissez les valeurs par défaut de ces variables vides ; elles seront générées lorsque vous exécuterez le programme 1. La chaîne du bassin versant est créée ultérieurement.
Sélectionnez Required pour les trois variables et cliquez sur Save.

Étape 3. Ajouter un fichier Utilitaires Créer un fichier

Pour créer le fichier journal de la section Control Sheet, ajoutez la commande File Utilities Create file:

À partir de Connecteurs disponibles, sélectionnez Utilitaires de fichiers, et déplacez Créer un fichier sur le canevas.
Faites glisser un lien de Runtime inputs vers Create file.
Sélectionnez la commande Créer un fichier et cliquez sur Editer.
Dans Basic info, entrez un nom et une description pour aider à identifier la commande.

Saisissez les propriétés de la commande et cliquez sur enregistrer:

Propriété	Valeur
Connecteur	Sélectionnez le connecteur d'utilitaires de fichiers à utiliser.
Texte	Saisissez `Données d'empreinte actualisées pour la dernière fois le`, et sélectionnez la variable d'exécution System.DateTime.

Étape 4. Ajouter une commande Workiva Write Sheet Data

Pour mettre à jour la section Control Sheet avec le fichier journal, ajoutez une commande Workiva Write sheet data:

À partir de Connecteurs disponibles, sélectionnez Workiva, et déplacez Écrire les données de la feuille dans le canevas.
Faire glisser un lien de Créer un fichier vers Écrire les données de la feuille.
Sélectionnez la commande Write sheet data et cliquez sur Edit.
Dans Basic info, entrez un nom et une description pour aider à identifier la commande.

Saisissez les propriétés de la commande et cliquez sur Save:

Propriété	Valeur
Connecteur	Sélectionnez le connecteur Workiva à utiliser.
ID de la feuille de calcul	Sélectionnez l'entrée d'exécution SpreadsheetID à partir de Trigger.
ID/nom de la feuille	Sélectionnez l'entrée d'exécution SheetID à partir de Trigger.
Fichier de données	Sélectionnez la sortie Created file de la commande Create file.
Séparateur	Saisir une virgule (`,`).
Région	Sélectionnez l'entrée d'exécution Range à partir de Trigger.

Cliquez sur Publier, saisissez une note sur sa publication et cliquez sur Publier.

Construire des chaînes à partir du modèle Load Data to Wdata

Ensuite, utilisez le modèle Load Data to Wdata pour construire des chaînes afin de mettre à jour le tableau connecté de la feuille de calcul Watershed avec les données téléchargées depuis Watershed. Le modèle Load Data to Wdata crée des chaînes qui travaillent ensemble pour déterminer si l'ensemble de données existe déjà dans la table et mettre à jour la table avec l'ensemble de données le plus récent.

Pour créer les chaînes à partir de Modèles, ouvrez le modèle Load Data to Wdata | Primary chain et cliquez sur New chain.

Construire une chaîne pour télécharger les données de Watershed

Enfin, construisez une chaîne pour télécharger et importer les données d'empreinte carbone de Watershed.

Note : Créer les deux autres chaînes avant celle-ci, pour ses événements Exécuter la chaîne.

Étape 1. Créer la chaîne

À partir de Chains, cliquez sur Create, et sélectionnez Create chain.
Dans Setup, entrez un nom de 1. Le bassin versant et une description permettant d'identifier plus précisément la chaîne.

Dans Variables, ajoutez des variables pour la clé API Watershed et les ID de la feuille de calcul Watershed et de sa feuille de contrôle.

Nom	Valeur
Clé APIK	Entrez la clé API de Watershed.
ID feuille de calcul	Saisir l'ID de la feuille de calcul du bassin versant.
ID de la feuille	Saisissez l'ID de la feuille de contrôle section de la feuille de calcul Watershed.

Cliquez sur Enregistrer.

Étape 2. Commencez par une commande Workiva Get Sheet Data

Commencez par une commande Workiva Get sheet data pour identifier les données à télécharger, sur la base de la période de temps dans la feuille de calcul Watershed Control sheet:

À partir de Connecteurs disponibles, sélectionnez Workiva, et déplacez Obtenir les données de la feuille vers Démarrer.
Sélectionnez la commande Get sheet data et cliquez sur Edit.
Dans Basic info, entrez un nom et une description pour aider à identifier la commande.

Saisissez les propriétés de la commande et cliquez sur Save:

Propriété	Valeur
Connecteur	Sélectionnez le connecteur Workiva à utiliser.
ID de la feuille de calcul	Sélectionnez la variable de chaîne Spreadsheet ID.
ID/nom de la feuille	Sélectionnez la variable de chaîne Sheet ID.
Région	Entrez `A11 :`.
Style de valeur	Sélectionnez Calculé.
Révision	Pour obtenir la dernière version, entrez `-1`.

Étape 3. Ajouter des commandes pour préparer la période de temps pour le bassin versant

Pour identifier la période de temps pour le bassin versant, ajoutez les commandes Advanced query et CSV to JSON:

À partir de Connecteurs disponibles, sélectionnez Transformation tabulaire, et déplacez Requête avancée dans le canevas.
Faites glisser un lien de Get sheet data vers Advanced query.
Sélectionnez la commande Advanced query et cliquez sur Modifier.
Dans Basic info, entrez un nom et une description pour aider à identifier la commande.

Saisissez les propriétés de la commande et cliquez sur Save:

Propriété	Valeur
Connecteur	Sélectionnez le connecteur de transformation tabulaire à utiliser.
Tableaux	Ajoutez le tableau pour les données relatives à la période : Dans File, sélectionnez la sortie Data de la commande Get sheet data. Dans Nom de la table, saisissez `a`.
Requête	Saisissez la requête à exécuter : select case when `Start Month` = 'January' then '01' when `Start Month` = 'February' then '02' when `Start Month` = 'March' then '03' when `Start Month` = 'April' then '04' when `Start Month` = 'May' then '05' when `Start Month` = 'June' then '06' when `Start Month` = 'July' then '07' when `Start Month` = 'August' then '08' when `Start Month` = 'September' then '09' when `Start Month` = 'October' then '10' when `Start Month` = 'November' then '11' else '12' end as 'sm', case when `End Month` = 'January' then '01' when `End Month` = 'February' then '02' when `End Month` = 'March' then '03' when `End Month` = 'April' then '04' when `End Month` = 'May' then '05' when `End Month` = 'June' then 06" lorsque `Fin de mois` = 'juillet' alors '07' lorsque `Fin de mois` = 'août' alors '08' lorsque `Fin de mois` = 'septembre' alors '09' lorsque `Fin de mois` = 'octobre' alors '10' lorsque `Fin de mois` = 'novembre' alors '11' sinon '12' end as 'em', `Année de déclaration` comme 'ry', TableId comme 'tid' from a
Délimiteur d'entrée	Sélectionnez Virgule.
Délimiteur de sortie	Sélectionnez Virgule.
Résultats en avant-première	Cochez cette case.

À partir de Connecteurs disponibles, sélectionnez JSON, et déplacez CSV to JSON dans le canevas.
Faites glisser un lien depuis Requête avancée vers CSV vers JSON.
Sélectionnez la commande CSV to JSON et cliquez sur Edit.
Dans Basic info, entrez un nom et une description pour aider à identifier la commande.

Saisissez les propriétés de la commande et cliquez sur enregistrer:

Propriété	Valeur
Connecteur	Sélectionnez le connecteur JSON à utiliser.
Fichier d'entrée	Sélectionnez la sortie Result de la commande Advanced query.
Séparateur	Sélectionnez Virgule (,).

Étape 4. Ajouter une commande HTTP Request GET

Pour télécharger les données relatives à l'empreinte carbone pour la période sélectionnée, ajoutez une requête HTTP GET:

À partir de Available connectors, sélectionnez HTTP Request, et déplacez GET sur le canevas.
Faites glisser un lien de CSV à JSON à GET.
Sélectionnez la commande GET et cliquez sur Edit.
Dans Basic info, entrez un nom et une description pour aider à identifier la commande.

Saisissez les propriétés de la commande et cliquez sur Save:

Propriété	Valeur
Connecteur	Sélectionnez le connecteur de requête HTTP à utiliser.
Afficher la réponse	Cochez cette case.
URL	Entrez `https://api.watershedclimate.com/v1/report/footprint_detail`.
Chaîne de requête	Saisissez la chaîne de requête pour indiquer les mois de début et de fin des données à télécharger : Pour le mois de départ, entrez `startMonth=`, et sélectionnez le fichier JSON issu de la commande CSV to JSON à deux reprises. Ensuite, pour le mois de fin, entrez `&endMonth=`, et sélectionnez le fichier JSON issu de la commande CSV to JSON deux fois de plus. Pour les deux mois, cliquez sur le premier fichier JSON produit, et appliquez une transformation Get variable from JSON : Dans Output, sélectionnez Text. Dans Valeur, entrez `0` et `ry`. Pour les deux mois, cliquez sur le deuxième fichier JSON de sortie, et appliquez une autre transformation Get variable from JSON : Dans Output, sélectionnez Text. Dans Value, entrez `0` et `sm`.
En-têtes	Ajouter un en-tête : Dans Key, entrez `Authorization`. Dans Value, entrez `Bearer` , puis sélectionnez la variable de chaîne APIKey.
Type de contenu	Entrez `application/json`.

Étape 5. Ajouter les événements de la chaîne d'exécution pour effectuer et enregistrer le téléchargement des données

Pour télécharger les données dans Wdata et enregistrer le téléchargement dans la section Control sheet, ajoutez Run chain events pour les chaînes créées précédemment :

À partir de , enchaînez les événements, déplacez et enchaînez sur le canevas.
Faites glisser un lien de GET vers Exécutez la chaîne.
Sélectionnez l'événement Run chain et cliquez sur Modifier.
Dans Basic info, saisissez un nom et une description pour aider à identifier l'événement qui télécharge les données dans Wdata.
Dans Chain to run, sélectionnez Load Data to Wdata | Primary chain créé précédemment à partir du modèle Load Data to Wdata.

Saisissez les données d'entrée de la chaîne d'exécution et cliquez sur enregistrer:

Entrée	Valeur
ID du tableau	Indiquer l'ID de la table Wdata dans laquelle les données doivent être téléchargées : Sélectionnez le fichier JSON issu de la commande CSV to JSON. Cliquez sur le fichier JSON et appliquez la transformation Get variable from JSON: Dans Output, sélectionnez Text. Dans Valeur, entrez `0` et `tid`.
Préfixe du fichier	Pour définir le préfixe de l'ensemble de données à télécharger, en fonction de la période de temps des données : Pour le mois de départ, sélectionnez le fichier JSON issu de la commande CSV to JSON deux fois. Saisissez un trait de soulignement (`_`). Pour le mois de fin, sélectionnez encore deux fois le fichier JSON issu de la commande CSV to JSON. Entrez `.csv`. Pour les deux mois, cliquez sur le premier fichier JSON et appliquez la transformation Get variable from JSON: Dans Output, sélectionnez Text. Dans Valeur, entrez `0` et `ry`. Pour les deux mois, cliquez sur le deuxième fichier JSON et appliquez une autre transformation Get variable from JSON: Dans Output, sélectionnez Text. Dans Value, entrez `0` et `sm`.
Fichier de données	Sélectionnez la sortie Response de la commande GET.
Méthode de chargement	Sélectionnez Remplacer le jeu de données.
Retour en arrière	Cochez cette case.

À partir de Chaîner les événements, déplacer un autre Exécuter la chaîne sur le canevas.
Faites glisser un maillon de la première chaîne Run vers la deuxième.
Sélectionnez le deuxième événement Run chain et cliquez sur Edit.
Dans Basic info, entrez un nom et une description pour aider à identifier que l'événement enregistre le téléchargement de données dans la feuille de calcul Watershed.
Dans Chain to run, sélectionnez la chaîne 3. Chaîne de bassins versants créée précédemment.
Saisissez les données d'entrée de la chaîne d'exécution et cliquez sur enregistrer:

Entrée Valeur

Plage Entrez F12:F12.

ID de la feuille de calcul Sélectionnez la variable de chaîne SpreadsheetID.

ID de la feuille Sélectionnez la variable de chaîne SheetID.
Cliquez sur Publier, saisissez des notes sur sa publication, puis cliquez sur Publier.

Exécuter les chaînes

Pour actualiser la feuille de calcul Watershed avec les données les plus récentes sur l'empreinte carbone :

Dans la section Control sheet de la feuille de calcul Watershed, sélectionnez la période - mois et année - des données à télécharger depuis Watershed.
A partir de Wdata Chains, sélectionnez 1. Chaîne de bassins versants et cliquez sur Exécuter et Exécuter la chaîne.

Note : Lorsque vous exécutez cette chaîne, elle exécute automatiquement les deux autres chaînes pour mettre à jour le tableau Wdata et la feuille de calcul Watershed avec les données.

Support

Communauté

Portail de support Workiva