L'automatisation des rafraîchissements de connexion est essentielle pour rationaliser la centralisation des données et leur transfert vers la plateforme Workiva, en particulier lorsqu'il existe plusieurs connexions. Dans ce parcours d'apprentissage connecté, nous allons apprendre à créer une chaîne qui rafraîchit une liste de connexions entre Wdata et la plateforme Workiva à l'aide d'un ID de feuille de calcul. Cette chaîne génère une liste de connexions sur une seule feuille de calcul et nous fournit ensuite la liste des identifiants de ces connexions, afin que nous puissions automatiser le rafraîchissement de chaque connexion dans la feuille de calcul.
| Cas d'utilisation principal | Connectivité des données entre Workiva et Wdata |
| Objectif d'apprentissage principal | Apprenez à rafraîchir une liste de connexions à l'aide de chaînes. |
| Objectifs d'apprentissage secondaires | Apprendre l'essentiel des itérateurs de groupe |
| Conditions préalables |
Configurer le connecteur Workiva Complétez le site CLP | Rafraîchir les connexions à l'aide d'un paramètre Fournir des autorisations à la feuille de calcul pour l'utilisateur OAuth Grant associé. |
| Modèle de support | CLP | Actualiser la liste des connexions |
Étape 1 : Créer une chaîne
- Ajouter une nouvelle chaîne
- Nommez la chaîne : CLP | Actualiser la liste des connexions
- Sauver la chaîne
Étape 2 : Entrées en cours d'exécution
Nous utilisons la commande Runtime Inputs pour lancer la chaîne. Cela nous permet de spécifier la feuille de calcul pour laquelle nous voulons rafraîchir toutes les connexions.
- Ajouter un événement de chaîne Entrées d'exécution depuis les événements déclencheurs de chaîne du nœud de départ
- Modifier l'événement de la chaîne d'entrées en cours d'exécution en double-cliquant sur la commande
- Type : Champ de texte
- Nom d'affichage : ID de la feuille de calcul
- Requis : Coché
- Enregistrer la commande
Étape 3 : Lister les connexions
Nous utiliserons la commande List Connections pour récupérer la liste des identifiants de connexion associés à l'identifiant de la feuille de calcul. Le résultat de la commande Lister les connexions sera un fichier JSON comprenant chaque connexion dans la feuille de calcul avec les détails relatifs à la connexion, y compris l'identifiant de la connexion.
- Ajouter une commande List Connections à partir du connecteur Workiva dans le canevas Chain.
- Connecter la commande Runtime Inputs à la commande List Connections Command
- Double-cliquez sur la commande pour la configurer
- Type de destination : Feuille de calcul
- Destination ID : Utiliser la variable Spreadsheet ID à partir de Runtime Inputs - cela nous permet de pousser la valeur spécifiée au moment de l'exécution de la chaîne jusqu'à la commande Refresh Connections.
- Cliquez sur le champ ID de destination
- Dans le panneau de gauche, développez le menu déroulant Trigger
- Développez la liste déroulante Runtime Inputs
- Sélectionnez la variable Spreadsheet ID
- Enregistrer la commande
Étape 4 : Groupe de commandement
Nous utiliserons un groupe de commande pour permettre l'itération sur chaque connexion. L'itérateur de groupe fait passer chaque connexion de la feuille de calcul par les étapes suivantes, une par une.
- Ajoutez un Groupe de commandes au canevas de Chaîne
- Relier la commande List Connections à la section In du groupe de commandes
- Double-cliquez sur la commande pour la configurer
- Nommez le groupe : L'itération des connexions
- Naviguer vers l'onglet Itérateurs
- Activez la case à cocher Iterations et cliquez sur le champ Iterations
- Dans le panneau Select a Variable, cliquez sur la flèche vers le bas pour développer List Connections
- Sélectionnez la sortie Connections
- Activez la case à cocher Iterations et cliquez sur le champ Iterations
- Sauvegarder le groupe de commande
Étape 5 : Actualiser la connexion
Nous utiliserons la commande Rafraîchir la connexion pour rafraîchir nos connexions en utilisant l'identifiant de connexion de l'itération.
- Ajouter une commande Refresh Connection à partir de Workiva Connector dans le canevas Chain.
- Connecter la section Start de l'itérateur de groupe à la commande Refresh Connection.
- Double-cliquez sur la commande pour la configurer
- ID de connexion : utiliser l'ID de connexion de l'itérateur de groupe - Itération des connexions. Cela nous permet de transmettre l'ID de l'itération actuelle à la commande de rafraîchissement des connexions.
- Cliquez sur le champ ID de connexion
- Dans le panneau de gauche, développez le menu déroulant Group Iterator
- Développez le menu déroulant Connections Iteration
- Sélectionnez la variable ConnectionId
- Utiliser les paramètres de la source précédente : Coché
- Cela nous permet d'actualiser une connexion en utilisant les valeurs de paramètres précédentes de la source - dans notre cas, la requête avec le paramètre Pays sera toujours actualisée avec le Brésil comme valeur de filtre.
- ID de connexion : utiliser l'ID de connexion de l'itérateur de groupe - Itération des connexions. Cela nous permet de transmettre l'ID de l'itération actuelle à la commande de rafraîchissement des connexions.
Étape 6 : Tester l'exercice
Maintenant que la chaîne est terminée, testez le résultat
- Publier la chaîne
- Cliquez sur Exécuter et sélectionnez ensuite Exécuter avec des entrées
- Trouver l'ID de la feuille de calcul
- Accédez à la Feuille de calcul d'aperçu des employés CLP
- Dans l'URL, sélectionnez l'ID de la feuille de calcul, qui se trouve après "spreadsheet/" et avant "/sheet".
- Par exemple, l'ID de la feuille de calcul est en gras ici : app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/de9a4ab1374f4d438c9585a94dd9acf4/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
- Retournez à Chain Builder et collez l'ID de la feuille de calcul dans le champ ID de la feuille de calcul.
- Cliquez sur Démarrer.
- Une fois la chaîne terminée, revenez à la feuille de calcul et constatez que les deux connexions ont été actualisées avec succès !
Succès de l'exécution en chaîne avec deux itérations :
Actualisation de connexion réussie :
Pour en savoir plus sur l'utilisation des chaînes pour rationaliser la collecte de données, consultez le reste du site Data Centralization Paths!