Portail de support Workiva

Étape 1 : Copier la requête existante

Tout d'abord, nous avons besoin d'une requête avec un paramètre. Nous allons créer une copie de notre requête existante et ajouter un paramètre qui nous permet de décider pour quel pays nous voulons voir le nombre total d'employés.

• Dans Wdata Home, localisez la requête CLP Employee Detail Query et ouvrez le menu
  • Sélectionner la copie

• Mettre à jour le nom de la requête en Requête sur le détail des employés CLP par pays

• Cliquez sur Enregistrer la requête
• Dans l'écran d'édition de la requête, cliquez sur l'icône Parameters à l'extrême droite du panneau.

• 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 : Créer une connexion entrante

Pour apprendre à rafraîchir une connexion à l'aide d'une chaîne, nous devons d'abord établir une connexion entre une requête Wdata et une feuille de calcul. 

• Accédez à la Feuille de calcul d'aperçu des employés CLP
• Ajoutez une nouvelle feuille en cliquant sur
  • Renommer le site Détails des employés du CLP par pays
• Ajouter une connexion entrante à la feuille CLP Détails de l'employé par pays :
  • Ouvrez le panneau Connections sur la droite en cliquant sur l'icône Connections.
  • Dans l'onglet Connexions entrantes, sélectionnez Ajouter une connexion
    • Sélectionner Wdata Query
    • Sélectionnez la Requête détaillée des employés CLP par pays
    • Réglez le paramètre Pays sur Australie
    • Cliquez sur Connecter

• Il y a maintenant deux feuilles avec des connexions entrantes dans la feuille de calcul de l'aperçu des employés CLP.

Étape 3 : Modifier une chaîne existante

• Naviguez vers Chain Builder et localisez la chaîne CLP | Refresh Connection using ID
• 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 | Actualiser les connexions avec un paramètre
• Sauver la chaîne

Étape 4 : 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 connexion que nous voulons rafraîchir au moment de l'exécution de la chaîne ainsi que le paramètre dont nous voulons mettre à jour la valeur.

• Modifier l'événement de la chaîne d'entrées en cours d'exécution en double-cliquant sur la commande
• Cliquez deux fois sur le bouton Add Input et ajoutez les entrées suivantes :
  • Entrée 1 :
    • Type : Champ de texte
    • Nom de l'affichage : Nom du paramètre
    • Obligatoire : Non coché
  • Entrée 2 :
    • Type : Champ de texte
    • Nom de l'affichage : Valeur du paramètre
    • Obligatoire : Non coché
• Enregistrer la commande

Étape 5 : Actualiser la connexion

Pour prendre en compte le paramètre ajouté, nous devons mettre à jour la commande Refresh Connections pour prendre en compte le paramètre et la valeur qui doivent être transmis à la requête.

• Modifiez Actualiser la connexion en double-cliquant sur la Commande
  • ID de connexion : Continuez à utiliser la variable Connection ID de Runtime Inputs.
  • Ajouter un paramètre
    • Puisque nos paramètres sont enregistrés à la source (dans la requête), nous voudrons remplir les paramètres à la source. Cliquez sur le bouton + à côté de Paramètres source
    • Nom du paramètre : Utilisez la variable Parameter Name de Runtime Inputs - cela nous permet de pousser la valeur du Parameter Name spécifiée au moment de l'exécution de la chaîne vers la commande Refresh Connections.
      • Cliquez sur le champ Parameter Name
      • Dans le panneau de gauche, développez le menu déroulant Trigger
      • Développez la liste déroulante Runtime Inputs
      • Sélectionnez la variable Parameter Name
    • Valeur du paramètre : Utilisez la variable Parameter Value de Runtime Inputs - cela nous permet de pousser la valeur du paramètre spécifiée au moment de l'exécution de la chaîne vers la commande Refresh Connections.
      • Cliquez sur le champ Parameter Name
      • Dans le panneau de gauche, développez le menu déroulant Trigger
      • Développez la liste déroulante Runtime Inputs
      • Sélectionner la variable Valeur du paramètre
• Enregistrer la commande

É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'identifiant de connexion
  • Accédez à la Feuille de calcul d'aperçu des employés CLP
  • Dans le panneau Connexions, recherchez la connexion CLP Employee Detail by Country Query et cliquez sur la flèche vers le haut. Une fois que la liste déroulante apparaît, sélectionnez Afficher les Afficher les propriétés

• Copiez l'identifiant de connexion - assurez-vous de n'oublier aucun caractère et de ne pas ajouter d'espace.

• Retournez à Chain Builder et collez l'ID de connexion dans l'entrée d'exécution de l'ID de connexion.
• Renseigner les paramètres d'entrée
  • Nom du paramètre: le nom du paramètre dans la requête - dans cet exercice, le nom du paramètre est Pays
  • Valeur du paramètre: la valeur sur laquelle la requête doit être filtrée - dans cet exercice, nous filtrerons sur Brésil.
    • Remarque : la sélection d'une valeur de paramètre différente de celle qui est déjà stockée dans la feuille de calcul écrasera la feuille de calcul, nous verrons nos données passer de l'Australie au Brésil.
• Cliquez sur Démarrer.
• Une fois la chaîne terminée, revenez à la feuille de calcul et constatez que la connexion a été actualisée avec succès !

Succès de l'exécution de la chaîne :

Actualisation de connexion réussie :

Pour en savoir plus sur l'actualisation des connexions à l'aide de chaînes, suivez le chemin suivant : Actualiser la liste des connexions!