Nous savons que la collecte de données dans un format optimal est essentielle pour rationaliser les cycles de reporting de bout en bout. La manière la plus efficace de rassembler et d'agréger des données dans Wdata est d'utiliser des requêtes. Dans ce parcours de formation connectée, nous apprendrons à exécuter une requête Wdata à l'aide de chaînes, automatisant ainsi la collecte de données.
| Cas d'utilisation principal | Rapports sur les données stockées dans Wdata |
| Objectif d'apprentissage principal | Exécuter une requête à partir d'une chaîne |
| Objectifs d'apprentissage secondaires | Exportation des résultats de la requête vers une feuille de calcul |
| Conditions préalables |
Configurer le connecteur Workiva Compléter le site CLP | Créer une requête avec un champ calculé Identifier l'ID de la requête sur les détails de l'employé CLP Facultatif - Identifier l'URL d'une feuille de calcul existante pour y inscrire les résultats de la requête. |
| Modèle de support | CLP | Exécuter une requête et exporter les résultats |
Étape 1 : Créer une chaîne
- Ajouter une nouvelle chaîne
- Nommez la chaîne : CLP | Exécuter une requête et exporter les résultats
- Sauver la chaîne
Étape 2 : Entrées en cours d'exécution
Nous utilisons l'événement de chaîne Runtime Inputs pour lancer la chaîne. Cela nous permet de demander à l'utilisateur l'ID de la requête et l'URL de la feuille de calcul dans laquelle écrire les résultats. Le champ URL de la feuille de calcul est facultatif ; s'il est laissé vide, une nouvelle feuille de calcul sera créée.
- Ajoutez une chaîne événement Entrées d'exécution à partir des événements déclencheurs de chaîne dans la zone de démarrage
- Cela nous permet de demander à l'utilisateur l'ID de la requête et l'URL de la feuille de calcul dans laquelle les résultats seront écrits.
- En savoir plus sur les données d'entrée (Runtime Inputs)
- Modifier l'événement de la chaîne d'entrées en cours d'exécution en double-cliquant sur la commande
- Ajoutez les entrées ci-dessous :
- Entrée 1 :
- Type : Champ de texte
- Nom d'affichage : ID de la requête
- Requis : Coché
- Entrée 2 :
- Type : Champ de texte
- Nom d'affichage : URL de la feuille de calcul
- Obligatoire : Non coché
- Entrée 1 :
- Ajoutez les entrées ci-dessous :
- Enregistrer la commande
Étape 3 : Exécuter la requête
Pour récupérer les données les plus récentes, il faut d'abord exécuter la requête. Une fois que la requête a été exécutée avec succès, nous pouvons exporter les résultats de la requête pour les utiliser dans des rapports ultérieurs ou les envoyer à d'autres systèmes externes. Nous utiliserons la commande Run Query pour exécuter la requête Wdata.
- Ajouter une commande Run Query du connecteur Workiva au canevas Chain.
- Connecter le Runtime Inputs Chain Event à la Run Query Command
- Double-cliquez sur la commande pour la configurer
- Cliquez sur le champ Query ID
- Dans le panneau Variables de gauche, cliquez sur la flèche vers le bas pour développer Déclencheur
- Cliquez sur la flèche vers le bas pour développer Entrées de temps d'exécution
- Cliquez sur Query ID
- Cliquez sur le champ Query ID
- Enregistrer la commande
Étape 4 : Exporter les résultats de la requête
La deuxième étape nécessaire à l'utilisation des résultats de notre requête consiste à exporter les données vers une feuille de calcul. La commande Exporter les résultats de la requête est utilisée pour écrire les résultats de l'exécution de la requête dans une feuille spécifiée au sein d'une feuille de calcul.
- Ajouter une commande Export Query Results du connecteur Workiva au canevas Chain.
- Connecter la commande Run Query à la commande Export Query Results
- Double-cliquez sur la commande pour la configurer
- Cliquez sur le champ Query Result ID
- Dans le panneau Variables de gauche, cliquez sur la flèche vers le bas pour développer l'option Exécuter une requête.
- Cliquez sur la flèche vers le bas pour développer les résultats de la requête
- Cliquez sur Id
- Cliquez sur le champ Query Result ID
Astuce ! Si vous avez besoin d'utiliser les résultats de votre requête dans une commande ultérieure, utilisez la commande Télécharger les résultats de la requête à partir du connecteur Workiva, en utilisant le même identifiant de requête que ci-dessus comme entrée pour le champ Identifiant du résultat de la requête.
-
- Cliquez ensuite sur le champ Spreadsheet URL
- Dans le panneau Variables de gauche, cliquez sur la flèche vers le bas pour développer Déclencheur
- Cliquez sur la flèche vers le bas pour développer Entrées de temps d'exécution
- Cliquez sur Spreadsheet URL
- Cliquez ensuite sur le champ Spreadsheet URL
- Enregistrer la commande
Étape 5 : 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
- Ajoutez des valeurs pour vos entrées d'exécution
- ID de la requête - ID de la requête sur les détails de l'employé CLP
- URL de la feuille de calcul - URL complète de la feuille de calcul vers laquelle vous souhaitez exporter les résultats de la requête.
- Dans cet exemple, une feuille de calcul a été créée dans la plateforme Workiva et nommée CLP Employee Totals.
- Une fois la chaîne terminée, consultez la feuille de calcul pour vérifier les résultats.
- La chaîne doit avoir exécuté avec succès la requête et exporté les résultats vers la feuille de calcul.
- Vous pouvez vérifier que les données ont été exportées dans votre feuille de calcul en accédant à l'URL de la feuille.
Pour en savoir plus sur l'exécution de requêtes à l'aide de chaînes, suivez le chemin suivant : Exécuter une requête avec un paramètre!