Depuis Chain Builder, vous pouvez créer une chaîne pour télécharger les données d'Enablon®, telles que vos émissions de gaz à effet de serre (GES) pour le reporting environnemental, social et de gouvernance (ESG) ou de développement durable.
Conditions préalables
Pour construire cette chaîne, vous utiliserez ces connecteurs principaux :
- Requête HTTP connecteur
- Connecteur Utilitaires de fichiers
- Connecteur XML
- Workiva connector, si vous avez besoin d'utiliser les données dans une feuille de calcul ou un tableau Wdata
Note : Toutes les commandes de cette chaîne utilisent le CloudRunner par défaut. Aucun GroundRunner n'est nécessaire.
Pour faire fonctionner la chaîne, vous aurez besoin des coordonnées d'Enablon pour accéder aux données :
- Le point d'accès Enablon Simple Object Access Protocol (SOAP) Application Programming Interface (API) à utiliser pour télécharger les données.
- L'identifiant de l'environnement Enablon à accéder
- Le nom d'utilisateur et le mot de passe à utiliser pour accéder à l'environnement
É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 et son objectif.
- Sous Variables, ajoutez des variables pour les détails de l'Enablon nécessaires pour accéder aux données :
- Endpoint
Conseil : Pour la variable Endpoint, entrez une valeur par défaut de
ExportDataou, pour télécharger les données dans un format d'encodage 64 bits,ExportBinaryData. - Environnement
- Nom d’utilisateur
- Mot de passe
- Endpoint
- Cliquez sur Enregistrer.
Étape 2. Commencez par l'événement déclencheur Runtime Inputs
Pour filtrer la sortie à chaque fois que la chaîne s'exécute, commencez par un événement Runtime Inputs pour demander les critères des données à télécharger.
- Déplacer Runtime Inputs de sous Trigger Events vers Start.
- Sélectionnez l'événement Runtime Inputs et cliquez sur Edit.
- Ajouter les entrées à la demande chaque fois que la chaîne fonctionne :
Nom d’affichage Type Nécessaire ? Date de début de la période de rapport DateField Oui Date de fin de la période du rapport DateField Oui Campagne TextField ou DropdownField : - TextField, pour un champ de texte ouvert
- DropdownField, pour choisir parmi une liste spécifique d'options
Oui Entités ArrayField Oui - Cliquez sur Enregistrer.
Étape 3. Ajouter une commande POST de connecteur de requête HTTP
Pour récupérer les données du point d'accès Enablon, mettez en place une commande HTTP connector POST:
- Sous Connecteurs, cliquez sur HTTP, et déplacez la commande POST sur le canevas.
- Faites glisser un lien de Start vers la commande POST .
- Sélectionnez la commande POST et cliquez sur Edit.
- Sous Command properties, sélectionnez le connecteur HTTP à utiliser.
- Entrez dans les propriétés de la commande :
Propriété Description Nom de l'utilisateur Sélectionnez la variable Username sous Chain. Mot de passe Sélectionnez la variable Password sous Chain. Afficher la réponse Cochez cette case. URL Sélectionnez la variable Endpoint sous Chain. Type de contenu Entrez text/xml. - Dans le texte du corps , entrez la syntaxe XML (Extensible Markup Language) :
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:enab="enablon"> <soapenv:Header> <UserInfo xsi:type="wsdl:AuthHeader" xmlns:wsdl="http://enablon/wsdl/"> <EnaHomeSite xsi:type="xsd:string">[Environment]</EnaHomeSite> <EnaUserName xsi:type="xsd:string">[Username]</EnaUserName> <EnaPassword xsi:type="xsd:string">[Password]</EnaPassword> </UserInfo> </soapenv:Header> <soapenv:Body> <enab:ExportData soapenv:encoding:Style="http://schemas.xmlsoap.org/soap/encoding/"> <Table>/sd/Entities/Data</Table> <FolderId>0</FolderId> <Fields>FolderPath|ReportingPeriod|Ref|IndicatorName|ValueNumber|LocalUnit|ValueList</Fields> <Filter>ReportingPeriod in ([ReportPeriodEndDate],[ReportPeriodStartDate]) AND Campaign in([Campaign]) AND Entities=[Entities]</Filter> <CSVSeparator>2</CSVSeparator> <FormatOptions>25</FormatOptions> <FormatType>3</FormatType> <ExportOptions>8192</ExportOptions> </enab:ExportData> </soapenv:Body> </soapenv:Envelope>
- Mettre à jour la syntaxe XML avec les variables d'entrée et de chaîne de l'exécution :
- Dans l'en-tête, remplacez
[Environment],[Username], et[Password]par leurs variables respectives sous Chain. - Dans le corps du texte, remplacez
[ReportPeriodEndDate],[ReportPeriodStartDate],[Campaign], et[Entities]par leurs entrées d'exécution sous Trigger.
- Dans l'en-tête, remplacez
- Cliquez sur Enregistrer.
Étape 4. Ajouter les commandes Rechercher et Remplacer du connecteur d'utilitaires de fichiers
Pour préparer les données XML téléchargées, ajoutez File Utilities connector Find and replace commands to fix the angle brackets and pipes.
Conseil : Pour différencier facilement les commandes Rechercher et remplacer, entrez des noms pour identifier le caractère que chaque commande corrige, tels que "Rechercher et remplacer les crochets d'angle de départ" ou "Rechercher et remplacer les tuyaux".
- Sous Connecteurs, cliquez sur Utilitaires de fichiers, et déplacez la commande Rechercher et remplacer sur le canevas.
- Faites glisser un lien de la commande POST vers la commande Find and replace .
- Sélectionnez la commande Rechercher et remplacer et cliquez sur Modifier.
- Sous Command properties, sélectionnez le connecteur File Utilities à utiliser.
- Saisissez les propriétés de la commande et cliquez sur enregistrer:
Propriété Description Source Sélectionnez la sortie Response de la commande POST. Rechercher Entrez <.Remplacer Saisissez un angle de départ ( <).Trouver la syntaxe Sélectionnez Exact. - Sous Connecteurs, cliquez sur Utilitaires de fichiers, et déplacez une autre commande Rechercher et remplacer dans le canevas.
- Faites glisser un lien entre les commandes Rechercher et remplacer .
- Sélectionnez la nouvelle commande Rechercher et remplacer et cliquez sur Modifier.
- Sous Command properties, sélectionnez le même connecteur File Utilities.
- Saisissez les propriétés de la commande et cliquez sur enregistrer:
Propriété Description Source Sélectionnez le résultat Replaced result de la commande Find and replace. Rechercher Entrez >.Remplacer Saisissez un angle de départ ( >).Trouver la syntaxe Sélectionnez Exact. - Sous Connecteurs, cliquez sur Utilitaires de fichiers, et déplacez une autre commande Rechercher et remplacer dans le canevas.
- Faites glisser un lien entre les deuxième et troisième commandes Rechercher et remplacer .
- Sélectionnez la troisième commande Rechercher et remplacer et cliquez sur Modifier.
- Sous Command properties, sélectionnez le même connecteur File Utilities.
- Saisissez les propriétés de la commande et cliquez sur enregistrer:
Propriété Description Source Sélectionnez le résultat remplacé de la deuxième commande Rechercher et remplacer. Rechercher Entrez >.Remplacer Saisissez une pipe ( |).Trouver la syntaxe Sélectionnez Exact.
Étape 5. Ajouter une liste d'éléments de connecteur XML à la commande CSV
Pour convertir le fichier XML téléchargé en données tabulaires, ajoutez une commande XML connector Element list to CSV:
- Sous Connecteurs, cliquez sur XML, et déplacez une autre commande Element list to CSV dans le canevas.
- Faites glisser un lien de la troisième commande Find and replace vers la commande Element list to CSV.
- Sélectionnez la commande Element list to CSV et cliquez sur Edit.
- Sous Propriétés de la commande, sélectionnez le connecteur XML à utiliser.
- Entrez dans les propriétés de la commande :
Propriété Description Source Sélectionnez le résultat remplacé de la troisième commande Rechercher et remplacer. Chemin d'accès à la racine Entrer //Document/Record.Prévisualisation du résultat Cochez cette case. - Sous Columns, ajoutez le nom de la colonne et XPath pour chaque élément :
Nom de la colonne XPath Période /ReportingPeriod Indicateur /Ref Nom Ind /Nom de l'indicateur Valeur numérique /ValueNumber Unité /LocalUnit - Dans Délimiteur de valeurs multiples, entrez une virgule (
,). - Cliquez sur Enregistrer.
Étape 6. Ajouter un connecteur d'utilitaire de fichier Commande Créer un fichier
Pour créer un fichier de valeurs séparées par des virgules (CSV) à partir des données tabulaires, ajoutez une commande File Utilities connector Create file:
- Sous Connecteurs, cliquez sur Utilitaires de fichiers, et déplacez la commande Créer un fichier sur le canevas.
- Faites glisser un lien de la commande Element list to CSV vers la commande Create file .
- Sélectionnez la commande Créer un fichier et cliquez sur Editer.
- Sous Propriétés des commandes, sélectionnez le même connecteur Utilitaires de fichiers que les commandes Rechercher et remplacer.
- Saisissez les propriétés de la commande et cliquez sur enregistrer:
Propriété Description Texte Sélectionnez le fichier converti issu de la commande Element list to CSV. Chemin d'accès au fichier Sélectionnez la variable Chain.Workspace sous Runtime, et ajoutez \test.csv.
Étape 7. 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 Enablon 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 8. 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 des variables et cliquez sur Save.
Note : Pour la variable Endpoint, entrez
ExportDataou, pour télécharger les données dans un format d'encodage de 64 bits,ExportBinaryData. - Cliquez sur Exécuter.
- À partir de Monitor, cliquez sur Run with inputs, entrez les données d'entrée de l'exécution, puis cliquez sur Start.