CLP - Utiliser les valeurs d'une feuille de contrôle – Centre d’assistance

L'exploitation des valeurs d'une feuille de contrôle pour les flux de travail en chaîne nécessite la lecture et l'application systématiques de ces valeurs dans les commandes. Dans ce parcours de formation connectée, nous verrons comment lire et utiliser les valeurs d'une feuille de contrôle et comment utiliser un groupe de commandes pour parcourir plusieurs lignes de manière efficace.

Cas d'utilisation principal	Orchestrer les flux de travail de reporting à partir d'un emplacement centralisé Simplifier la gestion des flux de travail pour les utilisateurs finaux
Objectif d'apprentissage principal	Apprendre à utiliser les valeurs d'une feuille de contrôle dans une chaîne
Objectifs d'apprentissage secondaires	Apprenez à utiliser les commandes conditionnelles, les itérateurs JSON et le connecteur Handlebars.
Conditions préalables	Compléter le site CLP \| Création et lecture d'une feuille de contrôle Configurez les connecteurs suivants : - JSON - Guidon
Modèle de support	CLP \| Utilisation des valeurs d'une feuille de contrôle

Étape 1 : Modifier la chaîne existante

Naviguez vers Chain Builder et localisez la chaîne CLP | Reading from a Control Sheet (Lecture d'une fiche de contrôle)
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 | Utiliser les valeurs d'une feuille de contrôle
Sauver la chaîne

Étape 2 : Convertir la feuille de contrôle en JSON

Pour utiliser efficacement les valeurs d'une feuille de contrôle, nous allons convertir la sortie de la commande Get Sheet Data du format CSV au format JSON. Cette conversion établit des paires clé-valeur entre les en-têtes de la feuille de contrôle et les valeurs correspondantes dans les lignes situées sous chaque en-tête, ce qui permet une itération efficace.

Ajouter une commande CSV to JSON du connecteur JSON au canevas de la chaîne.
Connectez la commande Get Sheet Data à la commande CSV to JSON
Double-cliquez sur la commande pour la configurer
- Nommez la commande : Convertir la feuille de contrôle en JSON
- Cliquez sur le champ Input File
  - Dans le panneau Select a Variable, cliquez sur la flèche vers le bas pour développer Get Sheet Data
  - Sélectionnez la sortie Données
- Laisser le champ du délimiteur comme Virgule (,)
- Enregistrer la commande

Étape 3 : Ajouter un groupe de commande

Ajoutez un groupe de commande à la chaîne pour permettre l'itération sur chaque ligne de la feuille de contrôle. Cela nous permet de faire passer chaque ligne de la feuille de contrôle par la série de commandes du groupe.

Ajoutez un Groupe de commandes au canevas de Chaîne
Connectez la commande Convert Control Sheet to JSON à la section In du groupe de commandes.
Double-cliquez sur le groupe de commande pour le configurer
- Nommez le groupe : Itérateur de la feuille de contrôle
- 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 Convert Control Sheet to JSON
    - Sélectionnez la sortie JSON
- Enregistrer la commande

Maintenant que la commande a été configurée, elle va parcourir chaque ligne de la feuille de contrôle et fournir une sortie pour chaque ligne.

Étape 4 : Ajouter une commande conditionnelle

Dans une feuille de contrôle, les utilisateurs peuvent déterminer s'ils souhaitent qu'une certaine ligne soit exécutée dans le cadre d'un flux de travail. La colonne ActiveFlag permet de tirer parti de cette situation. Nous utiliserons une commande conditionnelle pour déterminer si le flux de travail doit se poursuivre pour chaque ligne de la feuille de contrôle.

Ajoutez un événement de chaîne Commande conditionnelle au canevas de Chaîne
Relier le groupe Start dans le groupe Control Sheet Iterator à la commande Conditional.
Double-cliquez sur la commande pour la configurer
- Nommez le commandement : Drapeau actif ?
- Laissez la condition ET et cliquez sur le bouton RULE
- Vérifiez que le type de données est défini sur String et modifiez l'opération à tester de Is Blank à =
- Cliquer dans le champ ouvert à gauche de la commande (la valeur à tester)
  - Dans le panneau Select a Variable, cliquez sur la flèche vers le bas pour développer Group Iterator
  - Sélectionnez <> JSON File Iteration
  - Cliquez sur la pilule verte JSON File Iteration pour transformer la Variable
    - Cliquez sur Sélectionner une transformation et choisissez Get Value from JSON
    - Appuyez sur le signe vert +
    - Dans le champ de valeur, tapez l'en-tête ActiveFlag tel qu'il se présente dans la feuille de contrôle et appuyez sur la touche "Entrée".
    - Sélectionnez une autre transformation et choisissez Minuscules
    - Appuyez sur le signe vert +
    - Cliquez sur Accepter

- De retour dans la commande conditionnelle, dans la partie droite (la valeur à comparer), tapez le mot true
  
  Veillez à ce que cette valeur soit en minuscules, car la transformation de la variable appliquée précédemment fait que la valeur du drapeau actif est entièrement en minuscules.
Enregistrer la commande

Étape 5 : Transmettre les résultats à une commande

À ce stade, l'itérateur de la feuille de contrôle est configuré pour fournir des valeurs à toute commande existant dans le groupe de départ du groupe de commandes. Nous utiliserons une commande Handlebars pour afficher les valeurs récupérées, qui peuvent également être utilisées de manière itérative dans des commandes en aval.

Ajouter une commande Render Text Template de Handlebars Connector au canevas Chain.
Connecter le Drapeau actif ? Commande vers le modèle de rendu de texte Commande
Double-cliquez sur la commande pour la configurer
- Nommez la commande : Capturer les valeurs de la feuille de contrôle
- Dans le champ Template, saisissez les informations suivantes :
  - Rangée du haut : Informations sur la fiche de contrôle
  - Deuxième rangée : Nom du fichier : <JSON>
    - Remplacez le <JSON> à partir du panneau Select a Variable, cliquez sur la flèche vers le bas pour développer Itérateur de groupe
    - Sélectionnez <> JSON File Iteration

- - - Cliquez sur la pilule verte JSON File Iteration pour transformer la Variable
      - Cliquez sur Sélectionner une transformation et choisissez Get Value from JSON
      - Appuyez sur le signe vert +
      - Dans le champ de valeur, tapez FileName exactement comme dans la feuille de contrôle et appuyez sur la touche "Entrée".
      - Cliquez sur Accepter

- Répétez les étapes pour les troisième, quatrième et cinquième rangs.
  - Remplacez l'espace réservé <JSON> par la variable de la feuille de contrôle.
    - Tableau ID : <JSON>
      - Suivez les mêmes étapes que précédemment, mais utilisez TableID au lieu de FileName.
    - ID de la feuille de calcul : <JSON>
      - Suivez les mêmes étapes que précédemment, mais utilisez SpreadsheetID au lieu de FileName.
    - Emplacement du fichier : <JSON>
      - Suivez les mêmes étapes que précédemment, mais utilisez FileLocation au lieu de FileName.
Enregistrer la commande

Note : Suivez les étapes décrites pour extraire un en-tête et récupérer les valeurs de ligne correspondantes d'une feuille de contrôle.

É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 la chaîne
Lorsque la chaîne est terminée, cliquez sur la commande Capture Control Sheet Values pour vérifier le succès
- Laissez la chaîne se terminer complètement avant de cliquer sur la commande
Il y aura un champ qui indiquera Valeur 1
- Si vous cliquez sur ce champ, vous verrez que la commande a traité trois valeurs différentes, qui correspondent aux trois lignes de données de la feuille de contrôle.
Cliquez sur le champ Log pour chaque valeur individuelle et vérifiez qu'elle correspond aux valeurs de la feuille de contrôle.