Les paramètres dans les requêtes Wdata sont ce qui rend les requêtes dynamiques et utilisables à travers les périodes de rapport. Dans ce parcours d'apprentissage connecté, nous allons modifier notre requête en ajoutant un paramètre, en la rendant dynamique, puis en modifiant notre chaîne pour prendre en compte le paramètre. Nous exporterons ensuite les résultats de la requête vers une feuille de calcul Workiva.
| Cas d'utilisation principal | Rapports sur les données stockées dans Wdata |
| Objectif d'apprentissage principal | Exécution d'une requête avec un paramètre provenant d'une chaîne |
| Objectifs d'apprentissage secondaires | Création d'un paramètre dans une requête |
| Conditions préalables |
Configurer le connecteur Workiva Compléter le site CLP | Créer une requête avec un champ calculé Compléter le site CLP | Exécuter une requête et exporter les résultats Identifier l'ID de la requête sur les détails de l'employé CLPFacultatif - Identifier l'URL d'une feuille de calcul existante pour y inscrire les résultats. |
| Modèle de support | CLP | Exécuter une requête avec un paramètre |
Étape 1 : Modifier une requête existante
Tout d'abord, nous devons modifier notre requête CLP sur les détails de l'employé afin d'ajouter un paramètre. Nous allons créer un paramètre qui nous permettra de choisir le pays pour lequel nous voulons voir le nombre total d'employés.
- À partir de Wdata, ouvrez la requête CLP Employee Detail Query pour la modifier.
- Suivez la procédure suivante : CLP | Create a Query with a Calculated Field pour créer la requête.
- Dans le panneau de droite, cliquez sur l'icône Paramètres.
- Cliquez sur Add Parameters et sélectionnez Create New Parameter (Créer un nouveau paramètre).
- Nommez le paramètre : Pays
- Définissez la liste de sélection sur activée
- Dans la case Options de liste, énoncez les pays suivants, chaque pays sur sa propre ligne :
- Australie
- Brésil
- Italie
- Kenya
- États-Unis
- Mettre à jour la valeur par défaut de None
- Cliquez sur Créer
- Pour que le paramètre contrôle les résultats de notre requête, nous devons le relier à la colonne des données sources à l'aide de filtres. Accédez à l'onglet Filtres dans la requête.
- Localisez la colonne Country dans les Source Data sur la gauche, puis cliquez et faites-la glisser vers la zone des filtres sur la gauche.
- Cliquez sur la valeur du filtre, à l'endroit où il est indiqué Empty String, afin de remplir la valeur du filtre.
- A droite du champ de la valeur du filtre, cliquez sur le bouton des paramètres
- Sélectionnez Pays
- Cliquez sur Appliquer
-
- Vous avez maintenant une requête avec un paramètre pour le pays. Lorsque vous cliquez sur Exécuter la requête, il vous sera demandé quel pays vous souhaitez voir s'afficher dans les résultats de votre requête.
- Cliquez sur Enregistrer
Étape 2 : Modifier une chaîne existante
- Naviguez vers Chain Builder et localisez la chaîne CLP | Exécuter une requête et exporter les résultats
- Cliquez sur le bouton "crayon" pour modifier la chaîne
- Cliquez sur Paramètres de chaîne en haut à droite.
- Renommer la chaîne : CLP | Exécuter une requête et avec un paramètre
- Sauver la chaîne
Étape 3 : 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'ID de la requête à exécuter, la valeur de son paramètre et l'URL d'une feuille de calcul existante 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.
- Modifier l'événement de la chaîne d'entrées en cours d'exécution en double-cliquant sur la commande
- Cliquez sur le bouton Add Input et ajoutez l'entrée suivante :
- Type : Champ de texte
- Nom d'affichage : Valeur du paramètre d'interrogation
- Requis : Coché
- Si vous le souhaitez, vous pouvez faire glisser cette nouvelle entrée de manière à ce qu'elle apparaisse après l'entrée Query ID et avant l'entrée Spreadsheet URL.
- Enregistrer la commande
Étape 4 : 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.
- Double-cliquez sur la commande Run Query pour la configurer.
- Cliquez sur le bouton ADD dans la section Paramètres
- Dans le champ Nom, saisissez le nom du paramètre de requête, dans ce cas notre paramètre est nommé Pays
- Dans le champ Type, sélectionnez le type de paramètre de la requête, dans ce cas notre type de paramètre est Text.
- Cliquez sur le champ Value
- 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 Valeur du paramètre de requête
- 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 détaillée sur l'employé CLP dans Wdata
- Valeur du paramètre de la requête - la valeur sur laquelle vous souhaitez que votre requête soit filtrée.
- Dans cet exemple, nous filtrons les données sur Brésil.
- 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.
- 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 et filtrées correctement en accédant à l'URL de la feuille.
Pour en savoir plus sur l'utilisation des chaînes pour rationaliser la centralisation des données, consultez le reste du site Data Collection Paths!