Il est maintenant temps de tout regrouper dans un flux de travail centralisé, où nous traiterons les nouvelles données et actualiserons les connexions qui dépendent de ces données à l'aide d'une chaîne unique. Dans ce parcours de formation connecté, nous utiliserons les variables de notre feuille de contrôle pour exécuter des flux de travail qui préparent nos données tout en mettant à jour la feuille de contrôle avec un statut, offrant ainsi aux utilisateurs professionnels une meilleure visibilité sur le moment où les flux de travail se sont achevés récemment.
| 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 Fournir aux utilisateurs finaux des informations sur l'achèvement du flux de travail |
| Objectif d'apprentissage principal |
Apprendre à exécuter des processus similaires en utilisant les valeurs d'une feuille de contrôle Ajouter la journalisation à la feuille de contrôle à l'aide des commandes en chaîne |
| Conditions préalables |
Complétez CLP | Utilisation des valeurs d'un chemin de feuille de contrôle Configurez les connecteurs suivants : |
| Modèle de support | CLP | Exécution des processus et enregistrement des résultats dans une feuille de contrôle |
Étape 1 : Mise à jour de la fiche de contrôle pour y inclure l'enregistrement
Pour informer les utilisateurs finaux de l'état et de la dernière mise à jour des processus exécutés par la feuille de contrôle, nous avons besoin d'un endroit où stocker les détails relatifs à la date d'exécution du flux de travail et à l'état de ce flux de travail. Nous enregistrerons ces informations dans la feuille de contrôle.
- Depuis la plateforme Workiva, naviguez jusqu'à la feuille de calcul CLP
- Ajoutez deux nouvelles colonnes après la colonne FileLocation avec les en-têtes suivants :
- État
- Horodatage
- N'ajoutez aucune valeur sous les en-têtes de ces colonnes.
Étape 2 : Modifier une chaîne existante
- Naviguez vers Chain Builder et localisez la chaîne CLP | Utiliser les valeurs d'une feuille 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 | Exécuter des processus et enregistrer des résultats dans une feuille de contrôle
- Sous Variables de chaîne, cliquez deux fois sur le signe Plus pour créer deux variables de chaîne et les configurer comme ci-dessous :
- Type : Chaîne variable (cv)
- Nom : cv-Status Column Letter
- Valeur : la lettre de la colonne dans laquelle l'en-tête Status a été créé.
- Dans l'exemple fourni, la valeur est F
- Type : Chaîne variable (cv)
- Nom : cv - Lettre à colonnes horodatées
- Valeur : la lettre de la colonne dans laquelle l'en-tête Time Stamp a été créé.
- Dans l'exemple fourni, la valeur est G
- Type : Chaîne variable (cv)
- La chaîne doit maintenant comporter quatre variables de chaîne
- Sauver la chaîne
Étape 3 : Commande d'ajout de numéros de ligne
Nous utiliserons la commande Add Row Numbers pour ajouter automatiquement des numéros de ligne à la feuille de contrôle. Cela nous permettra de déterminer l'emplacement de l'enregistrement dans la fiche de contrôle.
- Double-cliquez sur le lien entre la commande Get Sheet Data et la commande Convert Control Sheet to JSON.
- Rompre le lien en cliquant sur le bouton Supprimer
- Rompre le lien en cliquant sur le bouton Supprimer
- Ajouter une commande Add Row Numbers à partir du connecteur Tabular Transformation dans le canevas Chain.
- Connectez la commande Get Sheet Data à la commande Add Row Numbers
- Connecter la commande Add Row Numbers à la commande Convert Control Sheet to JSON
- Double-cliquez sur la commande Add Row Numbers pour la configurer.
- 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 Data à partir de la commande Get Sheet Data.
- Cliquez sur le champ Input File
- Enregistrer la commande
- Maintenant que nous avons ajouté des numéros de ligne à l'ensemble de données, nous devons mettre à jour les commandes suivantes pour utiliser les données transformées. Dans ce cas, la commande CSV to JSON doit être mise à jour.
- Double-cliquez sur la commande Convert Control Sheet to JSON pour la mettre à jour.
- Cliquez sur le champ Input File et supprimez le champ Get Sheet Data Output.
- Dans le panneau Select a Variable, cliquez sur la flèche vers le bas pour développer Add Row Numbers
- Sélectionnez la sortie Add Row Numbers à partir de la commande Add Row Numbers.
- Cliquez sur le champ Input File et supprimez le champ Get Sheet Data Output.
- Enregistrer la commande
- Double-cliquez sur la commande Convert Control Sheet to JSON pour la mettre à jour.
Étape 4 : Exécuter le processus de téléchargement des données vers Wdata
Nous allons maintenant utiliser les variables de notre feuille de contrôle pour exécuter un processus qui télécharge les données dans un tableau Wdata. Pour ce faire, nous utiliserons un événement Run Chain qui lance la chaîne Upload Data to Wdata à partir de Uploading Data to a Table Path.
- Maintenant que nous avons pu visualiser l'utilisation de variables à partir d'une feuille de contrôle à l'aide de la barre de contrôle, nous n'avons plus besoin de la commande Barre de contrôle.
- Survolez la commande Guidon et cliquez sur la corbeille pour la supprimer.
- Confirmez la suppression de la commande en cliquant sur Supprimer
- Survolez la commande Guidon et cliquez sur la corbeille pour la supprimer.
- Ajouter un événement Run Chain au canevas Chain
- Connecter le drapeau actif Commande conditionnelle Chaîne d'exécution Événement
- Double-cliquez sur la commande pour la configurer
- Nommez la commande : Exécuter la chaîne - Télécharger les données vers Wdata
- Cliquez sur la liste déroulante Chain et sélectionnez la chaîne CLP | Upload Data to a Table
- Configurer les entrées de la durée d'exécution à l'aide des variables de la feuille de contrôle :
- Cliquez sur le champ Table ID
- 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 TableID exactement comme dans la feuille de contrôle et appuyez sur la touche "Entrée".
- Cliquez sur Accepter
- Cliquez sur le champ Table ID
-
-
- Cliquez sur le champ File Name
- Suivez les mêmes étapes que ci-dessus pour utiliser la variable de la feuille de contrôle, en utilisant le champ FileName au lieu de TableID.
- Cliquez sur le champ Emplacement du fichier
- Suivez les mêmes étapes que ci-dessus pour utiliser la variable de la feuille de contrôle, en utilisant le champ FileLocation au lieu de TableID.
- Cliquez sur le champ File Name
-
- Enregistrer la commande
Étape 5 : Exécuter le processus d'actualisation des connexions
Ensuite, nous utiliserons les variables de notre feuille de contrôle pour exécuter un processus qui actualise les données dans nos feuilles de calcul, mettant ainsi les nouvelles données téléchargées à la disposition des utilisateurs finaux. Pour ce faire, nous utiliserons un événement Run Chain qui lance la chaîne d'actualisation de la liste des connexions à partir de Refresh List of Connections Path.
- Ajouter un événement Run Chain au canevas Chain
- Connecter la chaîne d'exécution - Télécharger les données sur Wdata Chain Event à la chaîne d'exécution Event
- Double-cliquez sur la commande pour la configurer
- Nommez la commande : Exécuter la chaîne - Actualiser les connexions
- Cliquez sur la liste déroulante Chain et sélectionnez la chaîne CLP | Rafraîchir la liste des connexions
- Configurer les entrées de la durée d'exécution à l'aide des variables de la feuille de contrôle :
- Cliquez sur le champ Spreadsheet ID
- 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 SpreadsheetID exactement comme dans la feuille de contrôle et appuyez sur la touche "Entrée".
- Cliquez sur Accepter
- Cliquez sur le champ Spreadsheet ID
- Enregistrer la commande
Étape 6 : Renseigner la commande relative à l'état et à l'horodatage
Nous allons maintenant ajouter les commandes qui seront utilisées pour générer et remplir les valeurs qui seront renvoyées à la feuille de contrôle pour indiquer que les flux de travail ont réussi. La première étape consiste à créer le fichier contenant le statut et l'heure.
- Ajouter une commande Create File de File Utilities Connector au canevas Chain.
- Relier l'événement de la chaîne Run Chain - Refresh Connections à la commande Create File
- Double-cliquez sur la commande pour la configurer
- Nommez la commande : Remplir l'état et l'horodatage
- Dans le champ Text, saisissez les informations suivantes :
Chargement et rafraîchissement des données terminés, (*<System.DateTime>*)
-
-
- Remplacer l'espace réservé (*System.DateTime*) par la variable d'exécution appropriée, ce qui permettra d'extraire la date et l'heure des chaînes de manière programmatique.
- Dans le panneau Sélectionner une Variable sur la gauche, développez Temps d'exécution
- Sélectionnez la valeur System.DateTime
- Remplacer l'espace réservé (*System.DateTime*) par la variable d'exécution appropriée, ce qui permettra d'extraire la date et l'heure des chaînes de manière programmatique.
-
- Enregistrer la commande
Étape 7 : Renvoi à la feuille de contrôle
Nous allons maintenant utiliser la commande Écrire les données de la feuille pour écrire dans la feuille de contrôle les informations recueillies lors de la commande précédente. Cela permettra à nos utilisateurs finaux d'avoir une visibilité sur le processus, en montrant l'état du chargement et de l'actualisation des données, ainsi que la date à laquelle elles ont été mises à jour.
- Ajouter une commande Write Sheet Data du connecteur Workiva au canevas de la chaîne.
- Lier la commande Populate Status & Time Stamp à la commande Write Sheet Data
- Double-cliquez sur la commande pour la configurer
- Cliquez sur le champ ID de la feuille de calcul
- Dans le panneau Sélectionner une variable, cliquez sur la flèche vers le bas pour développer Chain
- Sélectionnez l'ID de la feuille de calcul cv-Control Variable de chaîne
- Cliquez sur le champ ID/Nom de la feuille
- Dans le panneau Sélectionner une variable, cliquez sur la flèche vers le bas pour développer Chain
- Sélectionnez le nom de la feuille de contrôle cv Variable de chaîne
- Cliquez sur le champ Fichier de données
- Dans le panneau Select a Variable, cliquez sur la flèche vers le bas pour développer Populate Status & Time Stamp
- Sélectionnez la sortie Fichier créé
- Le champ Région sera rempli avec une combinaison de variables de la chaîne et de données JSON pour indiquer à la chaîne la cellule spécifique de la feuille de contrôle dans laquelle écrire pour l'itération en cours :
- Cliquez sur le champ Region et remplissez-le avec les données ci-dessous :
- cv-Status Column Letter - variable trouvée dans le panneau Variables sous Chain Variables
- Fichier JSON Iteration - nous utilisons le numéro de ligne de l'itération, plus 1, pour spécifier la région dans laquelle écrire les données, nous ajoutons un pour tenir compte de la ligne d'en-tête.
- 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 Row Number et appuyez sur la touche "Entrée".
- Sélectionnez une autre transformation et choisissez Analyser le nombre
- Cliquez sur le signe vert +
- Sélectionnez une autre transformation et choisissez Ajouter
- Cliquez sur le signe vert +
- Dans le champ de la valeur, entrez 1
- Cliquez sur Accepter
- Saisir deux points après la première itération du fichier JSON:
- cv-Time Stamp Column Letter - variable trouvée dans le panneau Variables sous Chain Variables
- Fichier JSON Iteration - nous utilisons le numéro de ligne de l'itération, plus 1, pour spécifier la région dans laquelle écrire les données, nous ajoutons un pour tenir compte de la ligne d'en-tête.
- Suivez les mêmes étapes que ci-dessus pour la deuxième itération du fichier JSON.
- Cliquez sur le champ Region et remplissez-le avec les données ci-dessous :
- Cliquez sur le champ ID de la feuille de calcul
- Enregistrer la commande
Étape 8 : 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
- Une fois la chaîne terminée, vérifiez que le flux de travail s'est bien déroulé en cochant la case ci-dessous :
La chaîne a fonctionné avec succès :
Les données ont été téléchargées avec succès dans la table détaillée des employés CLP :
Les connexions ont été actualisées avec succès dans la feuille de calcul de l'aperçu des employés CLP :
L'enregistrement a été ajouté avec succès à la feuille de contrôle primaire :
Félicitations ! Vous avez automatisé avec succès un flux de travail qui télécharge les données de la source, les charge dans une table et actualise les connexions qui utilisent ces données. Ce flux de travail utilise les valeurs d'une feuille de contrôle pour déterminer la source de données, la destination du téléchargement dans Workiva et les connexions à actualiser. Appliquez ces principes à vos propres processus afin de minimiser les efforts manuels et de fournir aux utilisateurs finaux des informations complètes.
Lancez-vous un nouveau défi en ajoutant l'enregistrement des échecs à votre feuille de contrôle en suivant le chemin suivant : Enregistrer les échecs dans une feuille de contrôle!