À partir de Chain Builder, vous pouvez créer une chaîne pour télécharger des données de Schneider Electric® dans Workiva, telles que vos émissions de gaz à effet de serre (GES) pour les rapports environnementaux, sociaux et de gouvernance (ESG) ou de développement durable.
Conditions préalables
Pour construire cette chaîne, vous utiliserez ces connecteurs principaux :
Remarque : Tous les connecteurs utilisent le CloudRunner. Aucun GroundRunner n'est nécessaire pour cette chaîne.
Pour télécharger les données d'émissions, vous aurez également besoin du nom d'utilisateur et du mot de passe utilisés pour l'authentification de base avec Schneider Electric.
Étape 1. Créer la chaîne
- À partir de Chains, cliquez sur Create, et sélectionnez Create chain.
- Sous Setup, saisissez un nom et une description pour identifier la chaîne.
- Sous Variables, ajoutez des variables pour spécifier les données à télécharger de Schneider Electric :
Nom Valeur clientHierIds Saisissez l'ID de la hiérarchie des clients de votre entreprise, telle qu'elle a été configurée pour Schneider Electric dans Resource Advisor. serviceIds Pour télécharger des données uniquement pour une source spécifique, saisissez l'identifiant de la source de GES pour laquelle vous souhaitez télécharger les données d'émissions. duMois Saisissez le premier mois de la période pour laquelle vous souhaitez télécharger des données, au format aaaa-MM.auMois Saisissez le dernier mois de la période pour laquelle vous souhaitez télécharger des données, au format aaaa-MM.Type de carte de carbone Saisissez la carte du carbone du conseiller en ressources à utiliser - primaire ou secondaire. Si elle est laissée vide, la commande utilise la carte de carbone primaire. emissionUOMId Saisissez l'unité de mesure préférée à utiliser pour les données d'émissions téléchargées. emissionURL Saisissez l'URL du point de terminaison de l'API Schneider Electric pour demander des données. - Cliquez sur Enregistrer.
Étape 2. Commencez par une requête HTTP
Pour demander les données à télécharger à Schneider Electric, commencez par une commande HTTP POST.
- Sous Connecteurs, sélectionnez HTTP, et déplacez POST vers Start.
- Sélectionnez la commande POST et cliquez sur Edit.
- Sous Basic info, entrez un nom et une description pour aider à identifier la commande.
- Sous Command properties, sélectionnez le connecteur HTTP Request à utiliser.
- Entrez dans les propriétés de la commande :
Propriété Description Nom de l'utilisateur Entrez le nom d'utilisateur utilisé pour l'authentification de base avec Schneider Electric. Mot de passe Saisissez le mot de passe utilisé pour l'authentification de base avec Schneider Electric. Afficher la réponse Cochez cette case. URL Sélectionnez la variable emissionsURL sous Chain. Type de contenu Sélectionnez application/json. Corps du texte Saisissez la demande sous la forme d'une chaîne JavaScript Object Notation (JSON), en sélectionnant la variable applicable sous Chain comme valeur de chaque paire nom/valeur : { "clientHierIds" : [<clientHierId>], "serviceIds" : [<serviceIds>], "fromMonth" : "<fromMonth>", "toMonth" : "<toMonth>", "carbonMapType" : "<carbonMapType>", "emissionsUOMId" : "<emissionUOMId>" }Schéma de sortie Saisissez l'exemple de réponse JSON de Schneider Electric : { "serviceOutput" : [ { "divisionClientHierId" : 0, "divisionName" : "string", "siteClientHierId" : 0, "siteName" : "string", "dataSourceLevel" : "string", "serviceId" : 0, "serviceName" : "string", "scope" : "string", "usage" : 0, "emission" : 0, "emissionUOM" : "string", "usageUOM" : "string", "serviceMonth" : "string" } ], "errorMessage" : "string", "errorCode" : "string" } - Cliquez sur Enregistrer.
Étape 3. Ajouter un tableau à la commande CSV
Pour convertir la réponse JSON de Schneider Electric en un format de valeurs séparées par des virgules (CSV), ajoutez une commande Array to CSV:
- Sous Connecteurs, sélectionnez JSON, et déplacez Array to CSV dans le canevas.
- Faites glisser un lien depuis Start vers la commande Array to CSV.
- Sélectionnez la commande Array to CSV et cliquez sur Edit.
- Sous Basic info, entrez un nom et une description pour aider à identifier la commande.
- Sous Command properties, sélectionnez le connecteur JSON à utiliser.
- Pour les données JSON , sélectionnez la sortie Response de la commande POST.
- Sous Columns, ajoutez des colonnes pour les données téléchargées de Schneider Electric :
Nom de la colonne JSONPath utilisation .utilisation émissions .émissions - Pour Délimiteur, sélectionnez Virgule.
- Cliquez sur Enregistrer.
Étape 4. Ajouter une commande Créer un fichier
Pour créer un fichier CSV à partir des données, ajoutez une commande Create file:
- Sous Connecteurs, sélectionnez Utilitaires de fichiers, et déplacez Créer un fichier dans le canevas.
- Faites glisser un lien de la commande Array to CSV vers la commande Create file.
- Sélectionnez la commande Créer un fichier et cliquez sur Editer.
- Sous Basic info, entrez un nom et une description pour aider à identifier la commande.
- Sous Command properties, sélectionnez le connecteur File Utilities à utiliser.
- Entrez dans les propriétés de la commande :
Propriété Description Texte Sélectionnez le fichier converti issu de la commande Array to CSV. Chemin d'accès au fichier Sélectionnez la variable Chain.Workspace sous Runtime, et entrez \et le nom du fichier avec une extension.csv. - Cliquez sur Enregistrer.
Étape 5. Ajouter des commandes pour utiliser les données dans Workiva
Pour utiliser les données CSV dans la plateforme Workiva, ajoutez les commandes du connecteur Workiva afin d'utiliser la variable Created file issue de la commande Create file avec une feuille de calcul ou un tableau Wdata. Par exemple, pour ajouter les données Schneider Electric en tant qu'ensemble de données dans une table Wdata, ajoutez un événement Run chain qui utilise une chaîne créée à partir de et Update datasets in a table template.
Étape 6. Publier et exécuter la chaîne
Pour permettre à la chaîne de fonctionner :
- Cliquez sur Publier.
- Saisissez un commentaire sur sa publication, puis cliquez sur Publier.
Pour faire fonctionner la chaîne :
- À partir de Chains, sélectionnez Edit dans le menu de la chaîne.
- Cliquez sur Chain Settings, entrez les valeurs variables pour spécifier les données à télécharger, et cliquez sur Save.
- Cliquez sur Exécuter et Exécuter la chaîne.